Claude Code 接入指南

最后更新

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。每个模型的对照表见模型目录里该模型的「推理档位」一节;发生改写的调用,用量明细里会显示「推理档位改写」。

连不通时检查

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

配置步骤

  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。

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 会优先使用它。想切回订阅账号时去掉这些环境变量即可。