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

---


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

---

## 一、实际链路

现在的工作链路是：

```text
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：

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

启动：

```bash
ccr start --no-open
```

查看 UI：

```bash
ccr ui
```

停止：

```bash
ccr stop
```

---

## 三、现在真正生效的配置

### 1. Claude Code 配置

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

```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 一致

![Pasted image 20260721194340.png](https://developer.qcloudimg.com/http-save/yehe-1184138/97472af00d9709dcfebcb5449a927e82.png)

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


### 2. CCR 供应商配置

Grok申请地址：https://console.x.ai
![Pasted image 20260721194745.png](https://developer.qcloudimg.com/http-save/yehe-1184138/ba730208e818dc3d18da655095811435.png)

现在 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`
- 重复回复
- 非流式体验

![Pasted image 20260721194430.png](https://developer.qcloudimg.com/http-save/yehe-1184138/0c91dcb645adc8b97d1b92036de9e746.png)
---

## 四、当前最容易搞混的两个 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 的配置库，不要靠界面硬点。

位置：

```text
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 健康状态

```text
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 工具链实战系列文章。*

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

Claude Code 接入 Grok-4.5

人工智能

开发工具

后端

详解ClaudeCode通过CCR接入xAIGrok-4.5的配置方法，包括安装启动、关键配置项、常见问题排查等实用指南，帮助开发者快速实现AI模型的无缝对接。

代码解释

数据库

路由

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Claude Code 接入 Grok-4.5-腾讯云开发者社区-腾讯云

Claude Code 接入 Grok-4.5

Claude Code 接入 Grok-4.5

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