Claude Code

把 Claude Code 指到 SupaNexus 的 Anthropic 兼容 Messages API：同一套 CLI，走网关计费。

1. 领取 SupaNexus API Key

登录开发者控制台，进入项目 → API Keys，创建 Key 并立即复制（仅展示一次）。同一把项目 Key 可用于 OpenAI 兼容与 Anthropic 兼容客户端。

2. 安装 Claude Code

推荐原生安装脚本。若本机已有 Node.js 18+，也可用 npm。

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# or
npm install -g @anthropic-ai/claude-code

3. 把环境变量指到 SupaNexus

Claude Code 使用 Anthropic 协议。ANTHROPIC_BASE_URL 填 SupaNexus 接入点 host（不含 /v1）。项目 Key 放进 ANTHROPIC_AUTH_TOKEN（Bearer）。必须把 ANTHROPIC_API_KEY 显式设为空，避免以 x-api-key 直连 Anthropic。写入 ~/.zshrc 或 ~/.bashrc 后执行 source（或开新终端）。

export ANTHROPIC_BASE_URL="<BASE_URL>"
export ANTHROPIC_AUTH_TOKEN="sk-snx-..."
export ANTHROPIC_API_KEY=""   # must be empty

4. 可选：项目级配置

若希望配置只作用于当前仓库（避免写进 shell profile），在项目根创建 .claude/settings.local.json。不要写进普通 .env——原生 Claude Code 安装不会读取 .env。

{
  "env": {
    "ANTHROPIC_BASE_URL": "<BASE_URL>",
    "ANTHROPIC_AUTH_TOKEN": "sk-snx-...",
    "ANTHROPIC_API_KEY": ""
  }
}

5. 清除缓存的 Anthropic 登录

若曾用 Anthropic 账号登录过 Claude Code，先执行一次 /logout，退出后再启动。缓存登录与网关凭据并存时，启动阶段常出现令人困惑的 model-not-found。

claude
> /logout
# quit, then start again

6. 在项目中启动并验证

在仓库目录运行 claude。会话内 /status 应显示 Auth token: ANTHROPIC_AUTH_TOKEN，且 Anthropic base URL 指向 SupaNexus。再发一条短提示，到控制台确认用量。

cd /path/to/your/project
claude
> /status

7. 可选：固定各档型号

Claude Code 会按 Opus / Sonnet / Haiku 等档位路由。可用目录型号覆盖各档。工具调用稳定性优先选 Anthropic 系型号。

export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-3-5-sonnet"
export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-3-5-sonnet"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-3-5-haiku"
export CLAUDE_CODE_SUBAGENT_MODEL="anthropic/claude-3-5-sonnet"

8. 排障

鉴权失败：确认 ANTHROPIC_API_KEY 为空字符串、Key 在 ANTHROPIC_AUTH_TOKEN，且已重新加载 shell。Host 错误：Base URL 必须是接入点 host，不含 /v1。/status 仍显示 Anthropic 登录：再执行 /logout 并重启。

接入说明 →