跳转到内容

IDE 集成

Claude Code 原生住在终端里,但你也可以把它接到 IDE 里——要么装官方扩展拿图形界面,要么让终端跟 IDE 联动。这一页讲清楚几种接法。

接法 体验 适合谁
VS Code 扩展 图形界面,对话窗口浮在编辑器里 喜欢图形界面、不爱开终端的人
JetBrains 插件 同上,但跑在 JetBrains 系里 IntelliJ/PyCharm/WebStorm 用户
终端 + IDE 联动 Claude 在终端跑,但能感知 IDE 的选中文件 老终端党

官方出了 VS Code 扩展,目前还是 Beta,但日常用没问题。

  1. 打开 VS Code
  2. 进扩展市场(Cmd+Shift+X / Ctrl+Shift+X
  3. Claude Code
  4. 点 Install

装完侧边栏会多一个 Claude 图标,点开就是一个对话窗口,跟终端里那个 > 是一回事。

  • 看 diff 更直观:改动以 VS Code 的 diff 视图呈现,比终端的纯文本好读
  • 能感知选中代码:你在编辑器里选中一段代码,Claude 自动把它当上下文
  • 文件树联动:Claude 改文件,VS Code 文件树实时刷新
  • 键盘快捷键Cmd+Esc(mac)/ Ctrl+Esc(Win)快速唤起 Claude

代价是:扩展还在 Beta,偶尔会卡、偶尔会跟终端会话状态不同步。出问题就回终端。

IntelliJ IDEA / PyCharm / WebStorm / GoLand 这一系都有官方插件。

装法跟 VS Code 类似:进 JetBrains 的插件市场,搜 Claude Code,装上重启。功能跟 VS Code 扩展基本对齐——对话窗口、diff 视图、选中代码感知。

如果你是终端党,不想装扩展,也有办法让终端里的 Claude 跟 IDE 联动。

终端默认按 Enter 就提交,写多行 prompt 很别扭。Claude Code 内置一个 /terminal-setup 命令帮你配 Shift+Enter 换行:

> /terminal-setup

它会自动配置你的终端(支持 iTerm2、VSCode 内置终端、Apple Terminal),配完重开终端,按 Shift+Enter 就能换行写多行 prompt。

Terminal window
claude --ide

启动时加 --ide,Claude Code 会自动连接当前所在的 IDE(如果是在 VSCode 内置终端里跑,就连 VSCode;在 IntelliJ 终端里跑,就连 IntelliJ)。连上之后:

  • 你在 IDE 里选中的代码,Claude 能感知
  • Claude 改文件,IDE 立刻刷新
  • IDE 的 LSP 错误信息能被 Claude 读到(修 lint 错误更准)

老终端党推荐这条:终端体验保留,IDE 联动白嫖。

接 IDE 之后有几个权限点要注意:

  1. 文件读写权限范围:Claude Code 的权限范围跟你启动它的目录一致。在项目根目录启动,它能读写整个项目;在 ~ 启动,理论上能读写整个家目录。永远在项目根目录启动
  2. IDE 凭据:扩展会读你的 IDE 登录状态(比如 GitHub token 用于 PR 操作),但不会上传到任何地方,只在你本机用。
  3. 扩展权限:装扩展时看一眼它要的权限列表。官方扩展只问「读写文件、执行命令、网络访问」三项,多了就要警惕。

没有标准答案,但有个粗略经验:

场景 推荐
改一两个文件,看 diff IDE 扩展
大规模重构、跨多文件 终端(更稳,能跑长任务)
跑 CI、脚本、headless 终端
写 commit、跑 git 终端(更顺手)
新人入门 IDE(图形界面友好)
老手日常 终端 + --ide 联动

一个常见的工作流:用 IDE 扩展做日常改代码,遇到大活切到终端跑 headless。两边的会话不互通,但同一份代码库切换无成本。

VS Code 扩展会自动启一个 Claude Code 后台进程,如果你同时在终端里也跑了 claude,会有两个进程抢同一份配置。别同时开——要么用扩展,要么用终端,二选一。

装扩展拿图形界面,加 --ide 让终端跟 IDE 联动;日常改代码用 IDE,跑大活回终端。

下一站,与 Copilot/Cursor 对比 看看 Claude Code 在 AI 编码工具图谱里站哪。🚀