Claude Code 配置

Claude Code 应通过本站的 Anthropic Messages 兼容接口接入。本站令牌使用 Bearer 认证，因此采用 ANTHROPIC_AUTH_TOKEN；不要改成 ANTHROPIC_API_KEY，后者会把凭据放入 x-api-key 请求头。

模型范围

Anthropic 官方支持 Claude Code 通过兼容网关调用 Claude 模型，不支持把任意非 Claude 模型伪装为 Claude。模型出现在本站 /v1/models 中，不代表它一定适合 Claude Code。

当前可用性

截至 2026-09-20，本站已启用模型目录中没有明确标识为 Claude 的模型。本文保留标准接入配置，供管理员后续开放兼容模型时使用；配置前必须先通过 /v1/models 和 /v1/messages 验证，不能把当前 GPT 或 Seedance 模型直接当作 Claude 模型。

1. 设置环境变量

export NEWAPI_API_KEY="sk-替换为你的令牌"
export ANTHROPIC_BASE_URL="https://newapi.fq-hx.com"
export ANTHROPIC_AUTH_TOKEN="$NEWAPI_API_KEY"
export ANTHROPIC_MODEL="替换为支持 Anthropic Messages 的 Claude 模型名"

ANTHROPIC_BASE_URL 不要追加 /v1，Claude Code 会请求 ${ANTHROPIC_BASE_URL}/v1/messages。

如果网关没有提供 Claude Code 内置的默认 Opus、Sonnet、Haiku 名称，可按实际可用模型设置映射：

export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"

2. 验证 Messages API

curl -sS "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d "{\
    \"model\": \"$ANTHROPIC_MODEL\",\
    \"max_tokens\": 16,\
    \"messages\": [{\"role\": \"user\", \"content\": \"只回复 OK\"}]\
  }"

验证成功后，从同一终端启动：

claude

在 Claude Code 中运行 /status，确认 Anthropic base URL 为本站地址，认证来源为 ANTHROPIC_AUTH_TOKEN。

3. 可选的持久配置

Claude Code 支持在 ~/.claude/settings.json 的 env 中保存变量，但这会把令牌以明文写入本机文件。更推荐通过 shell、密码管理器或凭据辅助程序注入。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://newapi.fq-hx.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-替换为你的令牌",
    "ANTHROPIC_MODEL": "替换为 Claude 模型名"
  }
}

常见问题

现象	优先检查
返回 401	是否使用 ANTHROPIC_AUTH_TOKEN，令牌是否有效
请求路径错误	ANTHROPIC_BASE_URL 是否误加 /v1
找不到模型	ANTHROPIC_MODEL 是否为当前可调用的 Claude 兼容模型
对话正常但工具失败	模型、网关和渠道是否兼容 Claude Code 的工具调用

官方资料

• Claude Code：连接 LLM Gateway