Claude Code 与 JetBrains 集成：安装、连接和排障

需要安装哪两部分

JetBrains 集成通过专用 Claude Code 插件连接 CLI，提供差异查看与选区上下文等能力。当前官方文档说明插件不自带 CLI，因此先按 Claude Code 安装文档准备命令行，再从官方文档链接进入 JetBrains Marketplace 安装插件并重启 IDE。

IntelliJ、PyCharm、WebStorm 等适用环境需检查当前插件兼容信息。不要把名称相似的第三方聊天插件或 JetBrains 自身 AI 服务当成同一产品，也不要按旧教程强制安装某个已过时的 Node.js 版本。

建立连接并做只读检查

在 IDE 打开的项目根目录启动内置终端，先运行 claude --version 确认命令存在，再运行 claude，按官方流程登录合适账户。外部终端会话可使用 /ide 连接正在运行的 IDE。以下命令经过文档核对，没有在读者机器安装或执行。

在 IDE 终端：
claude --version
claude

仅当从外部终端连接 IDE 时，在 Claude Code 会话输入：
/ide

原创练习：解释一个边界分支

打开虚构项目的日期解析函数，选择处理空字符串的几行，请 Claude “只解释该分支并指出缺少的测试，不修改文件”。核对它引用的是当前选区和项目，而不是同名旧文件。确认连接后，再要求提出最小修改计划，人工查看 diff。

选区和编辑器诊断可能进入上下文，因此不要停留在密钥文件或含个人资料的配置页。登录方式和计费渠道需明确；现有订阅不应被直接解释为任意 API 调用免费。

找不到 IDE 或命令时怎么查

先检查插件是否启用、IDE 是否重启，以及 CLI 是否在 IDE 终端的 PATH 中；若命令装在自定义目录，可按官方插件设置配置其真实完整路径。远程开发还需确认插件装在实际运行项目的远程主机，而不是仅装本地客户端。

WSL、容器或远程 IDE 可能涉及额外网络配置。不要直接关闭防火墙或扩大网段权限作为通用修复；先按环境对应文档定位，由管理员评估安全变更。本文未做真实插件联调，不承诺所有版本兼容，修改后仍需执行项目测试。