直接给余额充值
适合想按自己节奏使用的人。选择充值额度，再选择页面提供的支付方式完成支付。
- 入口：钱包管理 → 额度充值
- 余额可用于按量模型调用
- 不要按旧比例估算，查看实时实付金额
NEWAPI × CC SWITCH · START HERE
把你的 AI 智能体
接上正确的引擎。
不需要会编程。跟着这份指南依次完成充值、选模型、创建密钥，再填入 CC Switch，即可使用 Claude Code、Codex、OpenCode 等智能体。
STEP 01 / WALLET
先准备可用额度
进入“钱包管理”后，选择最适合你的方式。金额、套餐与支付方式会变化，请以页面当时显示为准。
输入兑换码到账
如果你从正规渠道购买了兑换码，在“额度充值”页的兑换码区域粘贴后兑换。
- 兑换前核对字符，不要泄露给陌生人
- 兑换成功后检查当前余额
- 卡密一旦兑换通常不能撤销
按天或按月购买套餐
套餐有自己的有效期、总额度和可能的每日重置规则，适合使用量较稳定的人。
- 入口：钱包管理 → 订阅套餐
- 购买前看清有效期、额度与限购说明
- 到期后未使用额度不一定可继续使用
重要：套餐和余额的扣费顺序。有生效套餐时，系统会先消耗套餐额度；套餐用完后，只有该套餐允许“余额兜底”时才会继续扣账户余额。若套餐不允许兜底，余额即使还有钱也可能无法继续调用。每个套餐的具体规则以购买页为准。
有生效套餐先检查套餐状态
→
先扣套餐额度有效期与套餐额度内
→
余额兜底或停止取决于套餐是否允许
STEP 02 / MODEL MARKET
再决定要用什么模型
模型广场是唯一的实时价格和可用性来源。价格不是固定价，选模型前务必再看一眼。
按任务，不按名字盲选
写代码 / 复杂推理优先查看 Claude 或 OpenAI 类模型，并核对对应端点。
日常问答 / 省预算找较低输入、输出价格的模型，并从小额测试开始。
图片 / 语音 / 音乐筛选按次计费模型，先确认一次调用的单价。
国内模型按供应商筛选，查看能否使用 OpenAI 或 Gemini 端点。
- 按供应商缩小范围，例如 Anthropic 或 OpenAI。
- 点可用令牌分组，记住含有目标模型的分组名称。
- 确认端点类型：Claude Code 看 anthropic；Codex/OpenCode 看 openai。
- 检查按量或按次计费，以及输入、输出、缓存价格。
- 再回到令牌管理，把密钥分组设成匹配的分组。
STEP 03 / TOKEN
创建一把专用密钥
把密钥理解成家门钥匙：只给你自己的 CCS 使用，不能发到群聊、截图或提交到代码仓库。
控制台 → 令牌管理 → 添加令牌
点击“添加令牌”后，按下面的建议填写；提交完成后立即复制密钥并保存在安全位置。
打开令牌管理 ↗名称 *例如：CCS-Codex-个人
令牌分组选择模型广场中含目标模型的分组；不确定时保持账户默认分组。
过期时间 *个人长期使用可选“永不过期”；共享或临时用途选一个月/一天。
无限额度个人新手建议开启。它只是不限制这把令牌，实际仍受账户余额/套餐限制。
模型限制列表非必要先留空；只有想限制某把密钥用途时再设置。
IP 白名单家用动态网络建议留空；固定服务器 IP 才考虑填写。
密钥安全底线。示例中的 sk-你的密钥 只是占位文字。真实密钥只在 NewAPI 与 CCS 的输入框中粘贴；一旦怀疑泄露，请在令牌管理中禁用或删除并新建。
STEP 04 / CC SWITCH
下载 CC Switch（CCS）
CCS 是一个桌面配置管理器，能用图形界面管理多种智能体，不需要手动找配置文件。
CC Switch：一处管理 Claude Code、Codex、OpenCode 等工具
请只从 GitHub 官方仓库或 Releases 页面下载。安装后再回到本指南填写供应商信息。
Windows优先下载 .msi；便携使用选 Portable .zip。
macOS下载 .dmg，或使用 Homebrew 安装。
Linux按发行版选择 .deb、.rpm 或 AppImage。
STEP 05 / CONNECT AGENTS
在 CCS 中填入 NewAPI
路径通常是：选择对应工具 → 添加供应商 → 选择自定义或兼容协议 → 粘贴密钥与地址 → 保存并启用。
先记住这一条：Claude Code 的基础地址不加 /v1；Codex 和 OpenCode 的 OpenAI 兼容地址要加 /v1。地址多一个或少一个 /v1 都可能造成 404。
Claude Code
API Key / ANTHROPIC_API_KEY
sk-你的NewAPI密钥基础地址 / ANTHROPIC_BASE_URL
https://newapi.guanyx.xyz模型
从模型广场选择 Claude 模型关键提醒
这里不能加 /v1保存后在 CCS 中启用这个供应商。CCS 的说明中，Claude Code 一般不需要重新启动；若没有生效，关闭并重新打开终端即可。
Codex
API Key / OPENAI_API_KEY
sk-你的NewAPI密钥官网 / 网站链接（请填写）
https://newapi.guanyx.xyz/consoleAPI 请求地址（请填写）
https://newapi.guanyx.xyz/v1模型
从模型广场选择 OpenAI 端点模型在 CCS 里保存并启用后，重启 Codex 让新的用户级配置生效。不要把地址写进项目目录的配置；供应商与认证属于本机用户配置。
OpenCode
类型
OpenAI CompatibleAPI Key
sk-你的NewAPI密钥API 请求地址
https://newapi.guanyx.xyz/v1模型
选择 OpenAI 端点中可用模型保存并启用后，重启 OpenCode 或终端。若 CCS 中的字段名称略有不同，以“Base URL / API URL / Endpoint”含义相同的字段为准。
Gemini CLI
GEMINI_API_KEY
sk-你的NewAPI密钥GOOGLE_GEMINI_BASE_URL
https://newapi.guanyx.xyz先在模型广场筛选 Gemini 端点并确认目标模型属于你的令牌分组。没有对应端点时，不要强行套用 OpenAI 地址。
OpenClaw / Hermes
这两类工具不要直接猜地址。请先在 CCS 里查看它需要的是 OpenAI 兼容还是 Anthropic 兼容协议：OpenAI 兼容时使用 https://newapi.guanyx.xyz/v1；Anthropic 兼容时使用 https://newapi.guanyx.xyz。然后在模型广场确认模型和端点类型一致后再保存。
BONUS / CREATIVE WORKBENCH
不只写代码，也可以直接创作
以下是 NewAPI 控制台当前登记的工作台入口。链接可能调整；打不开时请回到控制台公告查看最新入口。
语音工作台
生成语音、声音克隆与音色设计。
https://audio.guanyx.xyz音乐工作台
调用音乐模型，生成你的音乐作品。
https://music.guanyx.xyz视频剪辑网站
进入视频剪辑工作台处理视频内容。
https://videocut.guanyx.xyz图片生成
进入图片生成工作台，使用生图模型创作。
https://image.guanyx.xyz/链接说明。此处使用当前控制台内登记的域名入口，而不是旧公告里的 IP 加端口地址。它们是网页工作台，与 CCS 的 API 配置地址不是同一个概念。
FINAL CHECK / TROUBLESHOOTING
最后测试，出错就按这里查
先从最常见的三项检查：密钥、分组、地址。不要为了排错把真实密钥发给任何人。
认证失败
检查粘贴的密钥是否完整、是否被禁用、令牌分组是否有权使用目标模型。
地址不正确
Claude Code 用域名根地址；Codex / OpenCode 用带 /v1 的地址。不要混用。
找不到模型
回到模型广场检查模型是否仍可用，并确认令牌分组与模型广场显示的可用分组一致。
保存后没变化
确认在 CCS 中点击了“启用”；随后重启对应 CLI 或终端。Claude Code 通常不需要重启。
- 账户已有余额或有效套餐。
- 模型广场确认了模型、端点类型和令牌分组。
- 已创建专用密钥，且没有泄露给别人。
- 在 CCS 中填入与工具匹配的 API 地址。
- 保存、启用，然后进行一次简单的测试对话。