一、CC GUI 是什么
CC GUI（原名 Claude Code GUI，现更名为 CC GUI）是一款强大的 JetBrains IDE 插件，支持 IntelliJ IDEA、WebStorm、PyCharm 等 JetBrains 全家桶。
它的核心定位是：在 IDE 内提供可视化的 AI 编程对话窗口。
简单来说，它把原本需要在命令行中使用的 Claude Code，变成了 IDE 里一个图形化的操作界面，让你不用离开代码编辑器就能和 AI 对话、生成代码、审查项目。
二、为什么需要 CC GUI
痛点：命令行使用门槛高
Claude Code 原本是一个命令行工具，需要在终端里输入命令来使用。这种方式有几个问题：
- ❌ 对不熟悉命令行的开发者不友好
- ❌ 无法直观看到对话历史
- ❌ 缺少可视化的文件引用和操作
- ❌ 会话管理不方便
CC GUI 的解决方案
CC GUI 搭建了一座桥，把 Claude Code 的能力无缝流入 IDE，成为工作流的一部分。
工具是手的延伸，而不是手的替代。 CC GUI 让 AI 编程变得更直观、更高效。
三、核心功能
1. 双引擎支持
CC GUI 支持两大 AI 编程引擎，可以无缝切换：
| 引擎 | 提供方 | 特点 |
|---|---|---|
| Claude Code | Anthropic | 强大的代码理解和分析能力，支持 Opus 4.5 等模型 |
| OpenAI Codex | OpenAI | 智能代码生成，多语言支持广泛 |
2. 智能对话系统
- @file 引用：直接在对话中引用项目文件，AI 会读取文件内容并响应
- 图片发送：支持发送图片，让 AI 分析 UI 设计或截图
- 对话回退：灵活的对话历史管理，可以回溯到之前的状态
- 上下文感知：AI 能理解当前项目的代码结构和逻辑
3. Agent 系统
内置 Agent 系统，可以自动化执行复杂任务：
- Slash 命令：快速调用预定义功能，如
/init、/review、/simplify等 - Skills 系统：扩展能力包，相当于 AI 的"插件"
web-access：让 AI 可以访问网页frontend-design：根据描述生成前端页面- MCP 扩展：支持 Model Context Protocol，可以调用外部工具
4. 会话管理
- 历史记录：完整的对话历史，支持搜索和筛选
- 会话收藏：重要的对话可以标记为收藏
- 消息导出：支持导出对话内容
- 多会话管理：同时管理多个对话，用 Tab 切换
5. 开发者体验
- 代码 DIFF 对比：查看 AI 修改的代码差异
- 文件导航：快速跳转到相关代码
- 主题切换：支持深色/浅色主题
- 字体同步：与 IDE 字体设置同步
- 国际化：自动在中英文之间切换
四、安装与配置
第一步：确认 IDEA 版本
CC GUI 要求 IntelliJ IDEA 2024.2 或更高版本。
查看版本：Help → About（Mac 为 IntelliJ IDEA → About）
第二步：安装插件
- 打开 IDEA，进入
Settings → Plugins（Mac 为IntelliJ IDEA → Settings → Plugins） - 搜索 "CC GUI" 或 "Claude Code GUI"
- 找到下载量最高、评分≥4.5 星的版本（作者：AI Code Tools）
- 点击 Install，等待安装完成
- 点击 Restart IDE 重启 IDEA
第三步：安装 SDK
首次打开 CC GUI 面板时，会提示安装 Claude Code SDK：
- 点击弹窗中的 "Install SDK" 或 "前往安装"
- 等待约 20 秒，SDK 自动安装完成
第四步：配置模型供应商
CC GUI 支持多种配置方式：
方式一：使用本地 settings.json 授权（推荐）
如果你之前配置过 Claude Code CLI，可以直接复用现有配置：
- 点击供应商设置
- 选择"使用本地 settings.json 授权"
- 填写配置文件路径
方式二：直接配置 API Key
- 获取 API Key（从 Claude 官方或第三方平台）
- 在供应商设置中选择对应的模型提供商
- 粘贴 API Key 保存
方式三：导入 cc-switch 配置
cc-switch 是一个社区工具，可以统一管理多个 AI 工具的 API 配置：
- 下载并安装 cc-switch
- 在 cc-switch 中添加供应商（如 DeepSeek、GLM 等）
- 在 CC GUI 中导入配置
第五步：配置 MCP 扩展（可选）
MCP 让 AI 可以调用外部工具，扩展能力边界：
推荐安装：Chrome Devtools MCP
这个 MCP 可以让 AI 直接调用 Chrome 浏览器，适合：
- 前端测试和调试
- 需要登录态才能复现的 bug
- 特定浏览器环境的问题
配置方式：
1. 打开 CC GUI 的 MCP 面板
2. 添加 MCP 服务器配置
3. 保存并启用
五、实战使用
场景一：代码优化
在 CC GUI 中输入：
帮我优化这个项目的文章阅读统计功能，改成 Redis 缓存方案，先累加 Redis 计数，再定时同步到数据库
AI 会：
1. 分析现有代码结构
2. 检查项目依赖（确认 Redis 配置）
3. 给出优化方案
4. 逐步修改代码（Service 层、Controller 层、定时任务）
场景二：代码审查
使用 Slash 命令：
/review src/main/java/com/example/
AI 会扫描指定目录的代码，给出审查报告和改进建议。
场景三：生成前端页面
使用 Skills：
帮我生成一个用户管理页面，包含表格、搜索框、分页，使用 Ant Design 风格
frontend-design Skills 会自动生成 HTML/CSS 代码。
场景四：引用文件分析
使用 @file 引用：
@ArticleReadService.java 解释这个文件的核心逻辑
AI 会读取文件内容并详细解释。
六、常见问题
Q: 插件市场搜不到 CC GUI？
A: 检查 IDEA 版本是否 ≥2024.2，低版本不支持。
Q: 安装后找不到入口？
A:
- 默认在 IDEA 右侧工具栏
- 或点击 View → Tool Windows → CC GUI 手动调出
Q: 遇到黑屏问题？
A: 部分用户在 IDEA 2026.1 上遇到黑屏，解决方法：
- 清除 IDE 内置浏览器缓存
Help → Edit Custom VM Options- 添加配置：
-Dide.browser.jcef.out-of-process.enabled=false -Dide.browser.jcef.gpu.disable=false - 重启 IDEA
Q: 如何切换模型？
A: 在 CC GUI 面板顶部的模型选择框中选择已配置的供应商。
Q: 支持哪些 JetBrains IDE？
A: 支持 IntelliJ IDEA、WebStorm、PyCharm、GoLand、CLion 等所有 JetBrains IDE。
七、项目状态
CC GUI 目前由社区开发者 zhukunpenglinyutong 维护，项目状态：
- GitHub Star: 2.2k+
- 下载量: 2 万+
- 更新频率: 每周更新
- 最新版本: v0.4.2（2026 年 5 月）
项目地址:
- GitHub: https://github.com/zhukunpenglinyutong/jetbrains-cc-gui
- JetBrains 插件市场: https://plugins.jetbrains.com/plugin/30666-cc-gui
八、总结
CC GUI 的核心价值：让复杂的命令行工具变得简单易用。
它不是要替代你的编码能力，而是成为你手中的延伸工具。通过可视化的界面，让 AI 编程能力无缝融入你的日常工作流。
如果你经常使用 JetBrains IDE，又想用 AI 辅助编程，CC GUI 绝对值得一试。
提示：工具再好，关键还是用好它。保持开放的心态，找到最适合自己的工作流，才是提升效率的关键。