1. 引言

在 AI 编程助手遍地开花的今天，Claude Code 凭借其强大的代码理解、生成和重构能力，成为了许多开发者的心头好。然而，对于习惯了 IntelliJ IDEA 强大生态的 Java 开发者来说，如何在 IDEA 中丝滑地集成 Claude Code，而不是在终端和 IDE 之间反复切换，一直是个痛点。

今天，我就来分享一套在 IDEA 中爽用 Claude Code 的终极方案，让你的编码体验如丝般顺滑，效率直接起飞。

2. 方案概览：告别终端切换

传统的 Claude Code 使用方式是在终端中运行 claude 命令，通过对话式交互来完成任务。但这意味着你需要频繁地在 IDEA 的编辑器和终端窗口之间切换，上下文割裂感很强。

我们的终极方案核心思路是：将 Claude Code 的能力无缝嵌入到 IDEA 的日常操作流中。主要包含以下三个层面：

1. 自定义外部工具：将 Claude Code 命令封装为 IDEA 的外部工具，一键调用。
2. 文件上下文传递：通过脚本自动将当前打开的文件、选中代码或项目结构作为上下文传递给 Claude。
3. 结果回写与预览：将 Claude 的生成结果直接插入到当前编辑器中，或创建新文件。

这套方案不需要安装任何第三方插件，完全基于 IDEA 内置的「外部工具」和「文件监视器」功能实现，干净、可控、无侵入。

3. 前置准备：安装并配置 Claude Code

在开始之前，请确保你已经完成了以下准备工作：

3.1 安装 Node.js 和 npm

Claude Code 基于 Node.js，请确保你的系统已安装 Node.js 18+ 版本。

node -v
npm -v

3.2 全局安装 Claude Code

打开终端，执行以下命令进行全局安装：

npm install -g @anthropic-ai/claude-code

安装完成后，运行 claude 命令进行初始化授权，确保它能正常工作。

3.3 获取 API Key（可选）

如果你希望使用自己的 Anthropic API Key 而不是通过 Claude 订阅计费，可以设置环境变量：

export ANTHROPIC_API_KEY="your-api-key-here"

建议将这一行添加到你的 shell 配置文件（如 .zshrc 或 .bashrc）中，以便持久生效。

4. 核心配置：在 IDEA 中创建外部工具

这是整个方案的核心步骤。我们将创建一个 IDEA 外部工具，用于将当前选中的代码或文件内容发送给 Claude Code 进行处理。

4.1 打开外部工具配置

1. 打开 IDEA，进入 File -> Settings（Windows/Linux）或 IntelliJ IDEA -> Preferences（macOS）。
2. 在左侧导航栏中，找到 Tools -> External Tools。
3. 点击中间的 + 号，添加一个新的外部工具。

4.2 配置工具参数

在弹出的对话框中，按如下方式配置：

• Name：Claude Code: 解释选中代码
• Description：将选中的代码发送给 Claude Code 进行解释
• Program：/usr/local/bin/claude（请根据你的实际安装路径填写，可通过 which claude 命令查看）
• Arguments：

-p "请用中文详细解释以下代码的功能、逻辑和关键点：$SelectedText$"

• Working Directory：$ProjectFileDir$
• Advanced Options：
  • 勾选 Synchronize files after execution
  • 勾选 Open console for tool output
  • Console Output：选择 Show console when a message is printed to stderr

关键点：$SelectedText$ 是 IDEA 的宏变量，会自动替换为你当前在编辑器中选中的代码。-p 参数用于直接传递 prompt 给 Claude Code，使其以非交互模式运行。

4.3 添加更多实用工具

你可以按照同样的方法，创建多个不同用途的外部工具，形成一个工具矩阵：

工具名称	Arguments (prompt)	用途
Claude: 解释代码	-p "请用中文详细解释以下代码：$SelectedText$"	代码解释
Claude: 重构代码	-p "请重构以下代码，提高其可读性和性能：$SelectedText$"	代码重构
Claude: 生成单元测试	-p "请为以下代码生成全面的 JUnit 5 单元测试：$SelectedText$"	测试生成
Claude: 查找 Bug	-p "请审查以下代码，找出潜在的 Bug 和安全隐患：$SelectedText$"	代码审查
Claude: 添加注释	-p "请为以下代码添加详细的中文注释：$SelectedText$"	代码注释

