配置模型供应商

推荐使用 CC Switch 完成配置 —— 一款开源的供应商管理工具，可视化操作，无需手动编辑 JSON 或环境变量。

1. 安装 CC Switch

macOS


brew install --cask cc-switch

或前往 Releases 下载 .dmg 手动安装。

Windows

前往 Releases 下载 .msi 安装程序。

Linux


# Debian / Ubuntu
sudo dpkg -i CC-Switch-*.deb
 
# Fedora / RHEL
sudo rpm -i CC-Switch-*.rpm
 
# AppImage
chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

支持 macOS 12+、Windows 10+、Ubuntu 22.04+ / Debian 11+ / Fedora 34+

2. 添加 OfoxAI 供应商

步骤一：新增供应商

打开 CC Switch，进入供应商管理页，点击右上角 + 按钮。

步骤二：填写配置

按下图标注填写，点击 + 添加 完成。

配置项	值	说明
❶ 供应商名称	`ofoxai-claude`	自定义，方便识别
❷ 官网链接	`https://ofox.ai`	供应商官网
❸ API Key	你的 OfoxAI API Key	在 app.ofox.ai 获取
❹ 请求地址	`https://api.ofox.ai/anthropic`	末尾不要加斜杠
❺ API 格式 / 认证字段	`Anthropic Messages (原生)` / `ANTHROPIC_AUTH_TOKEN（默认）`	保持默认
❻ 模型配置	留空	留空使用默认 Claude 模型
❼ 选项	勾选「隐藏 AI 署名」和「Teammates 模式」	按需勾选
❽ 写入通用配置	✅ 勾选	写入全局配置，所有项目生效

CC Switch 自动写入 ~/.claude/settings.json，无需手动编辑任何文件。

步骤三：启用供应商

添加完成后回到列表，选中 ofoxai-claude，点击使用按钮，看到「切换成功」提示即完成。

3. 验证配置

进入项目目录，启动 Claude Code：


cd your-project
claude

首次启动按 Esc 跳过登录。启动后注意顶部信息栏，确认显示 API Usage Billing（❶）表示已通过 OfoxAI 计费：

以上信息确认无误，即配置成功。

故障排除

遇到问题时，在 Claude Code 终端中运行 /status 检查配置：


/status

确认以下关键字段：

❶ Anthropic base URL 为 https://api.ofox.ai/anthropic
❷ Model 显示当前使用的模型

Q: 提示 “Authentication error”

确认 Anthropic base URL 正确，并检查 API Key 是否有效。

Q: 连接超时

确认请求地址填写为 https://api.ofox.ai/anthropic，末尾不带斜杠。

Q: 流式响应卡顿

OfoxAI 已内置全球加速，通常为本地网络问题，检查本地连接后重试。