引言
Claude Code 插件在 2.0 更新后引入了强制登录验证,阻止用户在未登录情况下使用本地路由进行模型调用。
本教程将带你一步步绕过该登录校验机制,并通过 Claude Code Router (CCR) 将 Claude 插件接入任意你选择的大模型服务。
安装 Claude 插件与 CLI 工具
1. 安装 VS Code 与插件
请先确保你已安装好 Visual Studio Code。
然后,打开 VS Code 左侧的扩展(Extensions)面板,搜索Claude Code for Vs Code
并安装
2. 安装 Claude CLI
打开终端,执行以下命令:
npm i -g @anthropic-ai/claude-code
⚠️ 如遇权限问题,建议使用管理员权限终端或在命令前加 sudo
(macOS/Linux)。
绕过 Claude 登录验证
插件的登录校验只检查本地的一个配置文件。我们可以通过伪造该配置,让插件认为你已登录。
步骤如下:
在以下路径新建一个名为 config.json
的文件:
- Windows:
%UserProfile%\.claude\
- macOS / Linux:
~/.claude/
填入以下内容:
{
"primaryApiKey": "any-string-is-ok-here"
}
📌 任意字符串都可,例如 "hello-claude"
,该字段仅用于通过插件的本地状态校验。
完成后请重启 VS Code,此时插件将不再强制要求登录。
安装并配置 Claude Code Router (CCR)
CCR 是本地路由工具,用于把 Claude 插件请求转发至任意你配置的大模型服务。
1. 安装 CCR
在终端中执行以下命令安装 CCR:
npm install -g @musistudio/claude-code-router
2. 初始化 CCR 配置
首先,在终端运行 ccr start
来自动生成默认配置文件:
ccr start
当看到服务启动的日志信息后,按 Ctrl+C
将其停止。此步骤的主要目的是创建配置文件。
现在,请根据你的操作系统,找到并用文本编辑器打开生成的 config.json
文件:
操作系统 | 配置文件路径 |
---|---|
Windows | %UserProfile%\.claude-code-router\config.json |
macOS/Linux | ~/.claude-code-router/config.json |
打开并编辑该文件,在 "APIKEY"
字段中填入一个自定义密钥,建议使用类似如下格式,便于识别:
{
"APIKEY": "sk-ant-local-ccr-1234567890"
}
4. 在ui界面中添加模型服务
运行以下命令打开 CCR 管理界面:
ccr ui
浏览器将自动打开一个页面。点击页面中的 “新增服务” 按钮,配置你想使用的大模型及其真实 API Key。
详细示例:如果你不确定如何填写特定模型(如 OpenAI、Gemini、通义千问等)的配置,可以参考这篇博文:《Claude Code Router:一键直连五大模型》。
将 Claude 插件指向 CCR
我们需要告诉 Claude 插件:不要访问官方 API,而是连接我们本地 CCR 路由服务。
你可以选择以下任一方法:
方法一:手动设置系统环境变量
✅ 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"
查看是否配置成功:
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
移除环境变量:
$env:ANTHROPIC_API_KEY = $null
$env:ANTHROPIC_BASE_URL = $null
$env:ANTHROPIC_AUTH_TOKEN = $null
✅ macOS / Linux(Zsh 用户):
将以下命令添加到你的 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
移除环境变量:
sed -i.bak '/export ANTHROPIC_BASE_URL=/d' ~/.zshrc
sed -i.bak '/export ANTHROPIC_AUTH_TOKEN=/d' ~/.zshrc
sed -i.bak '/export ANTHROPIC_API_KEY=/d' ~/.zshrc
方法二:修改插件本地配置文件
Claude 插件支持从本地读取 setting.json
配置环境变量:
操作系统 | 文件路径 |
---|---|
Windows | %UserProfile%\.claude\setting.json |
macOS/Linux | ~/.claude/setting.json |
添加以下内容:
{
"env": {
"ANTHROPIC_BASE_URL": "http://127.0.0.1:3456",
"ANTHROPIC_API_KEY": "sk-ant-local-ccr-1234567890"
}
}
该方法相当于让 Claude Code 传入环境变量给你的电脑。输入查看环境变量是否生效的指令同样有输出结果。