配置 Claude Code 使用 ghc-api

1. 安装 Claude Code

可使用 Anthropic 官方安装程序，或在已有 Node.js 环境中通过 npm 安装。

Shell

npm install -g @anthropic-ai/claude-code
# 或 Linux / macOS
curl -fsSL https://claude.ai/install.sh | bash

2. 配置 ~/.claude/settings.json

JSON

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:8313",
    "ANTHROPIC_AUTH_TOKEN": "1",
    "ANTHROPIC_MODEL": "YOUR_MESSAGES_MODEL_ID",
    "API_TIMEOUT_MS": "1200000"
  }
}

若 ghc-api 开启了用户鉴权，把 1 替换为已批准的 gha_... Token。ANTHROPIC_BASE_URL 不要写成 .../v1，Claude Code 会自行调用 Messages 路径。

3. 只选择支持 Messages 的模型

Shell

curl http://127.0.0.1:8313/v1/models/full/

在返回数据中找到模型的 supported_endpoints，确认包含 /v1/messages。主模型可优先选择更强的编码模型；不要从旧教程复制可能已下线的 ID。旧版教程常见的 ANTHROPIC_SMALL_FAST_MODEL 已被 Claude Code 官方标记为 deprecated，不建议作为新配置的基础。

长上下文后缀也必须真实存在。

类似 [1m] 的名称只有在代理映射或上游模型确实支持时才可使用。最稳妥的方法始终是复制实时模型 ID。

4. 常见问题

401：鉴权已开启但 Token 未批准，或客户端没有发送 ANTHROPIC_AUTH_TOKEN。
404：Base URL 多写了 /v1，导致路径重复。
模型不支持：模型未开放给当前 Copilot 账户，或不支持 Messages 端点。
长时间无输出：保留 ghc-api 的 SSE keepalive，并适当提高 API_TIMEOUT_MS。
工具调用异常：先查看 Dashboard 的 Raw SSE；只有确认遇到纯文本泄漏时才考虑开启 tool-call recovery。