Claude Code：接入低价 AI API
Claude Code 直接调用原生的 /v1/messages 接口，扩展思考和原生 tool_use 完整保留，提示词缓存也真正按缓存价计费。配置只需两个环境变量，不需要 Anthropic 账号。
Claude Code
Anthropic 官方 CLI
创建 API 密钥：打开密钥页面 → 点击创建密钥，起个名字（例如 claude-code），复制密钥。明文之后不会再显示。
先安装 Node.js 18+（自带 npm）：nodejs.org/download。用 node -v 检查。然后安装 Claude Code：
npm install -g @anthropic-ai/claude-code确认安装成功：claude --version。
macOS / Linux：把环境变量写入 shell 配置文件（~/.bashrc 或 ~/.zshrc），然后重新加载（source ~/.zshrc）：
export ANTHROPIC_BASE_URL="https://cheapai.io"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"Windows PowerShell：为当前会话设置：
$env:ANTHROPIC_BASE_URL = "https://cheapai.io"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"要永久生效，可通过 [System.Environment]::SetEnvironmentVariable(...) 或“系统属性 → 环境变量”添加。
另一种方式：按项目配置 .claude/settings.json（无需全局环境变量）：
{
"env": {
"ANTHROPIC_BASE_URL": "https://cheapai.io",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
}
}在项目目录中运行 claude，问一个简单的问题（例如“这里有哪些文件？”）。看到回复，就说明接入成功了。
claude可选：固定具体的模型版本。Claude Code 默认使用最新的别名，Anthropic 发布更新时，这个别名可能指向网关尚未上架的模型。显式固定版本，就能自己决定智能体何时切换到新模型。设置 ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL：
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"也可以把它们加到 .claude/settings.json 的 env 中，和 ANTHROPIC_BASE_URL 放在一起。当前可用的模型请查看模型页面，固定到真实存在的 ID。
把 YOUR_API_KEY 替换为密钥页面中的真实密钥。
Claude Code 常见问题
为什么 base URL 不带 /v1？
SDK 会自己拼接 /v1/messages。如果填 https://cheapai.io/v1，实际请求会变成 https://cheapai.io/v1/v1/messages，并报 «Invalid URL» 错误。这是配置 Claude Code 时最常见的错误。
Claude Code 连接中断怎么办？
运行 claude --debug，它会显示真实的错误，而不是笼统的 «API error»。首字节后 15–20 秒断开，通常是超时设置导致的：API_TIMEOUT_MS、CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS、CLAUDE_STREAM_IDLE_TIMEOUT_MS。
可以固定具体的模型版本吗？
可以，用 ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL 和 ANTHROPIC_DEFAULT_HAIKU_MODEL。当 Anthropic 发布了网关还没上架的新模型时，这能帮您避坑：不带版本的别名会解析成一个不存在的名称。