人人都会AI编程

2.2 IDE 插件安装

更新时间：2026-06-28

IDE 插件为不喜欢纯终端操作的用户提供图形化界面，但必须基于第 2.1 节已安装的 CLI 版本才能工作。插件本身不包含 AI 模型，仅作为 CLI 的交互前端。

2.2.1 VS Code 插件安装与启用

前置要求：确保系统已安装 CLI 版（claude --version 可正常输出版本号），且 VS Code 版本 ≥ 1.85.0。

安装步骤：

  1. 打开 VS Code → 侧边栏点击 Extensions（或按 Ctrl+Shift+X / Cmd+Shift+X）
  2. 搜索框输入 "Claude Code"（Publisher 为 Anthropic）
  3. 点击 Install，安装完成后右下角会提示"需要重启 VS Code"（建议重启以确保 PATH 加载完整）

首次配置（如 CLI 不在系统默认 PATH）：

  • 按 Ctrl+Shift+P（或 Cmd+Shift+P）打开命令面板
  • 输入 "Claude Code: Set Executable Path"
  • 填入 CLI 的绝对路径（如 macOS /usr/local/bin/claude，Windows WSL2 /home/用户名/.local/bin/claude）

使用入口：

  • 侧边栏图标：安装后左侧活动栏会出现 Claude 图标（菱形图案），点击打开对话面板
  • 编辑器右键菜单：选中代码 → 右键 → Claude Code: Explain This / Fix This / Refactor This
  • 命令面板：Ctrl+Shift+P → 输入 "Claude Code" 查看所有可用命令（如 Start New Session、Add Selection to Context）

工作模式说明：

  • VS Code 插件与终端 CLI 共享同一份配置（包括 CLAUDE.md 和 API Key）
  • 在 VS Code 中发起的对话会生成与终端版本相同的项目缓存（.claude/ 目录）

2.2.2 JetBrains 系 IDE 插件安装

支持产品：IntelliJ IDEA（Ultimate/Community）、PyCharm、WebStorm、GoLand、PhpStorm 等 2023.1 及以上版本。

安装步骤：

  1. 打开 IDE → File → Settings（macOS 为 IntelliJ IDEA → Preferences）
  2. 左侧选择 Plugins → 切换到 Marketplace 标签
  3. 搜索 "Claude Code"（注意识别 Anthropic 官方图标），点击 Install
  4. 安装完成后点击 Restart IDE（必须重启才能加载终端集成组件）

配置工具路径：
重启后首次使用时会自动检测 claude 命令，如未检测到：

  • Settings → Tools → Claude Code
  • 在 Claude executable path 中填写 CLI 的完整路径（可通过终端 which claude 获取）
  • 点击 Test Connection 验证（应显示当前 CLI 版本号）

使用入口：

  • 主菜单：Tools → Claude Code → New Chat / Explain Code / Generate Tests
  • 编辑器右键：选中代码 → 右键 → Claude Code 子菜单
  • 项目视图右键：右键点击文件/文件夹 → Add to Claude Context（将文件加入当前对话上下文）
  • 工具窗口：底部工具栏点击 Claude Code 打开对话面板（与 Terminal、Git 并列）

快捷键设置（建议配置）：

  • Settings → Keymap → 搜索 "Claude Code"
  • 常用绑定建议：
  • New Chat: Alt+C（macOS Option+C）
  • Explain Selection: Alt+E
  • Send Selection to Claude: Alt+S

注意事项：

  • JetBrains 插件暂不支持 Inline Diff（行内差异预览），修改建议会以弹窗形式展示，确认后才会写入文件
  • 与 VS Code 版本不同，JetBrains 插件的上下文需要手动添加（通过右键 Add to Context），不会自动读取当前打开的所有文件

插件与 CLI 的协同建议

推荐工作流：

  • 复杂任务（项目级重构、Git 操作）：使用 CLI 版本（第 2.1 节），利用其完整的终端集成能力
  • 代码审查/单文件编辑：使用 IDE 插件，利用代码高亮和行号定位
  • 混合使用：在 IDE 插件中发起任务后，可随时在终端输入 claude 继续同一会话（会话状态保存在项目 .claude/ 目录中）

故障排查：

  • 如插件提示 "Claude CLI not found"，先检查终端能否正常执行 claude 命令，再检查 IDE 的 PATH 环境变量是否与终端一致（特别是 macOS 使用 Launchpad 启动的 IDE 可能读取不到 .zshrc 中的 PATH）
  • 解决方式：在 IDE 的终端中运行 echo $PATH，确认包含 CLI 所在目录，或在插件设置中手动指定绝对路径