CC Switch
通过 CC Switch 快速导入 678API 配置
678API 已适配 CC Switch。无需手动复制端点和密钥,只需在控制台选择目标应用和模型,即可快速导入配置。
获取 CC Switch
支持的目标应用
快速导入支持 Claude、Codex 和 Gemini。导入前请先安装并打开 CC Switch。
五步完成快速导入
创建密钥并选择 CC Switch
在 API 密钥右侧点击“导入到 CCS”
进入 678API 控制台的 API 密钥页面创建密钥。在对应密钥右侧的操作区域点击 导入到 CCS。

选择应用、配置名称和主模型
选择目标应用和模型后打开 CC Switch
在弹窗中选择 Claude、Codex 或 Gemini,填写或选择配置名称,再从下拉列表选择主模型。确认后点击 打开 CC Switch 完成导入。

确认配置并导入
核对配置内容后直接点击导入
配置内容带到 CC Switch 后不需要做任何更改。确认应用类型、供应商名称、API 端点、密钥和模型无误,然后点击 导入。

确认配置已启用
确认导入的 678API 配置已经启用
导入完成后,在 CC Switch 的供应商列表中确认新配置显示为 使用中,然后重新打开 Codex。

重启 Codex 并开始使用
重启后确认模型已生效
重启终端或 Codex 桌面端。确认顶部显示刚才选择的模型后,即可开始使用。

手动配置(可选)
如果浏览器无法唤起 CC Switch,也可以使用下面的值手动新建配置。
Profile Name
api678Base URL
https://www.678api.comAuth Token
YOUR_API_KEYModel
选择控制台可用 Claude 兼容模型环境变量方式
export ANTHROPIC_BASE_URL="https://www.678api.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"如果您的 Claude Code 或 CC Switch 版本要求 OpenAI Compatible 格式,则使用:
export OPENAI_BASE_URL="https://www.678api.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"常见异常
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 切换后仍走旧供应商 | 终端或客户端还保留旧环境变量 | 关闭当前终端重新打开;检查 env | grep -E "OPENAI|ANTHROPIC" 的输出。 |
| 提示 unauthorized | API Key 错误、复制了空格、密钥被禁用 | 重新复制密钥;确认 Key 状态正常;为 CC Switch 单独创建新 Key 测试。 |
| 提示 model not found | 模型名不在当前账户可用列表中 | 回到 678API 控制台复制模型名,确认账户分组有该模型权限。 |
| 提示 connection refused 或 timeout | 网络无法访问端点、本地代理异常或 DNS 缓存问题 | 浏览器打开 https://www.678api.com 检查连通性;切换网络或关闭冲突代理后重试。 |
| 一直使用默认模型 | CC Switch profile 中模型字段未生效 | 检查 profile 的模型字段;保存后重启 Claude Code;必要时在客户端设置中手动选择模型。 |
| 请求开始后很快失败 | 余额不足、订阅额度耗尽或预扣额度不够 | 进入钱包和用量日志查看余额;在线充值、兑换充值码或更换可用订阅。 |
排障建议
同时只保留一组生效的 Base URL 和 API Key。多套环境变量叠加时,客户端可能读取优先级最高的一组,导致看起来“切换了但没有生效”。