Claude Code

Claude Code 是 Anthropic 的编程用 AI 工具，在终端和 VS Code 里运行。Claude Code 用 Anthropic 格式连接 Echo。

验证情况：Claude Code 2.1.278（2026-09-27，Echo 的验证环境）

开始之前

• Claude Code 使用的是 Claude 的模型。Anthropic 不支持经由 Echo 这样的中转服务（网关）使用 Claude 以外的模型。Anthropic 也不推荐、不维护、不审核网关产品
• 设置了 Echo 的密钥期间，不会使用 claude.ai 的订阅。费用从 Echo 的余额中扣除
• 准备好 Echo 的 API 密钥，以及要用的 Claude 模型的 ID。提供的 Claude 模型及其 ID，可以在模型一览查看

设置

在终端里设置

设置下面的环境变量（设置在电脑上的、带名字的值）。把 sk-... 换成 Echo 的 API 密钥，把模型 ID 换成要用的模型的 ID。

export ANTHROPIC_BASE_URL="https://token.echohub.io"
export ANTHROPIC_AUTH_TOKEN="sk-..."
export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

• 不设置模型 ID 时，Claude Code 会用它自己默认的模型 ID 调用。Echo 不提供那个 ID 时会出错，而且要 1 分钟以上才会显示错误（见下面的「已确认的问题」）
• ANTHROPIC_DEFAULT_OPUS_MODEL 等 3 个变量，也要填 Echo 提供的模型的 ID。填了 Echo 不提供的 ID，用到那个模型时会出错
• ANTHROPIC_API_KEY 里放着别的密钥（Anthropic 的密钥等）时，先删掉再设置。Claude Code 会用 x-api-key 请求头发送这个变量里的密钥

写进设置文件

不想每次都设置时，写进 ~/.claude/settings.json（Windows 是 %USERPROFILE%\.claude\settings.json）的 env。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://token.echohub.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

在 shell 和设置文件里设置了同一个变量时，使用设置文件里的值。

注意：不要把密钥写进项目的 .claude/settings.json。这个文件会进入代码仓库，与其他人共享。

在 VS Code 扩展里使用

写进 VS Code 用户设置（用命令「Preferences: Open User Settings (JSON)」打开）的 claudeCode.environmentVariables。扩展会在启动前确认这个设置里的认证信息。

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://token.echohub.io" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-..." },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5" }
  ]
}

确认能用

1. 在设置了环境变量的终端里运行下面的命令。最后一行显示 200，上面显示包含 "type":"message" 的 JSON，就说明接入地址和密钥设置正确

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 16, "messages": [{"role": "user", "content": "こんにちは"}]}'

2. 在同一个终端里启动 claude，运行 /status。确认接入地址是 https://token.echohub.io，认证信息显示的是 ANTHROPIC_AUTH_TOKEN
3. 随便问点什么，没有出错地返回回答就完成了。控制台的「呼び出し履歴」（调用记录）里也会出现记录

已确认的问题

以下是 2026-09-27 在 Echo 的验证环境中确认的行为。

上游 API 返回错误的情况，以及错误正文的一览，见错误与处理。

不能正常使用时

Claude Code 会在请求里附上区分终端和会话的 ID。Echo 不做修改地把这个值传给上游的 Anthropic。详情见数据处理。

信息来源