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.com 点 Download 按钮,网站会自动识别你的系统。也可以直接用下面的官方直链(不含版本号、始终指向最新稳定版,无需先进官网):
下载:Windows 用户安装版(x64) —— 免管理员权限、装到当前用户目录,官方推荐。ARM 设备用 ARM64 版。
安装:
- 双击下载好的
VSCodeUserSetup-*.exe - 一路「下一步」,到「选择附加任务」时勾选:
- 「添加到 PATH」(默认已勾,保留)—— 让终端能用
code命令 - 「将 Code 注册为受支持文件类型的编辑器」
- 「添加『通过 Code 打开』操作到资源管理器右键菜单」(可选,方便)
- 「添加到 PATH」(默认已勾,保留)—— 让终端能用
- 完成后启动 VS Code
下载:macOS Universal 版 —— 同一个包同时支持 Apple 芯片与 Intel 芯片。
安装:
- 下载得到
VSCode-darwin-universal.zip,双击解压 - 把解压出的 Visual Studio Code.app 拖进「访达」的应用程序文件夹
- 从启动台打开 VS Code
- (推荐)按
Cmd+Shift+P打开命令面板,运行 Shell Command: Install 'code' command in PATH,之后终端即可用code .打开当前目录
官网或下载很慢?
安装包有一两百 MB,浏览器单线程拉取时在国内偶尔较慢。把上面的官方直链复制到支持多线程的下载工具里下载通常快很多 —— 这些直链不含版本号,始终指向最新稳定版。
安装插件
- 打开 VS Code(或 Cursor / Trae / Antigravity),进入扩展面板(快捷键
Cmd+Shift+X/Ctrl+Shift+X) - 搜索
Claude Code for VS Code,认准 Anthropic 官方发布 - 点击 Install 安装,安装完成后会在侧边栏出现 Claude 图标
Cursor / Trae / Antigravity 的提示
部分 VS Code 衍生编辑器使用的是私有扩展商店(如 Open VSX),如果搜不到 Claude Code for VS Code:
- 进入 VS Code 官方扩展市场页面下载
.vsix安装包 - 在编辑器扩展面板右上角
…菜单选择 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.jsonmkdir "$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 配置,所有配置项通用。
启动插件
- 在编辑器中按
Cmd+Shift+P/Ctrl+Shift+P打开命令面板 - 输入
Claude Code: Open或直接点击侧边栏 Claude 图标 - 在打开的对话面板中即可与 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,更灵活
两者没有功能优劣之分,按习惯选即可。
最后更新:
开通灵眸 API,立即用上 Claude / Codex 等主流 AI 工具
零门槛注册、套餐灵活、国内直连。支持 Claude Code、Codex CLI、Cursor、VS Code 插件、OpenCode、Cherry Studio 等工具接入。
前往注册