CCGUI(开源跨平台AI代码可视化客户端)

CCGUI是什么

CCGUI官方别名MossX，是基于Tauri2+Rust+React19打造的跨平台CLI AI编程可视化桌面客户端，它将多款主流命令行AI代码智能体整合至统一图形界面，无需频繁切换终端、编辑器，一站式完成代码编写、项目重构、Bug修复、Git提交、任务管理全流程开发工作，数据全部本地持久化存储，不强制上传项目代码至第三方云端，兼顾效率与代码隐私安全，兼容Windows、macOS、Linux三大桌面系统。

1. 底层技术架构

软件采用前后端分离原生Tauri架构，Rust负责底层系统交互、文件读写、终端调度，React+TS搭建轻量化前端界面，Vite构建打包，安装包体积小巧、启动速度快、内存占用低；内置xterm原生终端、CodeMirror6代码高亮、Whisper语音识别，支持10余种编程语言语法渲染，UI支持中英文双语切换，自带21款VS Code衍生主题自定义界面样式。

2. 多引擎兼容底层逻辑

CCGUI不绑定单一AI服务商，兼容四大主流CLI编程智能体：Claude Code、OpenAI Codex CLI、Gemini CLI、OpenCode，软件可自动检测本地全局安装的CLI工具，未检测时支持手动配置工具路径与API密钥；支持MCP模型上下文协议扩展，可接入自定义MCP服务拓展数据库查询、网页抓取等外部工具能力。

3. 数据安全机制

所有对话记录、项目索引、配置文件、Token用量统计均保存在本地设备，AI接口请求数据仅同步至对应模型服务商，软件本身不收集、不上传用户代码、项目文件、API密钥；支持会话导出本地备份，会话数据可一键清空，无云端强制存储限制。

软件功能

（一）多AI引擎统一管控功能

1. 多服务商一键切换，独立管理各引擎API密钥、模型参数、上下文窗口大小；

2. Token用量实时统计，单会话/月度预估费用展示，自定义预算上限提醒；

3. 会话持久保存，支持会话分叉、复制、回溯、收藏、批量导出；

4. 浏览器代理组件，允许AI抓取网页内容作为代码开发参考上下文。

（二）可视化编码对话画布

1. @文件快捷引用项目任意文件，/斜杠命令快速调用代码审查、初始化、重构等预设指令；

2. 支持图片粘贴、本地文件附件上传、语音输入转文字指令；

3. AI文件修改、Shell脚本执行过程可视化Diff对比，修改内容实时预览；

4. 多指令排队发送，批量提交开发需求，无需等待单条对话完成。

（三）一体化内置开发面板

1. 文件树面板：拖拽文件至对话、批量重命名、预览、删除、目录检索；

2. 原生终端面板：直接执行CLI脚本、运行测试命令，与AI执行流程联动；

3. Git全功能面板：文件暂存、AI自动生成提交注释、分支切换、代码差异对比、提交历史查看、推拉远程仓库；

4. 全局检索：跨会话、全项目文件、任务日志关键词一键搜索。

（四）智能项目任务管理体系

1. 计划面板：分步展示AI执行流程，实时追踪任务进度，定位代码执行卡点；

2. Kanban任务看板：拖拽任务卡片管理迭代需求，区分待处理、进行中、已完成任务；

3. 任务中心：查看完整运行日志，支持任务重试、取消、分叉复制；

4. 意图画布：可视化梳理开发思路，AI根据画布规划分步编写代码。

（五）项目智能分析功能

1. 项目地图：自动扫描代码生成交互式依赖图谱，展示模块、API、文件关联关系；

2. 项目记忆库：存储项目规范、业务逻辑、历史开发经验，@@指令快速注入上下文；

3. 上下文账本：统计每条上下文来源、Token消耗、内容置信度，精简无效参考信息。

（六）个性化与扩展功能

1. UI自定义：窗口透明度、字体大小、快捷键、深浅色主题自由调整；

2. MCP插件市场：可视化管理MCP服务，一键启用开发工具插件；

3. 全量国际化，适配简体中文、英文、日语、韩语多语言界面；

4. 跨平台自动更新，离线本地配置备份导入导出。

软件特色

1. 无终端依赖可视化操作：彻底告别黑框命令行，图形界面完成全部CLI AI代码操作，降低新手使用门槛；

2. 四大赛事AI编程引擎一站式集成：市面唯一同时兼容Claude Code、Codex、Gemini、OpenCode的独立桌面客户端，无需安装多款配套GUI工具；

3. 完整项目级智能能力：独有项目图谱、本地记忆库、任务看板体系，同类CLI可视化工具极少具备项目全局分析能力；

4. 全平台原生轻量化：Tauri原生架构，无Electron臃肿体积，Windows/macOS/Linux完整适配，低配电脑流畅运行；

5. 100%本地数据存储：核心开发数据不经过第三方服务器，企业、独立开发者保障源码隐私；

6. 完全开源永久免费：MIT协议开放全部源代码，无功能阉割、无订阅付费、无广告，可自行二次编译修改；

7. 开发全链路一体化：对话、文件、终端、Git、任务管理整合单软件，无需编辑器、终端、Git工具多窗口切换。

使用方法

步骤1：前置环境准备

1. 安装Node.js≥20稳定版本，用于运行各类AI CLI引擎；

