一、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 编程引擎，可以无缝切换：

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）

第二步：安装插件

1. 打开 IDEA，进入 Settings → Plugins（Mac 为 IntelliJ IDEA → Settings → Plugins）
2. 搜索 "CC GUI" 或 "Claude Code GUI"
3. 找到下载量最高、评分≥4.5 星的版本（作者：AI Code Tools）
4. 点击 Install，等待安装完成
5. 点击 Restart IDE 重启 IDEA

第三步：安装 SDK

首次打开 CC GUI 面板时，会提示安装 Claude Code SDK：

1. 点击弹窗中的 "Install SDK" 或 "前往安装"
2. 等待约 20 秒，SDK 自动安装完成

第四步：配置模型供应商

CC GUI 支持多种配置方式：

方式一：使用本地 settings.json 授权（推荐）

如果你之前配置过 Claude Code CLI，可以直接复用现有配置：

1. 点击供应商设置
2. 选择"使用本地 settings.json 授权"
3. 填写配置文件路径

方式二：直接配置 API Key

1. 获取 API Key（从 Claude 官方或第三方平台）
2. 在供应商设置中选择对应的模型提供商
3. 粘贴 API Key 保存

方式三：导入 cc-switch 配置

cc-switch 是一个社区工具，可以统一管理多个 AI 工具的 API 配置：

1. 下载并安装 cc-switch
2. 在 cc-switch 中添加供应商（如 DeepSeek、GLM 等）
3. 在 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 上遇到黑屏，解决方法：

1. 清除 IDE 内置浏览器缓存
2. Help → Edit Custom VM Options
3. 添加配置：
   -Dide.browser.jcef.out-of-process.enabled=false -Dide.browser.jcef.gpu.disable=false
4. 重启 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 绝对值得一试。

提示：工具再好，关键还是用好它。保持开放的心态，找到最适合自己的工作流，才是提升效率的关键。