Claude Code

Anthropic 官方终端 / IDE 插件。配 Claude 官方 渠道使用，原生 Claude 模型直接调用。

推荐渠道

Claude 官方——为 Claude Code 和 Anthropic 协议优化。

安装

需要 Node.js 18+。

npm install -g @anthropic-ai/claude-code

VS Code / JetBrains 用户也可以装官方 IDE 扩展，配置方式相同。

配置

方式 1：环境变量（推荐）

macOS / Linux

# 加到 ~/.zshrc 或 ~/.bashrc
export ANTHROPIC_BASE_URL="https://claude-api.org"
export ANTHROPIC_AUTH_TOKEN="sk-你的key"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"  # 可选：禁用遥测/网搜

Windows PowerShell

# 加到 $PROFILE
$env:ANTHROPIC_BASE_URL = "https://claude-api.org"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的key"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

一次性 (当前终端)

ANTHROPIC_BASE_URL="https://claude-api.org" \
ANTHROPIC_AUTH_TOKEN="sk-你的key" \
claude

方式 2：写入 ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://claude-api.org/",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

不要 commit settings.json

里面的 ANTHROPIC_AUTH_TOKEN 是你的余额访问凭证，泄露后别人能消耗你的钱包。务必 .gitignore 屏蔽这个文件。

验证

claude

进入 Claude Code 交互模式后，发一句 Hello。如果正常返回回复就成功。

也可以用 curl 验证：

curl -sS https://claude-api.org/v1/messages \
  -H "x-api-key: sk-你的key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-7",
    "max_tokens": 32,
    "messages": [{"role": "user", "content": "ping"}]
  }'

进阶

一键安装脚本

在终端粘贴：

curl -fsSL https://claude-api.org/install.sh | bash -s -- "sk-你的key"

脚本会自动写入环境变量到你的 shell rc 文件，重开终端即可。

模型选择

启动时加 --model：

claude --model claude-opus-4-7        # 旗舰，慢但强
claude --model claude-sonnet-4-7      # 主力，平衡（默认）
claude --model claude-haiku-4-5       # 便宜快

也可以在交互中用 /model 切换。

上下文窗口

Sonnet 4.6/4.7、Opus 4.6/4.7 默认 200K context，启动时加 --model claude-sonnet-4-7[1m] 可拓展到 1M（按输入 token 加价 2x）。

常见问题

401 Unauthorized

• Key 复制时多了空格 → 重新复制粘贴
• Key 已被你删掉 / 重新生成 → 后台 → API Keys 重新创建
• Key 绑的渠道是 OpenAI 平台 → 给 Claude Code 用必须是 Claude 官方 渠道

429 Rate Limit

系统正在限流保护中。处理：

• 等待 1–2 分钟自动恢复
• 频繁触发 → 错峰使用（19:00–23:00 是高峰）

Connection refused / ECONNREFUSED

• ANTHROPIC_BASE_URL 写错（必须是 https://claude-api.org，不是 api.anthropic.com）
• 你本地有 VPN / 代理拦截了 → 试 unset HTTP_PROXY 或在 VPN 软件里把 claude-api.org 加白

调用一直 stream 但没输出

通常是国内运营商对 SSE 长连接的中间设备超时。临时绕开：

export ANTHROPIC_NO_STREAM=1     # 关闭流式

或给本地 npm 包升到 ≥ 1.0.x（自带断流重试）。

更多见 FAQ。