Claude Code 接入 XQAPI

通过 XQAPI 的 Anthropic Messages 兼容接口运行 Claude Code，并让模型列表直接从网关读取。

准备工作

1. 1
   创建 XQAPI API Key

   登录控制台创建 API Key，密钥只在创建时完整显示一次。

2. 2
   选择 Claude 模型

   先在模型库确认要使用的 Claude 公开模型 ID 和当前价格。

3. 3
   配置并启动 Claude Code

   先用临时环境变量验证，再按需写入用户级 settings.json。

配置

复制与你的客户端对应的最小配置，再把占位密钥和模型 ID 替换为自己的值。

export ANTHROPIC_BASE_URL="https://ai.kuo.la"
export ANTHROPIC_AUTH_TOKEN="your-xqapi-key"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
claude

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.kuo.la",
    "ANTHROPIC_AUTH_TOKEN": "your-xqapi-key",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

验证

• 启动 claude 后运行 /status，确认 Anthropic base URL 指向 XQAPI，认证来源显示 ANTHROPIC_AUTH_TOKEN。
• 发送一条短消息验证流式输出正常。
• 运行 /model，选择标记为 From gateway 的公开 Claude 模型。

常见问题

• ANTHROPIC_BASE_URL 填站点根地址，不要追加 /v1/messages。
• ANTHROPIC_AUTH_TOKEN 会把密钥放入 Authorization: Bearer 请求头，与 XQAPI 的认证方式一致。
• 不要把密钥写入会提交到仓库的 .claude/settings.json；项目级配置应使用已加入 gitignore 的 settings.local.json。