Windows11 下用 IntelliJ IDEA 写代码的朋友最近应该都被 Claude Code 刷屏了。作为 Anthropic 官方推出的终端 AI 编程工具Claude Code 可以直接在项目目录里读懂代码结构、帮你改代码、跑命令、写测试实际用下来就像多了一个结对程序员。但很多人在 Windows11 上卡在了安装和接入 IDEA 这一步要么装完命令找不到要么在 IDEA 终端里跑不起来要么折腾半天最后还是用回了网页聊天框。这篇文章就是一份完整的 Windows11 IDEA Claude Code 实操记录从环境准备、安装、配置到日常使用和排坑一次讲清楚。这事适合谁说实话只要你用 IDEA 写 Java、Kotlin、Python 或者前端又想试试真正的 AI 编码工具这篇文章都值得看完。Claude Code 跟普通聊天机器人最大的区别是它长在命令行里能直接操作你的项目文件。下面我按自己踩过的坑一步步来。1. 准备工作别急着装先把环境理清楚1.1 Windows11 下需要准备哪些基础软件很多教程上来就是一行npm install结果装完一堆报错。问题往往不在 Claude Code 本身而在基础环境。在 Windows11 上跑 Claude Code最少需要三样东西IntelliJ IDEA社区版Community或旗舰版Ultimate都行社区版免费功能完全够用Node.js版本必须 18.0 以上建议直接上 20 LTS 或 22 LTS我一开始用 16 死活装不上Git可选但是强烈建议Claude Code 在处理项目时会调用 Git 来看变更记录没有 Git 也能跑但体验打折。还有个容易被忽略的点Claude Code 本体是一个 npm 全局包它运行时需要跟 Anthropic 的 API 服务通信。也就是说你需要一个能正常访问官方服务的网络环境以及一个 Anthropic 账号或 API Key。账号这块我就不展开了重点说本地环境。1.2 IDEA 安装与环境变量的玄机IDEA 的安装本身没有难度去官网下载对应系统的安装包双击下一步就行。这里真正要留意的是 Windows11 的环境变量。如果你在安装 IDEA 时没有勾选“添加到 PATH”那idea命令在终端里是找不到的。不过这其实不影响 Claude Code 使用因为 Claude Code 跑在 IDEA 内置终端里走的是系统 PATH。真正必须配好的是 Node.js 的 PATH。Windows11 配置环境变量的步骤是固定的右键“此电脑” → 属性 → 高级系统设置 → 环境变量。在“系统变量”里找到Path把 Node.js 的安装目录加进去。默认情况下安装 Node.js 时会自动写好但如果你用的是绿色版或者手动解压的 Node这一步就要自己来。我是强烈建议在开始所有操作之前先打开命令行验证一遍基础环境node -v npm -v git --version如果这三条命令都能正常输出版本号基础环境就没问题。如果node -v报“不是内部或外部命令”说明 PATH 没配好先解决这个问题再往下走。1.3 关于 Windows11 版本和 PowerShell 的一点建议Windows11 的版本迭代挺快的网上能搜到各种版本号比如 27H2 之类的词。但说实话Claude Code 对 Windows11 小版本没有硬性要求只要是较新的正式版就行。真正影响使用的是终端工具Claude Code 官方推荐用 PowerShell 7 或者 Windows Terminal。Windows11 自带的 Windows PowerShell 5.1 老是有执行策略卡脚本的问题。虽然可以用Set-ExecutionPolicy临时解决但我更推荐装一个 Windows Terminal把默认终端配置成 PowerShell 7。IDEA 内置终端也支持自定义 shell 路径这个后面会讲到。2. Claude Code 安装全过程从零到能用2.1 升级 Node.js为什么版本不够就装不上Claude Code 的 npm 包anthropic-ai/claude-code对 Node.js 的版本有严格限制。早期版本要求 Node 18我记得在某个版本之后甚至需要 Node 18.17 以上如果版本太老安装时要么直接报错要么装完运行时报语法错误。Windows11 下升级 Node.js 有两个思路。第一个是直接去官网下载最新 LTS 安装包覆盖安装简单粗暴适合新手。第二个是用nvm-windows做版本管理适合需要在多个 Node 版本之间切换的人。我自己的做法是装 nvm-windows因为 Claude Code 有时候需要特定版本而其他老项目可能要切回 Node 16用 nvm 一条命令就能切nvm install 22 nvm use 22装完之后重新打开终端确认node -v输出的版本符合要求再继续。2.2 npm 全局安装 PowerShell 执行策略基础环境就绪后安装 Claude Code 其实就一条命令npm install -g anthropic-ai/claude-code安装过程会输出一堆进度日志最后显示added x packages就代表成功。这时可以用以下命令验证claude --version但很多人在这一步会遇到 Windows11 特有的坑明明安装成功了运行claude却提示“无法加载文件因为在此系统上禁止运行脚本”。这是 PowerShell 执行策略导致的不是 Claude Code 的问题。解决办法是给当前用户开放脚本执行权限以管理员身份打开 PowerShell执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserRemoteSigned的意思是本地创建的脚本可以运行从网上下载的脚本必须有数字签名。这是 Windows11 下比较安全的策略不要直接设成Unrestricted。2.3 安装时网络不稳定的处理方式国内用户在npm install时经常会遇到网络问题表现形式是下载卡在某个包上半天不动或者直接ETIMEDOUT。这时候不要胡思乱想最常规的做法是把 npm 源切换到国内镜像npm config set registry https://registry.npmmirror.com切换之后重新执行安装命令速度会有明显提升。如果已经装了一半失败建议先卸载再装npm uninstall -g anthropic-ai/claude-code清理干净之后重新装避免残留的半成品文件影响后续使用。2.4 首次运行登录与 API Key 配置装好之后在终端里输入claude就会进入交互式界面。首次运行会引导你登录 Anthropic 账号或者粘贴 API Key。这里有一个很多人纠结的问题Claude Code 到底是订阅制账号能用还是 API Key 能用我的实测经验是两种都支持。如果你用的是 Claude 的订阅账号首次登录会选择浏览器授权如果你用的是 API Key选择粘贴 Key 的模式就行。验证配置是否生效可以在 Claude Code 会话里输入/status它会显示当前使用的模型、账号信息和上下文窗口用量。如果显示模型不可用优先检查 API Key 是否有效以及账号是否有余额。3. 在 IDEA 中集成 Claude Code 的几种方式3.1 方式一直接用 IDEA 内置终端最省事Claude Code 本身就是命令行工具所以最自然的用法就是在 IDEA 底部打开 Terminal 标签页直接在项目根目录运行claude。但这里有个很容易踩的坑IDEA 内置终端默认加载的环境变量可能不是最新的。如果你刚装完 Node.js 或者刚配好 PATHIDEA 里可能还是旧环境变量导致claude命令找不到。解决办法很简单完全关闭 IDEA 再重新打开。注意是“完全关闭”光关闭项目窗口不够。另外IDEA 内置终端默认使用系统 PowerShell。如果你的 PowerShell 执行策略没改可能会遇到脚本被禁止运行的提示。把执行策略按 2.2 节设置好之后这个问题就没有了。我个人的习惯是给 Claude Code 设置一个启动目录在项目根目录运行它。这样它能自动识别项目结构、读取 Git 状态。在 IDEA 的 Terminal 里直接cd到项目根目录再执行claude它就接管了整个项目上下文。3.2 方式二配置成 IDEA 外部工具如果你不想每次先打开 Terminal 再敲命令可以把 Claude Code 配到 IDEA 的 Tools 菜单里。这样点一下按钮就能启动比较适合鼠标党。配置路径File → Settings → Tools → External Tools点加号新建一个工具参考配置如下NameClaude CodeProgramC:\Users\你的用户名\AppData\Roaming\npm\claude.cmdArguments--preset $ProjectFileDir$或者留空Working directory$ProjectFileDir$勾选 Open console 和 Synchronize files需要注意claude.cmd的具体路径取决于你的 npm 全局安装位置。不确定的话在命令行里执行where claude或Get-Command claude就能查到。配置好之后Tools 菜单里会多一个 Claude Code 选项点击即可在 IDEA 的 Run 窗口中启动 Claude Code。这种方式的好处是工作目录自动定位到当前项目不用手动 cd。3.3 方式三IDEA AI 插件生态补充方案除了终端方式IDEA 官方和社区也有一些 AI 插件比如 IDEs 自带的 AI Assistant支持配置 Anthropic 的 API Key。如果你不想离开编辑器界面可以在 Settings 里找到 AI Assistant 相关配置填入 API KeyIDEA 就会用 Claude 模型帮你做代码补全和问答。不过说实话这种集成方式跟 Claude Code 的核心体验还是不一样。Claude Code 的强项是能理解整个项目、自主执行多步任务、直接修改文件并提交 Git。AI 插件更多是补全和建议不具备完整的 Agent 能力。所以我的建议是两者都装日常补全靠插件重活累活交给 Claude Code。4. 日常使用与配置优化从能用到好用4.1 进入项目后的第一件事初始化 CLAUDE.md每次在项目根目录启动claude后建议先执行/init命令。它会扫描当前项目的语言、框架、构建工具自动生成一份 CLAUDE.md 文件里面记录了项目的基本情况和代码规范。CLAUDE.md 相当于给 Claude Code 的项目说明书。你可以在里面补充项目架构说明、目录结构、常用命令、编码规范、注意事项。Claude Code 每次回答问题时都会参考这个文件信息越准确它的表现越靠谱。比如我最近在维护一个 Spring Boot 项目就在 CLAUDE.md 里写了“所有数据库变更必须生成迁移脚本不要直接改表结构”“单元测试统一用 JUnit 5”之类的约定。后续让它写代码时它真的会遵守这些约束不会生成风格突兀的代码。4.2 自定义 slash 命令和技能SkillsClaude Code 支持自定义斜杠命令这个功能非常实用。在项目的.claude/commands/目录下创建一个 Markdown 文件文件名就是命令名。举个例子我建了一个code-review命令内容要求 Claude 对当前分支的改动做代码审查、按严重程度列出问题、给出修改建议。然后在会话里输入/code-review它就会执行对应的提示词流程。这对日常开发来说效率提升非常明显。另外从 2025 年开始 Claude Code 加入了 Skills 机制可以在.claude/skills/目录下定义可复用的技能模块每个技能包含一个SKILL.md文件描述触发条件和执行步骤。不过这个机制还在快速迭代中不同版本的语法有差异我建议以官方文档为准先从小命令开始尝试。4.3 模型接入与自定义 API 配置Claude Code 默认使用 Anthropic 的 Claude 模型。但很多场景下开发者会想接入其他服务商的模型比如 DeepSeek 或通过其他兼容 Anthropic API 的服务商。这个需求很常见Claude Code 也支持通过环境变量来覆盖 API 地址和认证信息。在 Windows11 下可以在系统环境变量中新增ANTHROPIC_BASE_URL指向服务商提供的 Anthropic 兼容接口地址ANTHROPIC_AUTH_TOKEN对应的 API TokenANTHROPIC_MODEL指定默认模型名称比如某些场景下用deepseek-chat。配置完成后重新打开终端运行claude它就会走你指定的接口。这里要特别提醒每个服务商的兼容格式和权限控制都不太一样具体参数一定要以你使用的服务商官方文档为准不要照搬别人的配置。另外一旦修改了环境变量IDEA 里的终端也必须完全重启才能加载新变量。4.4 权限模型别让它乱执行命令Claude Code 在执行修改类操作时会向用户请求权限包括文本编辑、Bash 命令执行、Web 访问等。它有两种模式默认模式每次操作前询问你是否允许自动接受模式通过/permissions或者在启动时加参数预设允许某些操作。我的建议是刚开始用默认模式等摸清它的行为习惯再放宽权限。特别是 Bash 命令执行权限一旦放开它就能执行系统级命令风险不小。我在一次重构中它试图执行一个rm -rf开头的清理命令幸亏默认权限模式挡了一下我确认之后才放行。5. 常见问题与排查技巧实录5.1 “claude 不是内部或外部命令”怎么办这是出现频率最高的问题。原因通常有三种npm 全局目录不在 PATH 里、IDEA 没有刷新环境变量、npm 安装路径比较特殊。排查路径是先在系统终端不是 IDEA 终端执行claude -v如果系统终端能用而 IDEA 不能用说明 IDEA 环境没刷新重启 IDEA 解决。如果系统终端也用不了执行npm config get prefix查看 npm 全局目录把该目录加入 PATH再重开终端。5.2 Node.js 版本太低导致的安装失败如果你安装时出现类似requires node 18.17.0的提示就是 Node 版本太老。不要跟它对着干老老实实升级。用nvm-windows切换版本最省心一条命令搞定不会影响系统里其他依赖 Node 的程序。5.3 PowerShell 禁止运行脚本错误信息是“无法加载文件因为在此系统上禁止运行脚本”。处理方法就是前面说的Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。这里有个细节这个命令在普通管理员 PowerShell 里执行不是 IDEA 终端里执行。改完策略后IDEA 终端和系统终端都能正常使用 claude 命令。5.4 Claude Code 出现 529 错误529 是 Anthropic 服务端过载的典型状态码高峰期经常出现不是你的操作问题。遇到这个提示可以等几分钟再试或者在启动时指定一个冷却策略把请求频率降下来。另外如果你用的是自定义 API 网关也可以检查一下目标服务是否限流。5.5 Windows11 特有的权限问题有时候 IDEA 里运行 Claude Code 时访问某个项目文件会报“Access is denied”。这通常是项目目录权限不对或者杀毒软件拦截了 Node.js 进程。排除方法是把项目目录放在用户目录下如C:\Users\你的用户名\projects而不是系统盘根目录或 Program Files 目录。如果杀毒软件频繁拦截把 Node.js 加入白名单这属于 Windows11 下的常见问题不用紧张。6. 一些实际的体验心得最后聊点我在 Windows11 上用了这么久 Claude Code 的体会。最明显的感受是在 IDEA 终端里跑 Claude Code跟打开网页聊天是完全不同的效率级别。它能看到你当前的 Git 分支、修改过的文件、构建日志能直接定位到报错行并给出修改方案。尤其是重构老项目、批量修改命名风格、补测试这些重复性工作它比人做的快得多。还有一点要提醒Claude Code 不是每次都能答对复杂逻辑上它也会犯错。我的习惯是让它先说明修改思路我再审查一遍确认没问题后才让它动手改文件。它改完之后我会用 Git diff 仔细看变更避免引入隐藏问题。给大家一个我最近一直在用的小技巧在 IDEA 的项目根目录放一个.claude/commands目录里面自定义几个高频命令比如审查当前改动、写测试、检查 TODO。下一次打开 Claude Code直接斜杠命令拖一下比自己敲提示词省事太多。这套组合拳用熟了之后日常开发流程会顺畅很多。