灵眸文档
工具配置

Claude Code 插件(VS Code / Cursor / Trae / Antigravity)

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

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

同样适用于 Cursor / Trae / Antigravity 等编辑器

只要是基于 VS Code 内核的编辑器(Cursor、Trae、Antigravity 等),都可以在内置扩展商店里搜索同一个 Claude Code for VS Code 插件进行安装与配置,步骤与 VS Code 完全一致。

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


下载并安装 VS Code

用 Cursor / Trae / Antigravity?

它们是独立编辑器,请到各自官网下载对应安装包(不是 VS Code),装好后直接跳到下一节 安装插件 —— 插件市场与安装步骤和 VS Code 一致。

到官网 code.visualstudio.comDownload 按钮,网站会自动识别你的系统。也可以直接用下面的官方直链(不含版本号、始终指向最新稳定版,无需先进官网):

下载Windows 用户安装版(x64) —— 免管理员权限、装到当前用户目录,官方推荐。ARM 设备用 ARM64 版

安装

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

下载macOS Universal 版 —— 同一个包同时支持 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 . 打开当前目录

按发行版选择:

  • Debian / Ubuntu:下载 .deb 包,然后 sudo apt install ./code_*.deb
  • RHEL / Fedora / openSUSE:下载 .rpm 包,然后 sudo rpm -i code-*.rpm(或 sudo dnf install code-*.rpm

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

官网或下载很慢?

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


安装插件

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

Cursor / Trae / Antigravity 的提示

部分 VS Code 衍生编辑器使用的是私有扩展商店(如 Open VSX),如果搜不到 Claude Code for VS Code

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

配置灵眸 API

如果你已配置过 Claude Code CLI,可直接跳过本节

插件读取的是 ~/.claude/settings.json,与 CLI 完全一致。你在 Claude Code CLI 配置 中写好的密钥与 Base URL,插件会自动复用,无需任何额外操作。

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

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

mkdir -p ~/.claude && touch ~/.claude/settings.json
mkdir "$env:USERPROFILE\.claude" -Force
New-Item "$env:USERPROFILE\.claude\settings.json" -Force

写入以下内容(将密钥替换为你的):

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

详细说明(含国产模型默认设置、effortLevel 调节等)请参考 Claude Code CLI 配置所有配置项通用


启动插件

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

一套配置,处处可用

  • 在终端运行 claude → 使用 Claude Code CLI
  • VS Code / Cursor / Trae / Antigravity 侧边栏点击 Claude 图标 → 使用插件

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


常见问题

插件提示 401 / Unauthorized

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

想用国产模型 / 切换默认模型

settings.json 中加上 "model": "qwen3.8-max-preview" 即可,CLI 与所有 VS Code 系编辑器都会自动使用该模型。可用模型列表见 模型广场

Cursor / Trae / Antigravity 内搜不到插件

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

插件 vs CLI 选哪个?

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

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

最后更新:

On this page