# Claude Code 接入 OfoxAI 配置指南

Source: https://ofox.io/zh/docs/integrations/claude-code

[Claude Code](https://claude.com/product/claude-code) 是 Anthropic 的编码客户端。本指南帮助你接入 Ofox 账户；模型可用性、速率限制与费用以账户及所选模型为准。

> **使用 Ofox Desktop 更快完成配置。** 在 Apple 芯片 Mac 上，Desktop 可以检测此工具、备份现有配置，并应用 Ofox API Key 和兼容模型。[打开 Ofox Desktop](https://ofox.io/zh/desktop)。

![Claude Code in Terminal](https://ofox.io/images/integrations/claude-code-terminal.png)

## 选择配置方式

- **Ofox Desktop**：先查看[设备与客户端支持范围](https://ofox.io/zh/desktop)，再按应用内流程配置。
- **CC Switch**：按[供应商配置指南](https://ofox.io/zh/docs/integrations/claude-code/model-provider)操作。同一时间使用一种配置方式，避免设置相互覆盖。

替换已有配置前先备份。安装配置工具本身不代表 API 已接通。

## 快速开始

  - **1. 安装 Claude Code**
  - **2. 配置模型供应商**
  - **3. CCometixLine 状态栏**
  - **4. 配置 Skills**

## 验证首次请求

1. 对照供应商指南核对所选供应商、凭证和模型。Claude Code 指南使用 Anthropic 协议，不应因为同样使用 API Key 就直接复用 Codex 的端点。
2. 开始新会话，发送“只回复 OK”等简短请求。模型调用按账户与模型价格计费。
3. 在 Ofox 用量记录中核对时间与模型。收到回复本身不能确认请求由哪个供应商处理。
4. 需要工具调用时，在临时测试项目中另行验证，并检查工具动作与结果。文本请求通过不等于工具兼容性通过。

## 重试前先排查

| 现象 | 先检查 | 下一步 |
| --- | --- | --- |
| 认证错误 | 当前凭证、所选供应商和已有配置是否冲突 | 修正凭证来源后新建会话；截图中不要包含 Key |
| 端点或模型不存在 | 协议、基础地址与精确模型 ID | 对照配置指南和账户可用模型，避免重复追加路径 |
| 限流或额度错误 | 错误返回、余额与适用限制 | 按错误处理限额或等待，避免反复重试；部分请求可能计费 |
| 文本成功但工具失败 | 工具参数、模型能力与工具结果 | 缩小为一个工具用例排查，不把认证成功当作全功能可用 |
| 没有对应 Ofox 用量记录 | 当前账户、供应商与请求时间 | 先验证实际请求路径，再判断配置是否完成 |

报障时记录客户端版本、操作系统、精确模型 ID、请求时间与时区、HTTP 状态，以及返回中可用的请求标识。提交前移除 Key、认证头、私人提示词和项目内容。

## 按任务选择模型

通过[编程模型选型](https://ofox.io/zh/model-finder/best-llm-for-coding)缩小候选范围，再测试实际工具与工作负载。推荐分数不保证某个模型支持 Claude Code 的全部功能。