ACORG docs

主题

IDEA 安装 CC GUI ​

CC GUI 是 JetBrains IDE 插件,用于在 IDEA 中以可视化界面使用 Claude Code 与 Codex。

安装前检查 ​

  • IntelliJ IDEA / WebStorm / PyCharm 等 JetBrains IDE 已能正常启动。
  • IDEA Terminal 中能执行 codex --version 或 claude --version。
  • 如果计划接入 IDE 工具能力,建议先完成 IDEA MCP。

安装步骤 ​

  1. 打开 IDEA 设置:File -> Settings -> Plugins。
  2. 在 Marketplace 搜索 CC GUI。
  3. 安装 CC GUI（Claude or Codex）。
  4. 重启 IDEA。
  5. 打开 CC GUI 工具窗口。
  6. 选择 Codex 或 Claude Code 开始使用。

建议验证 ​

在 IDEA Terminal 中运行:

bash
codex --version
claude --version

在 CC GUI 中做一次小任务:

text
阅读当前项目结构,告诉我构建命令和文档目录。

如果插件能显示输出并正确读取当前项目,说明基础链路正常。

配置建议 ​

  • CLI 可执行文件路径优先使用系统 PATH 中的版本。
  • 如果 IDEA 无法读取 nvm PATH,可在插件设置中填写绝对路径。
  • JetBrains Toolbox 启动的 IDE 与系统终端启动的 IDE 环境变量可能不同,排查时要区分。
  • 项目级规则建议放在 项目规则文件 中,减少每次对话重复说明。

常见问题 ​

插件找不到 codex 或 claude ​

通常是 IDEA 启动环境没有读到 nvm 的 PATH。可先从系统终端启动 IDEA,或在插件设置中配置 CLI 可执行文件路径。

CLI 在系统终端可用,IDEA Terminal 不可用 ​

检查 IDEA 使用的 Shell 配置。Windows 可确认 PowerShell profile,macOS 可确认 login shell 是否加载 ~/.zshrc。

是否必须同时安装 Codex 和 Claude Code ​

不是。只安装其中一个也可以使用对应入口。两个都装时,适合在同一个项目中比较不同模型和工作流。

参考链接 ​