Claude Code 配置
Claude Code 是 Anthropic 的编码客户端。本指南帮助你接入 Ofox 账户；模型可用性、速率限制与费用以账户及所选模型为准。
使用 Ofox Desktop 更快完成配置。 在 Apple 芯片 Mac 上，Desktop 可以检测此工具、备份现有配置，并应用 Ofox API Key 和兼容模型。打开 Ofox Desktop 。
选择配置方式
- **Ofox Desktop：**先查看设备与客户端支持范围 ，再按应用内流程配置。
- **CC Switch：**按供应商配置指南操作。同一时间使用一种配置方式，避免设置相互覆盖。
替换已有配置前先备份。安装配置工具本身不代表 API 已接通。
快速开始
验证首次请求
- 对照供应商指南核对所选供应商、凭证和模型。Claude Code 指南使用 Anthropic 协议，不应因为同样使用 API Key 就直接复用 Codex 的端点。
- 开始新会话，发送“只回复 OK”等简短请求。模型调用按账户与模型价格计费。
- 在 Ofox 用量记录中核对时间与模型。收到回复本身不能确认请求由哪个供应商处理。
- 需要工具调用时，在临时测试项目中另行验证，并检查工具动作与结果。文本请求通过不等于工具兼容性通过。
重试前先排查
| 现象 | 先检查 | 下一步 |
|---|---|---|
| 认证错误 | 当前凭证、所选供应商和已有配置是否冲突 | 修正凭证来源后新建会话；截图中不要包含 Key |
| 端点或模型不存在 | 协议、基础地址与精确模型 ID | 对照配置指南和账户可用模型，避免重复追加路径 |
| 限流或额度错误 | 错误返回、余额与适用限制 | 按错误处理限额或等待，避免反复重试；部分请求可能计费 |
| 文本成功但工具失败 | 工具参数、模型能力与工具结果 | 缩小为一个工具用例排查，不把认证成功当作全功能可用 |
| 没有对应 Ofox 用量记录 | 当前账户、供应商与请求时间 | 先验证实际请求路径，再判断配置是否完成 |
报障时记录客户端版本、操作系统、精确模型 ID、请求时间与时区、HTTP 状态，以及返回中可用的请求标识。提交前移除 Key、认证头、私人提示词和项目内容。
按任务选择模型
通过编程模型选型 缩小候选范围，再测试实际工具与工作负载。推荐分数不保证某个模型支持 Claude Code 的全部功能。
Last updated on