文档

Claude Code 接入 OrcAI

Anthropic 官方终端编程工具，改两个环境变量即可走 OrcAI 稳定分组（0.3 倍率）。

1. 安装 Claude Code

# macOS（Homebrew）
brew install --cask claude-code
# macOS / Linux 脚本安装
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# 或 npm
npm install -g @anthropic-ai/claude-code

2. 配置 OrcAI（推荐 settings.json）

编辑 ~/.claude/settings.json（Windows 为 %USERPROFILE%\.claude\settings.json，项目级为 .claude/settings.json）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.orcai.cc",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
  }
}
Claude Code 会自动加载 settings.json 的改动，不需要重启。

或者用环境变量

# macOS / Linux（写入 ~/.zshrc 或 ~/.bashrc）
export ANTHROPIC_BASE_URL="https://api.orcai.cc"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"

# Windows PowerShell（用户级，永久）
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.orcai.cc", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的密钥", "User")
Windows 下用 setx / SetEnvironmentVariable 写入后，必须重新打开终端才生效；已打开的窗口读不到新变量。

3. 选择模型

Claude 稳定分组可用模型（倍率 0.3×）
模型ID适用
Claude Opus 5claude-opus-5复杂推理、大型重构、Agent 任务
Claude Sonnet 5claude-sonnet-5日常编码，速度与质量均衡
Claude Opus 4.8claude-opus-4-8上一代旗舰
Claude Sonnet 4.6claude-sonnet-4-6上一代均衡型
Claude Haiku 4.5claude-haiku-4-5快速、低成本，适合子任务
claude --model claude-opus-5
# 或在会话里 /model claude-sonnet-5

4. 验证是否接入成功

curl https://api.orcai.cc/v1/messages \
  -H "x-api-key: sk-你的密钥" -H "anthropic-version: 2023-06-01" -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":64,"messages":[{"role":"user","content":"用一句话介绍你自己"}]}'

返回 JSON 里的 model 字段应等于 claude-sonnet-5，usage 里有 input_tokens / output_tokens。

常见问题

  • 401：密钥错误，或把 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 混用了；只保留 AUTH_TOKEN。
  • 402：额度不足，充值 后立即恢复。
  • 429：分组并发限制，稍后重试。
  • 模型不存在：确认密钥所在分组含该模型，见 模型列表。
Claude Code 接入 OrcAI 只需两个变量：ANTHROPIC_BASE_URL=https://api.orcai.cc 与 ANTHROPIC_AUTH_TOKEN=你的密钥。

← 返回文档索引

用这把密钥开始

注册即可创建密钥，¥50 起充，额度永不过期。

免费注册 接入文档

最后更新：2026-09-24 · 作者：OrcAI 团队