↓ 跳过正文
她笑中藏泪花
她笑中藏泪花

首页 / 文章

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

VS Code CCR 与 ccr code 实战：手把手配置 Claude Code Router，在 ccr ui 填写 API Key，设置 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN，教你在 VS Code 内启动 claude，避坑要点齐备。点击阅读，立即上手。

她笑中藏泪花·
··428 字·3 分钟
AI大模型工具 资源分享 AI大模型工具

一、准备工作
#

1. 安装 Claude Code CLI
#

1

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

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

1
2

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

看到输出中出现类似 [redacted-ip]: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（仅用于本地鉴权标识）。建议使用类似如下格式，便于识别：

1

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

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

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

开浏览器访问 CCR UI 控制台

1

ccr ui

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

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

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

📍 你需要设置两个变量：
#

  • ANTHROPIC_BASE_URL → http://[redacted-ip]:3456
  • ANTHROPIC_AUTH_TOKEN → 刚设置的 APIKEY

✅ Windows 设置方法（永久）
#

在管理员权限的 PowerShell 执行：

1
2
3
4
5
6

setx ANTHROPIC_BASE_URL "http://[redacted-ip]:3456"
setx ANTHROPIC_AUTH_TOKEN "sk-ant-local-ccr-1234567890"

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

查看是否配置成功： powershell:

1
2

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

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

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

1
2
3
4

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

source ~/.zshrc  # 立即生效

验证是否生效：

1
2

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

四、验证 CCR 是否生效
#

  1. 确认 CCR 正在运行：

    1

    ccr start

  2. 新开一个 VS Code 终端（这样能继承你刚设置的环境变量）。

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

    1
2
3

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

    预期在 /status 输出中看到：

    1
2

    Anthropic Base URL: http://[redacted-ip]:3456
Auth Token: ANTHROPIC_AUTH_TOKEN

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

✅ 正确打开方式
#

  • 推荐方式：在 VS Code 集成终端中输入：

    1

    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
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

# 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

相关工具

工具箱延伸阅读

相关文章