文档

创建 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。