# Claude Code 接入指南

https://omnimodel.me/apps/claude-code?lang=zh

> Anthropic 的终端编程代理，走 Anthropic Messages 协议接入。

## 适用场景

适合在终端里让代理读项目、改文件、跑测试。Claude Code 走 Anthropic Messages 协议，接入地址是 `https://omnimodel.me/anthropic`，可以选目录里任意支持工具调用的模型，不限于 Claude。

## 使用建议

编程代理一次任务会连续发出很多请求，输入也长，建议选上下文较长、支持工具调用的模型，并给密钥设置每日消费上限。

## 推理档位

Claude Code 发 Anthropic 的 `thinking`：带 `budget_tokens` 时按预算换算档位（≤512 为 minimal，≤1024 为 low，≤8192 为 medium，≤24576 为 high，更大为 xhigh）；`adaptive` 且没带 effort 时按 `xhigh` 处理；`disabled` 表示关闭思考。平台按模型实际走的线路能接受的档位处理：上游不收请求的档位时改用更高一档，高过最高档时取最高档；模型不能关闭思考时，要求关闭会返回 422 `model.reasoning_off_unsupported`。每个模型的对照表见[模型目录](/catalog)里该模型的「推理档位」一节；发生改写的调用，用量明细里会显示「推理档位改写」。

## 连不通时检查

1. `ANTHROPIC_BASE_URL` 填 `https://omnimodel.me/anthropic`，不要带 `/v1`，客户端会自己拼 `/v1/messages`。
2. 密钥以 `key_` 开头且没有被暂停或撤销，错误码 `auth.invalid_key` 表示密钥不可用。
3. 模型 ID 与[模型目录](/catalog)一致，并且在这把密钥的可用模型里。
4. 余额不足会返回 `billing.insufficient_credit`，更多错误见[常见错误](/docs/errors)。

## 配置步骤

1. 安装：npm install -g @anthropic-ai/claude-code。
2. 把下面的环境变量写进 shell 配置（如 ~/.zshrc），新开终端生效。
3. 在项目目录执行 claude，用 /model 确认当前模型。

## 配置参数

- API 地址：`https://omnimodel.me/anthropic`
- API 密钥：`YOUR_API_KEY`
- 模型：`MODEL_ID`

> 平台对 Claude Code 的兼容性验收仍在进行，遇到问题请提交工单并附上请求 ID。

```bash
export ANTHROPIC_BASE_URL="https://omnimodel.me/anthropic"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="MODEL_ID"
export ANTHROPIC_DEFAULT_OPUS_MODEL="MODEL_ID"
export ANTHROPIC_DEFAULT_SONNET_MODEL="MODEL_ID"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="MODEL_ID"
```

## 常见问题

### 为什么四个模型变量都要设？

Claude Code 会按任务在不同档位的模型之间切换，比如用小模型生成标题。四个变量都指向同一个模型，就不会请求到平台没有的模型名。

### 已经登录了 Claude 订阅账号怎么办？

设置了 ANTHROPIC_AUTH_TOKEN 后，Claude Code 会优先使用它。想切回订阅账号时去掉这些环境变量即可。