# Claude Code 插件（VS Code / Cursor / Trae / Antigravity）

> 从下载 VS Code 到安装 Claude Code 插件、接入灵眸 API 的完整图文教程，与 CLI 共享同一套 settings.json。

URL: https://docs.lmuai.ai/cn/docs/tools/claude-code-vscode



VS Code 官方插件 **Claude Code for VS Code** 让你在编辑器侧边栏直接使用 Claude Code，不必切换到终端。它和 Claude Code CLI **共享同一个配置文件**，CLI 配过的密钥 / Base URL 插件直接生效，无需重复设置。

<Callout type="info" title="同样适用于 Cursor / Trae / Antigravity 等编辑器">
  只要是基于 VS Code 内核的编辑器（**Cursor、Trae、Antigravity** 等），都可以**在内置扩展商店里搜索同一个 `Claude Code for VS Code` 插件**进行安装与配置，步骤与 VS Code 完全一致。

  本页所有截图与命令均以 VS Code 为例，Cursor / Trae / Antigravity 用户照搬即可。
</Callout>

***

## 下载并安装 VS Code [#下载并安装-vs-code]

<Callout type="info" title="用 Cursor / Trae / Antigravity？">
  它们是独立编辑器，请到各自官网下载对应安装包（不是 VS Code），装好后直接跳到下一节 [安装插件](#安装插件) —— 插件市场与安装步骤和 VS Code 一致。
</Callout>

到官网 [code.visualstudio.com](https://code.visualstudio.com/) 点 **Download** 按钮，网站会自动识别你的系统。也可以直接用下面的官方直链（不含版本号、始终指向最新稳定版，无需先进官网）：

<Tabs items="['Windows', 'macOS', 'Linux']">
  <Tab value="Windows">
    **下载**：[Windows 用户安装版（x64）](https://update.code.visualstudio.com/latest/win32-x64-user/stable) —— 免管理员权限、装到当前用户目录，官方推荐。ARM 设备用 [ARM64 版](https://update.code.visualstudio.com/latest/win32-arm64-user/stable)。

    **安装**：

    1. 双击下载好的 `VSCodeUserSetup-*.exe`
    2. 一路「下一步」，到「选择附加任务」时**勾选**：
       * 「添加到 PATH」（默认已勾，保留）—— 让终端能用 `code` 命令
       * 「将 Code 注册为受支持文件类型的编辑器」
       * 「添加『通过 Code 打开』操作到资源管理器右键菜单」（可选，方便）
    3. 完成后启动 VS Code
  </Tab>

  <Tab value="macOS">
    **下载**：[macOS Universal 版](https://update.code.visualstudio.com/latest/darwin-universal/stable) —— 同一个包同时支持 Apple 芯片与 Intel 芯片。

    **安装**：

    1. 下载得到 `VSCode-darwin-universal.zip`，双击解压
    2. 把解压出的 **Visual Studio Code.app** 拖进「访达」的**应用程序**文件夹
    3. 从启动台打开 VS Code
    4. （推荐）按 `Cmd+Shift+P` 打开命令面板，运行 **Shell Command: Install 'code' command in PATH**，之后终端即可用 `code .` 打开当前目录
  </Tab>

  <Tab value="Linux">
    按发行版选择：

    * **Debian / Ubuntu**：下载 [.deb 包](https://update.code.visualstudio.com/latest/linux-deb-x64/stable)，然后 `sudo apt install ./code_*.deb`
    * **RHEL / Fedora / openSUSE**：下载 [.rpm 包](https://update.code.visualstudio.com/latest/linux-rpm-x64/stable)，然后 `sudo rpm -i code-*.rpm`（或 `sudo dnf install code-*.rpm`）

    `.deb` / `.rpm` 安装后会自动把 `code` 加入 PATH，并接入系统的软件更新。装好后在终端运行 `code` 或从应用菜单启动。
  </Tab>
</Tabs>

<Callout type="info" title="官网或下载很慢？">
  安装包有一两百 MB，浏览器单线程拉取时在国内偶尔较慢。把上面的**官方直链**复制到支持多线程的下载工具里下载通常快很多 —— 这些直链不含版本号，始终指向最新稳定版。
</Callout>

***

## 安装插件 [#安装插件]

1. 打开 VS Code（或 Cursor / Trae / Antigravity），进入扩展面板（快捷键 `Cmd+Shift+X` / `Ctrl+Shift+X`）
2. 搜索 &#x2A;*`Claude Code for VS Code`**，认准 Anthropic 官方发布
3. 点击 **Install** 安装，安装完成后会在侧边栏出现 Claude 图标

<Callout type="warn" title="Cursor / Trae / Antigravity 的提示">
  部分 VS Code 衍生编辑器使用的是私有扩展商店（如 Open VSX），如果搜不到 `Claude Code for VS Code`：

  1. 进入 VS Code 官方扩展市场页面下载 `.vsix` 安装包
  2. 在编辑器扩展面板右上角 `…` 菜单选择 **Install from VSIX**
</Callout>

***

## 配置灵眸 API [#配置灵眸-api]

<Callout type="info" title="如果你已配置过 Claude Code CLI，可直接跳过本节">
  插件读取的是 `~/.claude/settings.json`，与 CLI 完全一致。&#x2A;*你在 [Claude Code CLI 配置](./claude-code) 中写好的密钥与 Base URL，插件会自动复用，无需任何额外操作。**

  这也意味着：**VS Code、Cursor、Trae、Antigravity 之间也共享同一份配置** —— 在任一编辑器里改一次，其它编辑器与 CLI 全部生效。
</Callout>

如果是首次配置，按以下步骤创建配置文件：

<Tabs items="['Mac/Linux', 'Windows']">
  <Tab value="Mac/Linux">
    ```bash
    mkdir -p ~/.claude && touch ~/.claude/settings.json
    ```
  </Tab>

  <Tab value="Windows">
    ```powershell
    mkdir "$env:USERPROFILE\.claude" -Force
    New-Item "$env:USERPROFILE\.claude\settings.json" -Force
    ```
  </Tab>
</Tabs>

写入以下内容（将密钥替换为你的）：

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.lmuai.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的灵眸API密钥",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}
```

详细说明（含国产模型默认设置、`effortLevel` 调节等）请参考 [Claude Code CLI 配置](./claude-code)，**所有配置项通用**。

***

## 启动插件 [#启动插件]

1. 在编辑器中按 `Cmd+Shift+P` / `Ctrl+Shift+P` 打开命令面板
2. 输入 &#x2A;*`Claude Code: Open`** 或直接点击侧边栏 Claude 图标
3. 在打开的对话面板中即可与 Claude Code 对话、生成代码、自动改文件

<Callout type="info" title="一套配置，处处可用">
  * 在终端运行 `claude` → 使用 Claude Code CLI
  * 在 **VS Code / Cursor / Trae / Antigravity** 侧边栏点击 Claude 图标 → 使用插件

  **它们读取的是同一个 `~/.claude/settings.json`**，密钥、Base URL、模型、超时设置一处修改全部生效。
</Callout>

***

## 常见问题 [#常见问题]

### 插件提示 401 / Unauthorized [#插件提示-401--unauthorized]

跟 CLI 排查思路一致 —— 大多是 Shell 环境变量 `ANTHROPIC_BASE_URL` / `ANTHROPIC_API_KEY` 覆盖了 `settings.json`。请参考 [Claude Code CLI 配置 → 常见问题](./claude-code#常见问题) 排查。

### 想用国产模型 / 切换默认模型 [#想用国产模型--切换默认模型]

在 `settings.json` 中加上 `"model": "qwen3.8-max-preview"` 即可，CLI 与所有 VS Code 系编辑器都会自动使用该模型。可用模型列表见 [模型广场](../guide/models)。

### Cursor / Trae / Antigravity 内搜不到插件 [#cursor--trae--antigravity-内搜不到插件]

参考上文「Cursor / Trae / Antigravity 的提示」用 VSIX 离线安装即可。

### 插件 vs CLI 选哪个？ [#插件-vs-cli-选哪个]

* 习惯在编辑器内编码 → 用插件，所有上下文都在编辑器里
* 跨编辑器使用、写脚本、批量任务 → 用 CLI，更灵活

两者**没有功能优劣之分**，按习惯选即可。