Claude Code VS Code 扩展

Claude Code 官方 VS Code 扩展提供图形化对话、文件引用、计划审阅和编辑器 diff。本站使用网关 API Key：准备 Passion8 地址、Key 和可用 Claude 模型 ID，配置后重载窗口即可开始。扩展内置运行对话面板所需的 Claude Code，不需要先装独立 CLI。

#1. 安装官方扩展

VS Code 需为官方支持版本，当前官方说明要求 1.94.0 或更高。在扩展面板搜索 Claude Code，核对发布者 Anthropic 和扩展 ID anthropic.claude-code，或打开 官方市场条目。

如果已经配置 code 命令，也可以用终端安装：

code --install-extension anthropic.claude-code

打开项目文件夹，再打开 Claude Code 面板。Cursor 等兼容编辑器可按官方扩展支持情况安装同一扩展。

#2. 填写 Passion8 网关配置

打开命令面板，执行 Preferences: Open User Settings (JSON)。把下面字段合并进现有用户设置，保留其他设置；claudeCode.environmentVariables 必须是 {name, value} 对象组成的数组。

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://passion8.cc"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-your-Passion8-API-Key"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "claude-sonnet-5-5"
    }
  ]
}

示例使用 claude-sonnet-5-5，是否可用以控制台为准。用户设置里存有 Key，不要把这段放进仓库共享的 .vscode/settings.json 或公开同步。

#为什么不能只在终端 export

从 Dock 或开始菜单启动的编辑器通常不会继承某个终端会话里的环境变量。当前扩展还会在启动 Claude 进程前检查认证：~/.claude/settings.json 的 env 会传给子进程，但不一定通过扩展自己的登录检查。因此官方网关文档明确建议在 VS Code 用户设置中配置这些变量。

#已使用 CC-Switch

可以继续用 CC-Switch 管理 Claude Code。先启用 Passion8，再核对 VS Code 的上述变量与 CC-Switch 中的地址、Key 和模型一致。CC-Switch 管理 CLI 配置，不应假定每个版本都会同步 VS Code 的用户设置。

切换 Provider 或更新 Key 后，同时检查显式填写在 VS Code 里的值，避免 CLI 和面板分别使用不同配置。

#3. 重载并验证

保存用户设置后执行 Developer: Reload Window，重新打开 Claude Code，新建会话，然后发送：

用一句话回复“连接成功”。不要读取文件、修改文件或执行命令。

正常返回后，在 Passion8 控制台核对同一时间的请求、模型和用量。接着让它只读取一个文件并解释用途，确认编辑器上下文与文件工具可用。

如果面板仍出现登录提示，先核对变量确实保存到正在使用的用户配置，再重载窗口。扩展还提供 claudeCode.disableLoginPrompt 设置，可在已有网关认证配置正确时设为 true；它只跳过提示，不能代替有效 Key。

#4. 在编辑器里使用

可以用下面这条提示开始：

阅读我选中的代码，找出一个边界条件问题。先说明方案，只修改这个文件，运行已有的相关测试，最后给出修改摘要。

编辑器面板和集成终端不是同一个入口。要在终端运行 claude 命令，仍需要 安装独立 CLI 并完成 CLI 配置。

#扩展选择与账号问题

#用官方扩展需要注册 Anthropic 账号吗？

本文使用 Passion8 地址、API Key 和可用 Claude 模型配置本地项目，无需 Anthropic OAuth。保存用户设置后重载窗口即可验证请求；云端托管入口的权限与本地配置分开。

#官方 Claude 扩展和 Cline 怎么选？

只使用 Claude，并希望保留官方的计划审阅与编辑器 diff 体验，可以用本页的官方扩展。要在同一个面板切换 Claude、GPT、Gemini、Grok，可以用 Cline。两者配置位置不同，不应直接互相复制设置文件。

#常见问题

#接着看

#官方参考

• Use Claude Code in VS Code
• LLM gateway — VS Code extension