Claude Code 接入 Grok-4.5

AI 专题研究 | Claude Code 通过 CCR 接入 xAI Grok-4.5 的完整配置与避坑指南

---

当前可用版本：Claude Code 通过 Claude Code Router（CCR）接入 xAI Grok-4.5。
这版文档按我实际验证过的配置写，避免再回到旧版的错误路由和鉴权问题。

---

一、实际链路

现在的工作链路是：

Claude Code
  -> CCR 本地服务 http://127.0.0.1:3456
  -> xAI Grok/grok-4.5

关键点：

• Claude Code 不直接连 xAI
• Claude Code 只认 CCR
• CCR 负责把 Claude 的请求转成适合 Grok 的协议
• 这次故障的根因不是模型名，而是 CCR 路由能力选错了协议

---

二、安装与启动

安装 CCR：

npm install -g @musistudio/claude-code-router

启动：

ccr start --no-open

查看 UI：

ccr ui

停止：

ccr stop

---

三、现在真正生效的配置

1. Claude Code 配置

当前可用的 settings.json 关键项如下：

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3456",
    "ANTHROPIC_AUTH_TOKEN": "CCR 里 Profile: Claude Code 对应的 key",
    "CLAUDE_CODE_GIT_BASH_PATH": "D:\\Program Files\\Git\\bin\\bash.exe",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "500000",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "500000",
    "CLAUDE_CODE_EFFORT_LEVEL": "high",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_MODEL": "xAI Grok/grok-4.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "xAI Grok/grok-4.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "xAI Grok/grok-4.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "xAI Grok/grok-4.5"
  },
  "enabledPlugins": {
    "frontend-design@claude-plugins-official": true,
    "github@claude-plugins-official": true,
    "code-review@claude-plugins-official": true,
    "superpowers@claude-plugins-official": true,
    "gopls-lsp@claude-plugins-official": true,
    "playwright@claude-plugins-official": true
  },
  "autoUpdatesChannel": "latest",
  "skipDangerousModePermissionPrompt": true,
  "apiKeyHelper": "\"C:\\Users\\zhang\\AppData\\Roaming\\claude-code-router\\bin\\ccr-claude-code-api-key-default-claude-code.cmd\""
}

说明：

• ANTHROPIC_BASE_URL 必须指向本机 CCR
• ANTHROPIC_AUTH_TOKEN 要和 CCR 里 Profile: Claude Code 的 key 一致

• ANTHROPIC_MODEL 现在使用的是 xAI Grok/grok-4.5
• apiKeyHelper 负责让 Claude Code 拿到 CCR 的本地 key

2. CCR 供应商配置

Grok申请地址：https://console.x.ai

现在 CCR 里这个 provider 的正确方向是：

• provider 名称：xAI Grok
• base URL：https://api.x.ai/v1
• model：grok-4.5
• capabilities 只保留：
  • openai_chat_completions
  • openai_responses

不要再让它走 anthropic_messages，否则 CCR 可能会把 Claude 的请求直发到不匹配的协议，重新出现：

• 400 All target providers failed
• 重复回复
• 非流式体验

四、当前最容易搞混的两个 key

1. CCR 本地 Profile key

你在 CCR 的“API 密钥”页面里看到的：

• Profile: Claude Code

这把 key 对应的是：

• ANTHROPIC_AUTH_TOKEN

它的作用是让 Claude Code 认证到 CCR，不是上游模型 key。

2. xAI 上游 API key

这是 CCR 用来访问 xAI 的真正模型密钥。

它应该配置在 CCR 的 provider 里，不应该写到 Claude Code 的 ANTHROPIC_AUTH_TOKEN 里。

---

五、如果界面不能操作

以后 UI 不能用时，直接改 CCR 的配置库，不要靠界面硬点。

位置：

C:\Users\zhang\AppData\Roaming\claude-code-router\config.sqlite

处理原则：

1. 先停 CCR
2. 备份 config.sqlite
3. 打开 config.sqlite
4. 找到 provider 的 capabilities
5. 去掉 anthropic_messages
6. 保留 openai_chat_completions 和 openai_responses
7. 重启 CCR

如果 UI 重新把 anthropic_messages 加回来，说明它重新探测了能力。那就继续按数据库方式修，不要反复依赖 UI。

---

六、验证方法

1. 检查 CCR 健康状态

http://127.0.0.1:3456/health

正常应返回 running。

2. 检查 Claude Code

进入 Claude Code 后确认：

• Model 显示为 xAI Grok/grok-4.5
• API Base URL 指向 http://127.0.0.1:3456

3. 观察 CCR 结果

正常情况下，CCR 应该把请求走到：

• openai_chat_completions

而不是：

• anthropic_messages

---

七、常见问题

1. 401 Invalid API key

优先检查：

• ANTHROPIC_AUTH_TOKEN 是否还是 Profile: Claude Code 那把 key
• apiKeyHelper 是否还在
• CCR 里的 profile key 有没有被重建

2. 400 All target providers failed

优先检查：

• provider 的 capabilities 是否还包含 anthropic_messages
• ANTHROPIC_MODEL 是否和 CCR 里的模型名一致

3. 回复不是流式，或者重复回复

优先检查：

• CCR 是否把请求发到了错误的协议分支
• capabilities 是否需要删掉 anthropic_messages

---

八、结论

这套配置现在的正确理解是：

• Claude Code 只负责连 CCR
• CCR 负责连 xAI
• Profile: Claude Code 的 key 只给 Claude Code 用
• anthropic_messages 这个能力不要保留

如果后面再出问题，先看 config.sqlite 里的 capabilities，不要先怀疑 Claude Code 本身。

https://github.com/musistudio/claude-code-router
https://console.x.ai
https://ccrdesk.top/configuration/routing/#claude-code

---

本文为 AI 工具链实战系列文章。