跳到主要内容

Claude Code 配置教程

Claude Code 官方支持通过环境变量连接 LLM 网关。第一次配置时先在当前终端临时设置 Chutibe 地址和 Key；确认 /status 与消息请求都正常后，再决定是否保存到用户配置。

1. 安装 Claude Code​

Windows PowerShell：

winget install Anthropic.ClaudeCode

macOS、Linux 或 WSL 可以使用官方安装脚本。希望先检查脚本内容时，分三步执行：

curl -fsSL https://claude.ai/install.sh -o /tmp/claude-install.sh
less /tmp/claude-install.sh
bash /tmp/claude-install.sh

安装完成后检查版本：

claude --version

2. 临时连接 Chutibe​

先从 API Key 页面 复制一个可用 Key。

macOS、Linux 或 WSL：

read -rsp "Chutibe API Key: " ANTHROPIC_AUTH_TOKEN && echo
export ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_BASE_URL="https://api.chutibe.com"
export ANTHROPIC_MODEL="claude-sonnet-5"
claude

Windows PowerShell：

$secureKey = Read-Host "Chutibe API Key" -AsSecureString
$env:ANTHROPIC_AUTH_TOKEN = [System.Net.NetworkCredential]::new('', $secureKey).Password
$env:ANTHROPIC_BASE_URL = "https://api.chutibe.com"
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
claude

这些变量只在当前终端有效。关闭终端后，Key 不会继续保留在环境变量中。

3. 确认配置生效​

Claude Code 启动后运行：

/status

在 Status 页面确认：

  • Anthropic base URL 显示 https://api.chutibe.com
  • 认证来源显示 ANTHROPIC_AUTH_TOKEN
  • 当前模型是账号可用的 Claude 模型

关闭 Status 页面并发送一条短消息。能够正常回复，说明网关地址、Key 和模型都可用。

4. 保存到用户配置​

只在自己的电脑上使用时，可以把配置放到用户级文件：

  • macOS、Linux、WSL：~/.claude/settings.json
  • Windows：%USERPROFILE%\.claude\settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.chutibe.com",
    "ANTHROPIC_AUTH_TOKEN": "<CHUTIBE_API_KEY>",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}

把 <CHUTIBE_API_KEY> 替换为真实 Key。这个文件会以明文保存 Key，因此不要放进项目目录、不要提交 Git，也不要在共享电脑上使用这种方式。保存后重新启动 Claude Code，并再次运行 /status。

5. 切换模型​

临时切换可以在 Claude Code 中运行 /model。需要固定默认模型时，修改 ANTHROPIC_MODEL，模型 ID 必须来自当前账号的可用列表。

推荐从 claude-sonnet-5 开始；质量优先任务可以选择账号可用的 Opus 型号。不要直接照抄 Anthropic 官网的模型名，最终以 Chutibe 的模型目录和当前账号返回结果为准。

无法正常连接​

现象优先检查
启动后仍要求网页登录当前终端是否设置了 ANTHROPIC_AUTH_TOKEN
/status 没有网关地址ANTHROPIC_BASE_URL 是否传入了启动 Claude Code 的同一个终端
401Key 是否完整；认证变量是否使用 ANTHROPIC_AUTH_TOKEN
404Base URL 是否误写成了具体接口，正确值是根地址 https://api.chutibe.com
模型不存在修改 ANTHROPIC_MODEL 为当前账号可用的 Claude 模型

网关变量会优先于已经保存的 claude.ai 登录。想恢复官方账号登录时，删除用户配置中的三个变量，或在当前终端取消它们后重新启动 Claude Code。

参考​