引言

Claude Code 插件在 2.0 更新后引入了强制登录验证，阻止用户在未登录情况下使用本地路由进行模型调用。

本教程将带你一步步绕过该登录校验机制，并通过 Claude Code Router (CCR) 将 Claude 插件接入任意你选择的大模型服务。

安装 Claude 插件与 CLI 工具

安装 VS Code 与插件

请先确保你已安装好 Visual Studio Code。博文： 【VS Code】告别安装与配置困难：新手保姆级指南
然后，打开 VS Code 左侧的扩展（Extensions）面板，搜索Claude Code for Vs Code并安装

绕过 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 路由服务。

提示：Claude Code 支持通过 VS Code 设置或 ~/.claude/settings.json 注入环境变量，两种方式等效，可按习惯任选其一。

方法一：在 VS Code 中配置插件环境变量

打开 VS Code → 设置（Settings）→ 搜索 “Claude Code: Environment Variables”，按下图添加条目。保存后重载窗口生效。

插件设置

在settingsjson中编辑

给extension加上环境变量，里面要有ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY：

{
  "claudeCode.selectedModel": "glm-4.5",
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "http://127.0.0.1:3456" },
    { "name": "ANTHROPIC_API_KEY", "value": "sk-ant-local-ccr-1234567890" }
  ]
}

方法二：更改 .claude 下的 settings.json

打开下列文件：

操作系统文件路径
Windows%UserProfile%\.claude\settings.json
macOS/Linux~/.claude/settings.json

添加以下内容：

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3456",
    "ANTHROPIC_AUTH_TOKEN": "sk-ant-local-ccr-1234567890"
  }
}
"ANTHROPIC_AUTH_TOKEN"也可以换成"ANTHROPIC_API_KEY"二者选一个即可。

若您觉得本博文做的还不错，欢迎支持她笑中藏泪花 | 爱发电

最后修改：2025 年 11 月 11 日
© 允许规范转载
如果您觉得本文还不错，欢迎打赏支持