Claude Code VSCode 插件配置教程
这篇教程说明如何在 VSCode 里使用 Claude Code 插件并接到 HRouter。插件复用本机 Claude Code 的配置，所以要先在命令行里配好，再补一个 config.json 让编辑器集成识别。
前提：已经按 Claude Code 安装与配置 完成命令行配置，并确认在终端里直接运行 claude 没有问题。也可以先用 HRouter Desktop 一键写入配置。
第 1 步：安装 VSCode
打开 https://code.visualstudio.com/，安装 VSCode 1.75.2 或更新版本。
第 2 步：安装 Claude Code 扩展
打开 VSCode 扩展市场，搜索 Claude Code，安装后重启 VSCode。
第 3 步：创建 .claude/config.json
打开你的 .claude 目录：
| 系统 | 目录 |
|---|---|
| Windows | C:\Users\你的用户名\.claude |
| Mac / Linux | ~/.claude |
创建或编辑 config.json，写入：
{
"primaryApiKey": "hrouter"
}
这里的值不需要填写真实密钥，只要这个字段存在即可。
注意这个文件是 config.json，不是 settings.json。 两个文件分工不同：
| 文件 | 作用 |
|---|---|
config.json |
让编辑器集成识别到已经配置了第三方 Key |
settings.json |
配置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，由 CLI 读取 |
第 4 步：开始使用
- 打开任意项目目录。
- 在 VSCode 中启动 Claude Code 扩展。
- 先发送一个最短测试消息：
如果你已经接到 HRouter，请只回复：HRouter Claude 已连接
收到回复，并且在 使用记录 里能看到请求，就接好了。
常见问题
扩展打开后没有响应？
先回到终端确认 claude 命令本身正常。终端里不通，插件里一定不通，先按 Claude Code 常见问题 排查。
改了 config.json 没效果？ 完全退出 VSCode 再重新打开，而不是只重新加载窗口。
搞混了 config.json 和 settings.json？ 前者给编辑器集成识别，后者给 CLI 配置网关和 Key，两个都需要。
模型请求失败？ 确认模型在当前 Key 的实时模型列表中，见 model_not_found。
配置似乎被忽略？ 见 配置不生效怎么排查。