# Claude Code VS Code 扩展：安装与 Passion8 API Key 配置

> 安装 Anthropic 官方 Claude Code VS Code 扩展，在用户设置中配置 Passion8 Base URL、API Key 和模型，重载后使用项目上下文与 diff。

URL: https://docs.passion8.cc/docs/claude-code/vscode
Language: zh-CN
Publisher: Passion8
Last updated: 2026-10-11

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`，或打开 [官方市场条目](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code)。

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

```bash
code --install-extension anthropic.claude-code
```

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

## 2. 填写 Passion8 网关配置

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

```json title="VS Code User Settings"
{
  "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"
    }
  ]
}
```

| 字段 | 填写要求 |
| --- | --- |
| ANTHROPIC_BASE_URL | `https://passion8.cc`，不带 `/v1` |
| ANTHROPIC_AUTH_TOKEN | 完整 Passion8 API Key |
| ANTHROPIC_MODEL | 控制台向你的令牌开放的精确 Claude 模型 ID |

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

### 为什么不能只在终端 export

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

### 已使用 CC-Switch

可以继续用 [CC-Switch 管理 Claude Code](https://docs.passion8.cc/docs/claude-code/settings#用-cc-switch-配置推荐)。先启用 Passion8，再核对 VS Code 的上述变量与 CC-Switch 中的地址、Key 和模型一致。CC-Switch 管理 CLI 配置，不应假定每个版本都会同步 VS Code 的用户设置。

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

## 3. 重载并验证

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

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

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

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

## 4. 在编辑器里使用

| 操作 | 用法 |
| --- | --- |
| 带文件上下文提问 | 在提示中 `@` 引用文件，或选择代码后交给 Claude |
| 先讨论方案 | 使用计划模式，要求先列出涉及文件与验收条件 |
| 修改指定文件 | 明确文件范围，批准必要工具，再查看 inline diff |
| 验证改动 | 让它运行仓库已有的相关测试，检查结果与 diff |
| 并行处理其他任务 | 新建独立对话；涉及同一仓库时避免同时修改同一个文件 |
| 切换 Claude 模型 | 使用账号可用的 ID；若面板覆盖了模型选择，核对控制台实际请求 |

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

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

编辑器面板和集成终端不是同一个入口。要在终端运行 `claude` 命令，仍需要 [安装独立 CLI](https://docs.passion8.cc/docs/claude-code/install) 并完成 [CLI 配置](https://docs.passion8.cc/docs/claude-code/settings)。

## 扩展选择与账号问题

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

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

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

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

## 常见问题

| 现象 | 先检查 |
| --- | --- |
| 面板要求登录 | 是否在用户设置填写正确的数组；Key 是否可用；是否重载窗口 |
| `401` / 认证失败 | Key 完整性与旧凭据冲突；是否仍有过期的其他认证变量 |
| `404` / 路径错误 | Base URL 是否误加 `/v1` 或 `/messages` |
| 模型不支持 / 无权限 | 精确 ID、令牌权限与面板当前选择；不要只填写产品展示名 |
| CLI 正常、扩展失败 | 扩展的启动前认证检查需要 VS Code 用户设置；两个入口可能用不同 Key |
| 本机正常、SSH / 容器失败 | 在扩展实际运行环境里检查设置作用域和网关网络 |
| 改模型后仍显示旧请求 | 重载、新建会话并检查模型选择器、用户变量与共享 Claude 配置 |
| 点击云端入口需要别的权限 | 本文配置面向本机项目；云端和远程托管入口不由这个 Key 自动开通 |

## 接着看



- [Claude Code 完整配置](https://docs.passion8.cc/docs/claude-code/settings): CLI、CC-Switch 与各模型映射的详细配置。
- [Cline 多模型配置](https://docs.passion8.cc/docs/cline): 在 Cline 中使用 Claude 或切换到 GPT、Gemini、Grok。
- [Desktop、Web 与 IDE](https://docs.passion8.cc/docs/claude-code/desktop-web-ide): 不同入口的运行位置与配置边界。



## 官方参考

- [Use Claude Code in VS Code](https://code.claude.com/docs/en/vs-code)
- [LLM gateway — VS Code extension](https://code.claude.com/docs/en/llm-gateway-connect#vs-code-extension)