接入 Claude Code

通过 Nusabase Anthropic Messages 兼容接口配置 Claude Code。

本指南用于让 Claude Code 通过 Nusabase 网关调用模型。Claude Code 会基于 ANTHROPIC_BASE_URL 拼接 /v1/messages，因此这里填写根地址：https://api.nusabase.com。

​

适用场景

• 你主要在终端中使用 Claude Code。
• 你希望继续使用 Anthropic Messages 格式。
• 你希望 API Key、限额和用量统一走 Nusabase。

​

前置条件

• 已安装 Claude Code。
• 已准备 Nusabase API Key：sk-...。
• 当前网络可访问 https://api.nusabase.com。
• 示例模型 qwen3.5-flash 来自当前价格文档；实际可用模型以 /v1/models 返回为准。

​

配置环境变量

Linux / macOS / WSL：

export ANTHROPIC_BASE_URL=https://api.nusabase.com
export ANTHROPIC_AUTH_TOKEN=sk-你的_api_key
export ANTHROPIC_MODEL=qwen3.5-flash

Windows PowerShell：

$env:ANTHROPIC_BASE_URL="https://api.nusabase.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的_api_key"
$env:ANTHROPIC_MODEL="qwen3.5-flash"

配置说明：

配置项	正确值	说明
ANTHROPIC_BASE_URL	https://api.nusabase.com	填根地址，不加 /v1。
ANTHROPIC_AUTH_TOKEN	sk-...	Claude Code 会作为 Authorization Bearer 发送。
ANTHROPIC_API_KEY	sk-...	可选替代项；未设置 AUTH_TOKEN 时作为 x-api-key 使用。
ANTHROPIC_MODEL	qwen3.5-flash	使用 /v1/models 返回的真实模型名。

​

持久化配置

用户级配置写入 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.nusabase.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的_api_key",
    "ANTHROPIC_MODEL": "qwen3.5-flash"
  }
}

项目级共享配置不要包含真实 API Key，可以只提交模型和 Base URL：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.nusabase.com",
    "ANTHROPIC_MODEL": "qwen3.5-flash"
  }
}

​

验证 Nusabase 接口

curl https://api.nusabase.com/v1/models \
  -H "Authorization: Bearer sk-你的_api_key"

curl https://api.nusabase.com/v1/messages \
  -H "x-api-key: sk-你的_api_key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.5-flash",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "hello"}]
  }'

​

启动 Claude Code

claude

进入交互界面后发送：

你好，请介绍一下当前项目结构

​

模型选择说明

Claude Code 的网关模型发现只会把部分符合 Anthropic 命名规则的模型加入模型选择器。对于 qwen3.5-flash 这类非 Claude 命名模型，建议显式设置 ANTHROPIC_MODEL。

如需尝试网关模型发现：

export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

​

常见问题

问题	可能原因	处理方式
404	ANTHROPIC_BASE_URL 错填为 /v1	改为 https://api.nusabase.com。
401	API Key 错误或头部不匹配	优先使用 ANTHROPIC_AUTH_TOKEN=sk-...，再用 curl 验证。
模型不可用	ANTHROPIC_MODEL 不在账号可用列表	调用 /v1/models 后复制真实模型名。
模型选择器看不到 qwen 模型	Claude Code 网关发现有命名过滤	显式设置 ANTHROPIC_MODEL。

下一步可查看 首个请求示例。

​

参考资料

• Claude Code LLM gateway
• Claude Code 总览
• Anthropic Messages API
• 首个请求示例
• 错误码