IDEA接入Claude Code保姆级教程（Windows专属+衔接前置安装）

IDEA接入Claude Code保姆级教程（Windows专属+衔接前置安装）

前置核心确认（衔接前文，必看）

1. 已按之前《Windows安装ClawCode保姆级教程》完成本地安装，ClawCode服务正常运行（浏览器可访问 http://localhost:18789，登录令牌可用）；

2. IDEA版本要求：2021.3及以上版本（社区版/旗舰版通用，低版本先升级避免插件不兼容）；

3. 操作环境：Windows系统保持联网，关闭IDEA内置代理（避免拦截本地服务连接），全程不用配置海外API，仅对接本地ClawCode。

一、新手首选：IDEA官方插件直连Claude Code（零配置，1分钟搞定）

这是最省心的接入方式，通过JetBrains插件市场安装专属插件，直接绑定本地ClawCode服务，无需写命令、不用改配置文件，适合零基础用户。

Step 1 打开IDEA插件市场（两种快速入口）

1. 快捷键入口（推荐）：键盘按下 Ctrl+Alt+S，直接打开IDEA设置面板；

2. 手动入口：点击IDEA顶部菜单栏 File → Settings，进入设置界面；

3. 在设置面板左侧菜单栏，找到并点击 Plugins （插件）选项，切换到 Marketplace（市场）标签页。

Step 2 搜索并安装Claude Code兼容插件

1. 在插件市场顶部搜索框，输入 Claude Code 或 OpenClaw（对应你安装的本地工具本名）；

2. 找到官方标注的 Claude Code [Beta] 或 OpenClaw IDEA 适配插件，点击 Install（安装）按钮；

3. 等待插件安装完成，面板会提示Restart IDE （重启IDE），必须完全重启IDEA（关闭所有IDEA窗口重新打开），插件才能生效，切勿最小化直接用。

Step 3 绑定本地ClawCode服务（核心对接步骤）

1. 重启IDEA后，右侧边栏会出现 Claude Code 图标（小爪子/AI标识），点击打开插件面板；

2. 首次打开会弹出配置界面，填写本地服务连接参数（直接复用之前安装ClawCode的信息，不用重新生成）：

   1. 服务地址：http://localhost:18789（固定本地端口，前文默认端口）；

   2. 访问令牌：粘贴之前Windows终端生成的ClawCode令牌（命令：openclaw token generate）；

   3. 连接模式：选择 Local Host（本地主机），切勿选远程模式。

3. 点击 Test Connection （测试连接），提示 Connection Successful 即为对接成功。

Step 4 IDEA内直接使用Claude Code

• 快速启动：Windows快捷键 Ctrl+Esc，一键调出Claude Code对话面板；

• 代码操作：选中代码后右键，可直接选择优化代码/查BUG/生成注释 等指令；

• 命令交互：在插件面板输入自然语言指令，比如"帮我优化这段Java代码""解释这段代码逻辑"，本地ClawCode会直接响应。

二、备用方案：IDEA内置终端CLI对接（无插件/插件兼容失败时用）

如果插件不兼容、安装失败，直接用IDEA内置终端调用本地ClawCode CLI，不用额外装工具，全程命令行操作，稳定性更强。

Step 1 打开IDEA内置终端

1. 快捷键：按下 Ctrl+`（键盘左上角Esc下方的反引号键），快速打开底部终端；

2. 手动入口：点击IDEA顶部 View → Tool Windows → Terminal，打开内置终端。

Step 2 验证本地ClawCode环境

在内置终端中输入以下命令，按回车，出现版本信息/帮助文档，说明环境已打通：

openclaw --version

若提示命令不存在，重启IDEA终端，或手动切换到ClawCode安装目录再执行。

Step 3 终端内直接调用Claude Code功能

直接在IDEA内置终端输入指令，即可调用本地服务，无需切换外部窗口，示例常用指令：

• 代码分析：openclaw analyze 文件名.java

• 代码优化：openclaw fix 选中代码片段

• 启动交互模式：openclaw chat，进入对话模式，实时处理代码需求

三、Windows+IDEA专属避坑大全（解决99%连接失败问题）

1. 连接失败/无法访问本地服务（最常见）

• 排查第一步：确认外部浏览器能打开 http://localhost:18789，ClawCode后台服务未关闭；

• 解决方法：管理员身份打开Windows终端，执行 openclaw gateway start 重启本地服务，再重启IDEA。

2. 插件安装后不显示/无响应

• 原因：IDEA未完全重启，或版本过低；

• 解决方法：关闭所有IDEA进程，重新打开；若仍无效，升级IDEA到2022+版本，重装插件。

3. 令牌无效/权限不足

重新生成令牌：管理员Windows终端执行 openclaw token generate，复制新令牌粘贴到IDEA插件配置中，替换旧令牌。

4. 端口18789占用，连接超时

IDEA终端执行以下命令，释放端口后重启服务：

net stop winnat && net start winnat openclaw gateway restart

5. IDEA内置终端识别不了openclaw命令

• 原因：系统环境变量未生效；

• 解决方法：重启电脑，或在IDEA终端中手动切换到ClawCode安装目录，再执行命令。

四、新手速记流程（3步搞定，不用记细节）

1. Ctrl+Alt+S打开IDEA插件市场，安装Claude Code插件，完全重启IDE；

2. 填写本地服务地址http://localhost:18789+之前生成的ClawCode令牌，测试连接；

3. Ctrl+Esc调出面板，直接选中代码操作或输入指令，完成代码辅助。

核心优势：全程对接本地已安装的ClawCode，不用额外付费、不用配置海外网络，和之前的安装流程完全衔接，在IDEA内就能实现代码优化、BUG排查、注释生成、逻辑讲解等全功能，适配Windows全版本IDEA。