5. 进阶玩法：将整个文件作为上下文

有时候，我们需要的不仅仅是选中的几行代码，而是整个文件的上下文。这时，我们可以借助一个简单的 Shell 脚本来实现。

5.1 创建传递脚本

在项目的根目录下创建一个脚本文件，例如 claude_file.sh：

#!/bin/bash
# 将当前文件内容通过管道传递给 Claude Code

FILE_PATH="$1"
CONTENT=$(cat "$FILE_PATH")

echo "$CONTENT" | claude -p "请分析这个文件的内容，并给出优化建议。"

赋予执行权限：

chmod +x claude_file.sh

5.2 配置外部工具

再创建一个新的外部工具：

• Name：Claude: 分析当前文件
• Program：/path/to/your/project/claude_file.sh
• Arguments：$FilePath$
• Working Directory：$ProjectFileDir$

现在，你可以在 IDEA 中右键点击任何文件，选择 External Tools -> Claude: 分析当前文件，即可将整个文件内容发送给 Claude 进行分析。

6. 终极体验：一键生成代码并插入

上面的方案虽然好用，但结果输出在控制台，还需要手动复制粘贴。我们更进一步，让 Claude 的生成结果直接插入到当前编辑器中。

6.1 使用 pbcopy / xclip 实现无缝粘贴

我们可以修改脚本，让 Claude 的输出自动复制到剪贴板，然后你只需在 IDEA 中按 Ctrl+V（或 Cmd+V）即可粘贴。

创建一个新脚本 claude_insert.sh：

#!/bin/bash
# 将 Claude 的输出直接复制到系统剪贴板

PROMPT="$1"
SELECTED_TEXT="$2"

echo "$SELECTED_TEXT" | claude -p "$PROMPT" | pbcopy  # macOS 使用 pbcopy
# Linux 用户请使用: | xclip -selection clipboard

配置外部工具：

• Name：Claude: 生成并插入
• Program：/path/to/your/project/claude_insert.sh
• Arguments："请根据以下代码生成对应的 Builder 模式实现：" $SelectedText$
• Working Directory：$ProjectFileDir$

使用流程：

1. 在 IDEA 中选中你的原始代码。
2. 右键 -> External Tools -> Claude: 生成并插入。
3. 等待几秒钟，Claude 处理完成后，内容已自动复制到剪贴板。
4. 将光标移动到目标位置，按 Ctrl+V 粘贴。

整个过程行云流水，完全不需要离开 IDEA 的编辑界面。

7. 为工具绑定快捷键

为了进一步提升效率，我们可以为最常用的外部工具绑定快捷键。

1. 进入 File -> Settings -> Keymap。
2. 在搜索框中输入 External Tools，展开列表。
3. 找到你刚刚创建的工具，例如 Claude Code: 解释选中代码。
4. 右键点击，选择 Add Keyboard Shortcut。
5. 按下你想要的快捷键组合，例如 Ctrl+Shift+/，然后点击 OK。

现在，选中代码后，只需按下 Ctrl+Shift+/，Claude 的解释就会立刻出现在控制台中。这种即时反馈感，才是真正的「丝滑」。

8. 总结与最佳实践

通过这套方案，我们成功地将 Claude Code 的强大能力无缝集成到了 IDEA 中，实现了：

• 零插件依赖：完全基于 IDEA 内置功能，安全可靠。
• 上下文无缝传递：选中代码、整个文件、项目目录，随心所欲。
• 结果即时反馈：控制台输出或直接粘贴到编辑器，无需切换窗口。
• 高度可定制：你可以根据自己的需求，创建任意数量的专用工具。

最佳实践建议：

• 从简单开始：先配置「解释代码」和「查找 Bug」两个工具，感受一下工作流的变化。
• 优化 Prompt：不断打磨你的 prompt，使其更贴合你的项目语言和编码规范。
• 结合 Git：在重构前先用 Git 提交，这样即使 Claude 生成的结果不理想，也可以轻松回退。
• 注意 Token 消耗：传递整个大文件时要注意 Token 消耗，对于超大文件，建议只传递关键部分。

希望这套方案能帮你打开新世界的大门，让你在 IDEA 中享受 Claude Code 带来的极致编码体验。如果你有更好的玩法，欢迎在评论区分享交流！