配置模型供应商

推荐使用 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 计费：

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

4. 使用其他模型

通过 OfoxAI，你可以在 Claude Code 中使用非 Claude 模型（如 Qwen、GLM、DeepSeek 等）。只需在模型广场筛选兼容模型，然后配置模型映射即可。

步骤一：筛选兼容模型

前往 OfoxAI 模型广场，在左侧 API 协议 中选择 Anthropic，筛选出支持 Anthropic 协议的模型。

步骤二：复制模型名称

点击目标模型卡片，模型名称旁有 复制按钮，一键复制模型 ID（如 bailian/qwen3.6-plus）。

步骤三：配置模型映射

回到 CC Switch，在供应商配置中找到 模型映射 部分。将复制的模型名称填入对应的模型槽位，可前往 OfoxAI 模型广场浏览可用模型：

映射槽位	说明
主模型	Claude Code 默认使用的模型
推理模型 (Thinking)	用于深度推理的模型
Haiku 默认模型	轻量级任务模型
Sonnet 默认模型	中等复杂度任务模型
Opus 默认模型	高复杂度任务模型

如果供应商原生提供 Claude 系列模型，通常无需配置模型映射。仅在需要将请求映射到不同模型名称时填写。

故障排除

遇到问题时，在 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 已内置全球加速，通常为本地网络问题，检查本地连接后重试。