在 VS Code 里使用

安装 Claude Code 插件，与 CLI 共用 ~/.claude/settings.json，并处理首次的登录页提示。

VS Code 里的 Claude Code 插件（扩展名 Claude Code，扩展 ID anthropic.claude-code）把 Claude Code 做进了编辑器面板。它和命令行版共用同一份 ~/.claude/settings.json，所以配置一次两处都能用。

安装

在 VS Code 扩展面板搜索 “Claude Code”（发布者 Anthropic）安装。
命令行等价写法：code --install-extension anthropic.claude-code。
安装后重载窗口：命令面板（⌘⇧P / Ctrl⇧P）执行 Developer: Reload Window。

配置

与在 Claude Code 里使用完全一致——写 ~/.claude/settings.json 的 env 块：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://<your-base-url>",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}

ANTHROPIC_BASE_URL 只到域名（不要带 /v1），ANTHROPIC_AUTH_TOKEN 填本站密钥。控制台「快速接入」弹窗选「VS Code 插件」可以下载一份已填好这些值的脚本。

打开面板仍显示登录页

使用本站密钥时不需要登录 claude.ai：

VS Code 设置（⌘, / Ctrl+,）→ 搜索 “Claude Code login” → 勾选 Disable Login Prompt。
若仍提示未登录，通常是 VS Code 没继承 shell 环境变量：从终端用 code . 启动 VS Code 即可继承；或者直接按上面的方式写 settings.json（不依赖环境变量）。

第三方网关下不可用的功能

依赖 claude.ai 账号的功能不生效：用量统计、语音输入、云端会话（Web 面板）。代码编辑、diff 审阅、内置 IDE MCP 等本地能力不受影响。

常见问题

现象	原因与处理
401	密钥错误或被停用；确认写在 `ANTHROPIC_AUTH_TOKEN`
404	`ANTHROPIC_BASE_URL` 带了 `/v1`，去掉路径
装了插件但没有 Spark 图标	需要先打开一个文件才会在编辑器工具栏出现；也可以从左侧活动栏的图标进入
改了配置不生效	重载窗口（`Developer: Reload Window`）后重开面板

在 Cursor 里也能装这个插件（Cursor 兼容 VS Code 扩展市场），做法相同，见在 Cursor 里使用。