2. 根据需求全局安装对应AI编程工具：npm install -g @anthropic-ai/claude-code、Codex CLI、Gemini CLI等；

3. Windows系统安装VC++构建工具，macOS安装Xcode命令行工具，Linux安装webkit2gtk依赖。

步骤2：软件安装

方式A（二进制安装包，推荐普通用户）

1. 前往GitHub Releases页面下载对应系统安装包：Windows(.exe)、macOS(.dmg)、Linux(AppImage)；

2. 双击安装包，跟随向导完成安装，启动CCGUI；
   方式B（源码编译，开发者）

git clone https://github.com/zhukunpenglinyutong/desktop-cc-gui
cd desktop-cc-gui
npm install
npm run tauri dev # 本地调试
npm run tauri build # 编译安装包

步骤3：AI引擎配置

1. 打开软件设置-供应商管理，软件自动检测本地已安装的Claude/Codex/Gemini CLI；

2. 未自动识别时，手动指定npm全局包路径，粘贴对应平台API密钥；

3. 自定义模型参数、上下文窗口、月度Token预算，保存配置。

步骤4：新建项目开始开发

1. 在首页选择本地代码文件夹作为工作区，软件自动扫描生成项目文件树与项目图谱；

2. 左侧对话画布输入开发需求，使用@引用文件、/调用快捷指令；

3. 查看AI执行计划、终端输出、代码修改Diff，通过Git面板提交代码；

4. 复杂开发需求拖拽至Kanban看板拆分迭代任务，在任务中心管理执行流程。

适合人群

1. 习惯使用Claude/Codex/Gemini CLI命令行的后端、全栈开发者：厌烦纯终端操作，需要可视化界面简化开发流程；

2. 独立开源项目开发者、个人外包程序员：重视源码隐私，需要本地存储、不上传代码的AI编程工具；

3. 学生编程学习者：免费开源无付费门槛，可视化流程更易看懂AI代码执行逻辑；

4. 多模型轮换使用工程师：同时使用Claude、GPT、Gemini系列代码模型，需要统一管理入口；

5. 轻量化开发需求用户：不想安装VS Code、Cursor等重型IDE，仅需AI代码辅助工具；

6. Linux桌面开发者：市面多数AI编程客户端对Linux适配较差，CCGUI原生支持Linux全发行版。

收费价格

CCGUI软件本体永久免费开源，无任何付费功能、无订阅套餐、无广告、无水印，遵循MIT开源协议，个人、商业项目均可免费使用，可自由二次分发、修改源码。

仅产生费用为用户自行使用的第三方AI模型API服务费（Claude、OpenAI、Gemini官方收费，由对应服务商收取，CCGUI不抽取中间手续费），软件内置Token统计功能，实时查看API消耗成本。

竞品对比

常见问题解答（FAQ）

Q：CCGUI和JetBrains插件版CC GUI是同一款产品吗？

不是，二者为同作者开发的两套独立产品，desktop-cc-gui是独立跨平台桌面软件，JetBrains CC GUI是IDEA专用IDE插件，运行载体、功能边界完全区分，互不通用。

Q：使用CCGUI必须付费购买Claude Pro账号吗？

软件本身免费，Claude Code CLI工具需要Anthropic付费订阅账号才能调用；若使用Codex、Gemini引擎，则对应需要OpenAI、Google官方API密钥，软件不强制绑定任意付费订阅。

Q：离线状态下CCGUI能否正常打开查看历史对话？

可以，所有对话、项目配置、任务记录均本地存储，断网离线可完整查看历史数据；仅发送新AI指令时需要联网调用对应模型API。

Q：Linux系统哪些发行版可以正常运行CCGUI？

支持Ubuntu、Fedora、Arch、Debian主流Linux发行版，提供AppImage单文件安装包，仅需提前安装webkit2gtk基础依赖库即可。

Q：CCGUI会读取并上传我本地完整项目代码到服务器吗？

不会，软件仅在发起AI请求时，主动推送用户选择的文件片段至对应AI服务商接口，软件自身无后台上传程序，完整项目源码永久保存在本地设备。

Q：是否支持国产大模型CLI工具接入CCGUI？

支持，软件自定义供应商配置面板，可手动填写国产模型CLI服务地址、API密钥，接入通义、文心等自研代码大模型命令行工具。

Q：更新软件新版本后，本地会话记录会丢失吗？

不会，软件配置与会话文件独立存储，升级安装包不会删除本地数据，重装系统前手动备份软件配置文件夹即可完整迁移所有记录。

Q：低配笔记本电脑运行CCGUI会不会卡顿？

不会，基于Tauri轻量化架构开发，安装包仅10MB左右，内存占用远低于Electron类软件，4G内存电脑即可流畅运行。

总结

CCGUI（MossX）是当前为数不多的开源免费多引擎CLI AI代码可视化桌面工具，精准解决传统命令行AI编程工具操作繁琐、无项目管理、多模型切换不便、数据云端存储等痛点，依托Tauri轻量化架构实现全平台原生适配，整合对话画布、内置终端、Git、任务看板、项目图谱全套开发能力，兼顾独立开发者、学生、企业开发人员的隐私与效率需求，无付费门槛、开放源代码可自由二次开发，适合所有使用Claude、Codex、Gemini等CLI代码智能体的开发者作为日常辅助工具。