【VS Code】ccr code 一键直连 Claude Code，告别切窗

一、准备工作

1. 安装 Claude Code CLI

npm i -g @anthropic-ai/claude-code

2. 安装并启动 CCR（Claude Code Router）

npm i -g @musistudio/claude-code-router
ccr start

看到输出中出现类似 127.0.0.1:3456 即表示 CCR 本地服务已成功启动。

📌 CCR 就像一个“反向代理”：你只需告诉 Claude Code 请求走 CCR，CCR 决定后端怎么转发。

二、设置 CCR API Key

CCR 启动后需设置身份验证密钥。

1. 打开配置文件：

Windows:
%UserProfile%\.claude-code-router\config.json
macOS / Linux:
~/.claude-code-router/config.json

2. 配置 claude code 的APIKEY

在 CCR 的配置文件中找到 "APIKEY": "" 字段，并填写一个伪造的 API key（仅用于本地鉴权标识）。建议使用类似如下格式，便于识别：

"APIKEY": "sk-ant-local-ccr-1234567890"

🚨 注意：此处不是大模型的真实 API key，而是给 CCR 自定义设置的“访问令牌”。

3. 配置大模型的 API Key（通过 CCR UI）

开浏览器访问 CCR UI 控制台

ccr ui

在界面中添加你希望连接的大模型服务（如 OpenAI、Ollama、Claude API 等），并在对应的配置项中填写真实的模型 API Key。

三、通过环境变量将 Claude Code 重定向至 CCR

Claude Code 支持通过环境变量配置网关地址和鉴权 token。

📍 你需要设置两个变量：

ANTHROPIC_BASE_URL → http://127.0.0.1:3456
ANTHROPIC_AUTH_TOKEN → 刚设置的 APIKEY

✅ Windows 设置方法（永久）

在管理员权限的 PowerShell 执行：

setx ANTHROPIC_BASE_URL "http://127.0.0.1:3456"
setx ANTHROPIC_AUTH_TOKEN "sk-ant-local-ccr-1234567890"

# 当前窗口立即生效（可选）
$env:ANTHROPIC_BASE_URL="http://127.0.0.1:3456"
$env:ANTHROPIC_AUTH_TOKEN="sk-ant-local-ccr-1234567890"

查看是否配置成功：
powershell:

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

✅ macOS / Linux 设置方法（永久）

将以下命令添加到你的 shell 配置文件中：

echo 'export ANTHROPIC_BASE_URL="http://127.0.0.1:3456"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-ant-local-ccr-1234567890"' >> ~/.zshrc

source ~/.zshrc  # 立即生效

验证是否生效：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

四、验证 CCR 是否生效

确认 CCR 正在运行：
```
ccr start
```
新开一个 VS Code 终端（这样能继承你刚设置的环境变量）。

启动 Claude Code 并检查网关/鉴权：

claude
/status     # 查看当前 Base URL、鉴权来源、代理配置等
/doctor     # 运行系统诊断，核对“Anthropic Base URL”“Auth Token”是否生效

预期在 /status 输出中看到：

Anthropic Base URL: http://127.0.0.1:3456
Auth Token: ANTHROPIC_AUTH_TOKEN

五、集成 VS Code：实现 IDE 加持

✅ 正确打开方式

推荐方式：在 VS Code 集成终端中输入：
```
claude
```
如果看到状态栏出现「IDE」标识，表示已成功挂载。
若从外部终端启动 claude，请在 TUI 中输入 /ide 手动挂载 VS Code。

⚠️ 注意：

运行 ccr code 只会启动 CLI，不会自动挂载 IDE 扩展。请始终从 VS Code 终端启动。

🔧 一键修复 VS Code 命令缺失（Windows）

若在 Vs Code 中输入/ide没找到 Vs Code，可以尝试：

以下脚本可自动将 VS Code 的 code 命令添加至 PATH 并重启 VS Code：

# 1) 自动定位 code.cmd 的路径（常见安装位置）
$codePaths = @(
  "$env:LOCALAPPDATA\Programs\Microsoft VS Code\bin",
  "C:\Program Files\Microsoft VS Code\bin",
  "$env:USERPROFILE\AppData\Local\Programs\Microsoft VS Code\bin"
)
$codeBinPath = $codePaths | Where-Object { Test-Path $_ } | Select-Object -First 1
if (-not $codeBinPath) { Write-Host "❌ 未能在常见位置找到 VS Code 的 'bin' 目录。请手动添加到 PATH。"; return }
Write-Host "✅ 成功定位到 VS Code 'bin' 目录: $codeBinPath"

# 2) 添加到当前会话与用户永久 PATH（不覆盖原值）
$currentUserPath = [Environment]::GetEnvironmentVariable('PATH','User')
if ($currentUserPath -notlike "*$codeBinPath*") {
  $newUserPath = "$currentUserPath;$codeBinPath"
  [Environment]::SetEnvironmentVariable('PATH',$newUserPath,'User')
  $env:PATH = $newUserPath
  Write-Host "✅ 已将目录永久添加到用户 PATH。请重启 VS Code！"
} else {
  Write-Host "ℹ️ 目录已存在于 PATH 中，无需重复添加。"
}

# 3) 验证
where.exe code  # 应能输出 code.cmd 的路径

# 4) 彻底重启 VS Code（让新 PATH 被“集成终端”继承）
Start-Sleep -Seconds 1
taskkill /F /IM Code.exe 2>$null