目录
一、VSCode安装（略过）
二、安装Claude Code插件
三、使用 nvm 安装 Node.js 20（推荐，可避免权限问题）
四、配置 npm 使用用户级全局目录（彻底告别 sudo）
五、安装 claude-code-router（无需 sudo）
六、伪造本地登录状态，绕过强制登录
七、正确配置 VS Code，连接本地路由
八、编辑 config.json 配置文件配置第三方api或者本地模型
一、VSCode安装（略过）
官网下载即可
二、安装Claude Code插件
三、使用 nvm 安装 Node.js 20（推荐，可避免权限问题）
# 1. 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 2. 重新加载 shell 配置
source ~/.bashrc
# 3. 安装 Node.js 20
nvm install 20
# 4. 设为默认版本
nvm alias default 20
# 5. 验证版本
node –version # 应显示 v20.x.x
四、配置 npm 使用用户级全局目录（彻底告别 sudo）
# 创建用户级全局安装目录
mkdir -p ~/.npm-global
# 配置 npm 使用该目录
npm config set prefix '~/.npm-global'
# 将目录添加到 PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
五、安装 claude-code-router（无需 sudo）
npm install -g @musistudio/claude-code-router
ccr –version
六、伪造本地登录状态，绕过强制登录
echo '{"hasCompletedOnboarding": true}' > ~/.claude/config.json
七、正确配置 VS Code，连接本地路由
确保 VS Code 的 Claude Code 插件不再试图连接 Anthropic 官方服务器，而是指向你本地的 ccr 服务。
#打开 VS Code 命令面板 (Ctrl+Shift+P)，输入 “Preferences: Open User Settings (JSON)” 并回车，打开用户的 settings.json 文件。
1.在文件末尾的大括号 {} 内，添加或修改以下 claude-code.environmentVariables 配置项。
{
"claude-code.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "http://127.0.0.1:3456" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "your-any-token" }
]
}
-
ANTHROPIC_BASE_URL: 必须指向 ccr 的本地地址和端口。
-
ANTHROPIC_AUTH_TOKEN: 这里的 value 可以填写任意字符串，因为真正的 API Key 验证会在 ccr 的配置文件中完成。
2.保存 settings.json，并完全重启 VS Code 以确保新配置生效
如果ccr运行成功还是需要登陆则： 退出 Claude Code CLI 的登录状态，输入下面命令
# 退出 Claude Code CLI 的登录状态
claude logout
# 清理插件可能残留的认证状态
rm -rf ~/.claude/.auth.json
八、编辑 config.json 配置文件配置第三方api或者本地模型
1. 定位配置文件
使用你喜欢的文本编辑器打开它：
vim ~/.claude-code-router/config.json
2. 理解配置结构
配置文件主要包含 Providers 和 Router 两个核心部分。这里以配置火山引擎为例：
# 配置多个模型情况
{
"LOG": false,
"Providers": [
{
"name": "volcengine",
"api_base_url": "https://ark.cn-beijing.volces.com/api/v3/chat/completions",# 火山引擎的api
"api_key": "你的火山引擎API Key", #你的api key
"models": [
"doubao-seed-2-0-code-preview-260215" #模型id
]
}
],
"Router": {
"default": "volcengine,doubao-seed-2-0-code-preview-260215",
"think": "volcengine,doubao-seed-2-0-code-preview-260215",
"background": "volcengine,doubao-seed-2-0-code-preview-260215",
"longContext": "volcengine,doubao-seed-2-0-code-preview-260215"
}
}
# 也可以仅配置一个模型
{
"LOG": false,
"Providers": [
{
"name": "volcengine",
"api_base_url": "https://ark.cn-beijing.volces.com/api/v3/chat/completions",# 火山引擎的api
"api_key": "你的火山引擎API Key", #你的api key
"models": [
"doubao-seed-2-0-code-preview-260215" #模型id
]
}
],
"Router": {
"default": "doubao-seed-2-0-code-preview-260215"
}
}
修改后启动。如果运行成功后仍然被强制登陆，则看上述红字部分
ccr ui #运行，并弹出浏览器
ccr status #查看状态
ccr stop # 停止
3. 配置项详解
-
Providers (服务商)：定义了你可以接入哪些AI服务。
-
name: 服务商自定义名称。
-
api_base_url: 该服务商的API地址。
-
api_key: 你的API密钥。
-
models: 该服务商下你可用的模型列表。
-
-
Router (路由规则)：核心配置，决定了不同场景下调用哪个服务商的哪个模型。配置格式为 "服务商名,模型名"，可用的场景包括：
-
default: 默认模型，用于绝大多数通用任务。
-
background: 后台任务模型，如自动补全、代码格式化。
-
think: 推理模型，用于复杂逻辑分析、规划模式。
-
longContext: 长上下文模型，用于处理超过 longContextThreshold 阈值（默认为60000 tokens）的对话。
-
webSearch: 用于处理需要联网搜索的任务。
-
image: 用于处理包含图像输入的任务。
-
