Claude Code: VS Code 与 JetBrains 集成
最后更新：2026-08-31
Claude Code 本质是 CLI 工具，但可以在 VS Code 和 JetBrains 的终端中运行，也能通过扩展获得更好的集成体验。
💡 提示：Claude Code 不是 IDE 插件——它在终端中运行，但 IDE 扩展可以提供快捷入口、侧边栏面板和更好的交互体验。
📋 前置知识：第四章 第一次使用
1. 你将学到
- VS Code 中安装 Claude Code 扩展
- JetBrains IDE 中使用 Claude Code
- IDE 集成模式与 CLI 模式对比
- 终端配置优化
- 多 IDE 工作流
2. VS Code 集成
(1) 安装扩展
BASH
# 方式一：VS Code 扩展市场搜索安装
# 搜索 "Claude Code" → Install
# 方式二：命令行安装
code --install-extension anthropic.claude-code
# 方式三：VS Code 中按 Ctrl+Shift+X → 搜索 Claude Code → Install
(2) 扩展配置
JSON
// settings.json
{
"claude-code.apiKey": "sk-ant-api03-xxxxx",
"claude-code.model": "claude-sonnet-4-20250514",
"claude-code.autoApprove": "read-only",
"claude-code.terminalProfile": "claude"
}
(3) 使用方式
| 方式 | 操作 | 适用场景 |
|---|---|---|
| 侧边栏面板 | 点击 Claude 图标 | 可视化交互 |
| 内嵌终端 | 在 VS Code 终端输入 claude |
与 CLI 一致 |
| 快捷键 | Ctrl+Shift+C |
快速打开面板 |
| 右键菜单 | 选中代码 → Ask Claude | 针对性提问 |
▶ 示例 1: VS Code 工作流
TEXT
📖 仅展示
# Alice 在 VS Code 中使用 Claude Code
1. 打开项目
2. 按 Ctrl+` 打开终端
3. 输入 claude 启动
或
1. 点击侧边栏 Claude 图标
2. 在面板中直接输入指令
3. 点击文件变更可直接 diff 查看
4. 一键 Accept/Reject 变更
3. JetBrains 集成
(1) 安装插件
TEXT
📖 仅展示
# 支持的 IDE：IntelliJ IDEA、WebStorm、PyCharm、GoLand 等
安装步骤：
1. File → Settings → Plugins
2. 搜索 "Claude Code"
3. 点击 Install
4. 重启 IDE
(2) 在 JetBrains 终端中使用
BASH
# JetBrains 内置终端可直接运行 Claude Code
# 底部工具栏 → Terminal → 输入 claude
# 配置终端
# Settings → Tools → Terminal → Shell path
# 确保终端能找到 claude 命令
which claude # 确认路径
(3) JetBrains 特有功能
| 功能 | 说明 |
|---|---|
| 代码选中提问 | 选中代码 → 右键 → Ask Claude |
| Intentions | Alt+Enter → Claude 建议操作 |
| Diff 预览 | 内置 diff 查看器预览变更 |
| Run Configuration | 配置 Claude Code 启动项 |
▶ 示例 2: JetBrains 工作流
TEXT
📖 仅展示
# Bob 在 IntelliJ IDEA 中使用 Claude Code
1. 打开 Spring Boot 项目
2. 底部 Terminal 面板 → claude
3. 输入："给 UserController 添加分页查询接口"
Claude Code：
→ Reading UserController.java
→ Reading UserRepository.java
→ Modifying UserController.java (adding pageable endpoint)
→ Modifying UserRepository.java (adding query method)
→ Running: mvn test
✅ All tests passed
4. 在 IDE 中查看 diff：
双击变更文件 → 内置 diff 视图
绿色高亮新增代码，红色高亮删除代码
4. IDE 集成 vs 纯 CLI
(1) 功能对比
| 维度 | 纯 CLI | VS Code 扩展 | JetBrains 插件 |
|---|---|---|---|
| 安装方式 | npm 全局安装 | 扩展市场 | 插件市场 |
| 交互界面 | 终端文字 | 侧边栏面板 | 终端+意图操作 |
| Diff 查看 | git diff | 内置 diff 视图 | 内置 diff 视图 |
| 文件操作 | 自动修改 | 一键确认 | 一键确认 |
| 上下文感知 | 手动指定 | 选中代码 | 选中代码+意图 |
| 远程开发 | SSH 直连 | Remote SSH | Remote SSH |
| 配置管理 | 环境变量 | settings.json | IDE Settings |
(2) 选择建议
| 场景 | 推荐方式 | 原因 |
|---|---|---|
| 服务器远程 | 纯 CLI | 无需 GUI，SSH 直连 |
| 日常开发 | IDE 扩展 | 集成体验好 |
| CI/CD | 纯 CLI | 自动化脚本 |
| 多项目切换 | 纯 CLI | 灵活切换目录 |
| 团队协作 | IDE 扩展 | 降低上手门槛 |
5. 终端配置优化
▶ 示例 3: 优化 Claude Code 终端体验
BASH
# 1. 配置 Shell 别名
echo 'alias cc="claude"' >> ~/.zshrc
echo 'alias ccr="claude --resume"' >> ~/.zshrc
# 2. 配置终端颜色支持
export TERM=xterm-256color
# 3. VS Code 终端配置（settings.json）
{
"terminal.integrated.shell.linux": "/bin/zsh",
"terminal.integrated.env.linux": {
"ANTHROPIC_API_KEY": "sk-ant-api03-xxxxx"
}
}
# 4. JetBrains 终端配置
# Settings → Tools → Terminal → Add environment variable
# ANTHROPIC_API_KEY=sk-ant-api03-xxxxx
6. 综合示例：多 IDE 协作
TEXT
📖 仅展示
# Alice 的团队使用多 IDE 协作
团队成员 A（VS Code + 前端项目）：
→ VS Code 侧边栏启动 Claude Code
→ 让 Claude Code 重构 React 组件
→ 使用内置 diff 确认变更
团队成员 B（IntelliJ + 后端项目）：
→ IDE 终端启动 Claude Code
→ 让 Claude Code 添加 REST API
→ 使用 Intentions 快速操作
CI/CD 流水线：
→ 纯 CLI 模式
→ claude --headless "运行代码审查"
→ 自动化检查和修复
❓ 常见问题
Q VS Code 扩展和 CLI 能同时用吗？
A 可以，但不建议同时操作同一文件。两者共享同一个 API Key 和模型配置。
Q JetBrains 插件支持哪些 IDE？
A 支持所有 JetBrains IDE：IntelliJ IDEA、WebStorm、PyCharm、GoLand、RubyMine、PhpStorm 等。
Q 不用扩展，只在终端运行有什么区别？
A 核心功能完全一致。扩展只是提供更好的 UI 体验（diff 视图、一键确认等），不影响 Claude Code 本身的能力。
Q 远程开发怎么用？
A VS Code Remote SSH 连接服务器后，在远程终端中安装 Claude Code 即可。JetBrains 同理。
Q 扩展会自动更新吗？
A 会。VS Code 和 JetBrains 都有自动更新机制。CLI 版本需要手动
npm update -g。Q 哪个 IDE 集成体验最好？
A VS Code 扩展集成度最高（侧边栏面板、快捷键、diff 视图），JetBrains 次之，纯 CLI 最灵活。
📖 小节
- VS Code 和 JetBrains 都有 Claude Code 扩展/插件
- 扩展提供更好的 UI 体验，但核心功能与 CLI 一致
- 纯 CLI 适合服务器和 CI/CD 场景
- 选中代码直接提问是 IDE 集成的最大优势
- 终端配置优化能提升日常使用体验
📝 作业
- 基础题（难度⭐）：在你的 VS Code 或 JetBrains IDE 中安装 Claude Code 扩展，确认能正常启动。
- 进阶题（难度⭐⭐）：分别用纯 CLI 和 IDE 扩展完成同一个任务，对比体验差异。
- 挑战题（难度⭐⭐⭐）：配置 VS Code Remote SSH + Claude Code，实现远程服务器上的 AI 辅助编程。
