VS Code与IDEA集成Claude Code的实践指南

作者：袖梨 2026-08-19

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“VS Code与IDEA集成Claude Code的实践指南”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际使用顺序，把思路、关键写法和容易踩坑的地方讲清楚，方便你直接对照操作。

实际处理时，这里主要介绍如何在 VS Code 和 IDEA 中集成 Claude Code，借助智谱 AI 的 GLM 模型提供 AI 辅助编码能力。

Visual Studio Code 效果展示

IntelliJ IDEA 效果展示

一、环境准备

1.1 安装 Node.js

前往 Node.js 官网下载安装：（链接已移除）

VS Code 插件模式：可以不单独安装 Node.js，VS Code 会自动采用内置版本
IDEA 模式：需安装 Node.js，要求版本 ≥ Node.js 18

两种安装方式：

方式	说明
Windows Installer (.msi)	直接安装，适合大多数用户
Standalone Binary (.zip)	采用 NVM 管理时下载此版本

注意事项：

要求版本 ≥ Node.js 18
cmd 命令查看版本：node --version

1.2 安装 NVM（建议）

理解这一步时，建议采用 NVM 管理 Node.js 环境，可根据需切换 Node.js 版本。
可以查看这篇文章：采用 nvm 安装与管理多版本 Node.js（Windows）

下载 NVM 安装包 nvm-setup.7z
将下载的 Node.js 包放在 NVM 目录下

1.3 常用 NVM 命令

命令	说明
`nvm -v`	查看 nvm 版本
`nvm list available`	查看可安装的 Node.js 版本
`nvm list`	查看已安装的版本
`nvm install <版本号>`	安装指定版本
`nvm use <版本号>`	切换到指定版本
`nvm uninstall <版本号>`	卸载指定版本
`nvm current`	查看当前采用的版本

二、智谱 AI 平台准备

2.1 API Key 拿到

登录智谱 AI 开放平台（（链接已移除）），进入 API Key 管理页面，新建或拿到 API Key。

API Key 格式为 {API Key ID}.{secret}，请妥善保管。

2.2 查看套餐信息

三、安装 Claude Code

3.1 安装 Claude Code CLI

npm i -g @anthropic-ai/claude-code@latest

也可以采用接下来的命令：

npm install -g @anthropic-ai/claude-code --registry https://registry.npmjs.org/

3.2 启动 Claude

安装完成后执行 claude 命令，出现欢迎界面表示安装成功：

查看版本：
claude -v
启动客户端：
claude

说明：IDEA 模式下必须安装 CLI；VS Code 插件模式下可跳过此步。

四、VS Code 集成

4.1 安装 VS Code

官网下载：（链接已移除）

要求版本 ≥ 1.98.0结合项目来看，（低于此版本借助 Help → Check for Updates 升级）。

4.2 安装 Claude Code 插件

打开 VS Code
进入扩展商店（Ctrl+Shift+X）
搜索 “Claude Code for VS Code”
点击 Install 安装

4.3 设置 Claude Code

打开 VS Code 的 settings.json 文件，添加以下设置：

路径：Users > 当前用户 > AppData > Roaming > Code > User > settings.json
快捷方式：Ctrl+Shift+P → 输入 Preferences: Open User Settings (JSON)

// === Claude Code 配置 ===
// 代理设置（如能正常访问外网可省略）
"http.proxy": "<你的代理>",
// Claude Code 面板位置
"claudeCode.preferredLocation": "panel",
// Claude Code 环境变量
"claudeCode.environmentVariables": [
    {
        "name": "ANTHROPIC_BASE_URL",
        "value": "https://open.bigmodel.cn/api/anthropic"
    },
    {
        "name": "ANTHROPIC_AUTH_TOKEN",
        "value": "<你的智谱API Key>"
    },
    {
        "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
        "value": "glm-5-turbo"
    },
    {
        "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
        "value": "glm-5-turbo"
    },
    {
        "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
        "value": "glm-4.5-air"
    }
],
// 禁用登录提示
"claudeCode.disableLoginPrompt": true,
// 默认使用模型
"claudeCode.selectedModel": "glm-5-turbo"

也可以C盘 > Users > 当前用户 > .claude > settings.json的文件，添加以下设置：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "<你的智谱API Key>",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5-turbo",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5-turbo",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "enabledPlugins": {
    "document-skills@anthropic-agent-skills": true,
    "example-skills@anthropic-agent-skills": true
  },
  "theme": "dark",
  "disableLoginPrompt": true,
  "selectedModel": "glm-5-turbo",
  "preferredLocation": "panel",
  "claud.code.experimental.enableInlineCompletion": true,
  "claud.code.experimental.enableChat": true
}

在这个场景下，若两个地方的文件均进行了设置，优先采用.claude目录下的设置文件。

4.4 代理设置（如需）

若 VS Code 无法正常访问外网，需设置系统代理。

右键 此电脑 → 属性 → 高级系统设置 → 环境变量，在系统变量中添加：

变量名	值
HTTP_PROXY	<你的代理>
HTTPS_PROXY	<你的代理>

注意：如果不在环境变量加HTTPS_PROXY和HTTP_PROXY使用Claude的方法也可以在settings.json里的"env"加上：

    "HTTP_PROXY": "<你的代理>",
    "HTTPS_PROXY": "<你的代理>"`

4.5 启动采用

实际处理时，安装设置完成后，在 VS Code 中即可借助 Claude Code 面板开始对话：

五、IDEA 集成

5.1 安装 IDEA 插件

要求 IDEA 版本 ≥ 2024.02（建议 2025.3.3）。

打开 IDEA → File → Settings
左侧选择 Plugins
切换到 Marketplace 标签
搜索 “Claude Code”
找到 Claude Code [Beta]（Publisher: Anthropic PBC），点击 Install
安装完成后重启 IDEA

搜索不到时：检查 IDEA 版本是否满足要求，或检查 IDEA 代理设置。

5.2 设置 Claude Code

步骤一：新建设置文件

找到设置目录，通常为：

C:Users<当前用户>.claude

在该目录下新增或修改 settings.json 文件：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "<你的智谱API Key>",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5-turbo",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5-turbo",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "enabledPlugins": {
    "document-skills@anthropic-agent-skills": true,
    "example-skills@anthropic-agent-skills": true
  },
  "theme": "dark",
  "disableLoginPrompt": true,
  "selectedModel": "glm-5-turbo",
  "preferredLocation": "panel",
  "claud.code.experimental.enableInlineCompletion": true,
  "claud.code.experimental.enableChat": true
}