Claude Code

Claude Code 是 Anthropic 官方推出的 AI 编程终端工具，直接在命令行交互式编程。最大特点是深度集成 git / 文件系统 / shell，能自主多步执行（分析需求 → 写代码 → 跑测试 → 修 bug）。也提供 VS Code / JetBrains 官方插件。

适合谁：偏好终端工作流的开发者；做 agentic 编程任务（不是单纯问答）；用 git 管代码并希望 AI 自己提交。

本教程：把 Claude Code 指向 claude-api.org 中转，享受 Claude 4.7 系列原生体验且无需 Anthropic 订阅。

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

推荐渠道

Claude 官方（仅限claude code） (1.4x) —— 高质量上游、稳定性最优，为 Claude Code CLI 专属优化，仅接受官方 claude-cli/X.Y.Z 客户端。

用 Cline / Cursor / opencode 等其他客户端调 Claude 请选 Claude 官方（不限客户端） (2.0x) 或 低价claude (0.5x，质量相对不稳定)。

安装

需要 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-6",
    "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-6            # 主力，平衡（推荐）
claude --model claude-haiku-4-5-20251001    # 便宜快

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

上下文窗口

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

常见问题

401 Unauthorized

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

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。