> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mossx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CC GUI 客户端简介

> 用独立桌面客户端统一使用 Claude Code、Codex、OpenCode、Grok、Kimi、Pi 和 DeepSeek Harness。

**CC GUI 客户端**（应用名 **ccgui**，也称 **CCGUI** / **ccgui**）是开源的 AI 编程桌面应用。它把多个命令行 AI 编程 runtime 放进同一个图形界面，让你像聊天一样写代码、改 Bug、提交 Git。

当前应用标识为 `com.zhukunpenglinyutong.ccgui`，基于 **Tauri 2 + React + Rust**，支持 macOS / Windows / Linux。

<Note>
  CC GUI 是独立开源项目，与 Anthropic、OpenAI、Google 及其他第三方工具厂商无隶属、背书或赞助关系。
</Note>

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/app-overview.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=c65450255166dd956fc337300bfcda29" alt="客户端主界面总览" width="100%" data-path="images/desktop/app-overview.png" />

## 它能做什么

* 在一个客户端里切换 Claude Code、Codex、OpenCode、Grok、Kimi、Pi、DeepSeek Harness 等 runtime。
* 用 `@` 引用文件、`@@` 项目记忆、`@#` 笔记、`/` 斜杠命令、`$` 技能、`!` 提示词；智能体多从输入工具条选择。
* 内置文件树、终端、Git 面板、全局搜索、Plan 面板。
* 管理已配置的 MCP、Skills、Agents、提示词库和权限确认。
* 项目知识地图、项目记忆、上下文账本等客户端独有能力。
* 应用内自动更新。

## 支持的运行时

| 状态   | 名称                     | 说明                         |
| ---- | ---------------------- | -------------------------- |
| 可用   | Claude Code            | 功能最完整的主线 runtime           |
| 可用   | Codex CLI              | OpenAI Codex 生态            |
| 可用   | Kimi CLI               | 本机 `kimi`                  |
| 可用   | Grok CLI               | 本机 `grok`                  |
| 可用   | OpenCode               | 本机 `opencode`（可移到 **未启用**） |
| 可用   | PI CLI                 | 本机 `pi`                    |
| 可用   | DeepSeek Harness (DSH) | 宿主 runtime（host/port）      |
| 暂未开放 | Gemini CLI 等           | 出现在「暂未开放」分组，本文档不写为已交付      |

<Note>
  MCP / Plugin marketplace 入口当前仍是 **Coming Soon**。README 里关于 Gemini 默认启用的表述已过时，以客户端设置页为准。
</Note>

## 和其他端的关系

CC GUI 还有 VS Code 扩展、JetBrains 插件和手机端。对话与供应商思路相通；文件树、内置终端、项目知识地图、项目记忆、多工作区管理只属于客户端。

配置方面：`~/.ccgui/config.json` 的供应商结构与 JetBrains 端可共享；会话与 UI 状态不保证跨端完全互通。

本系列文档只写桌面客户端。侧栏分组：快速开始、详细介绍、供应商 / CLI、进阶使用、社区。各引擎单独成页，检测与安装共用一页。

## 从这里开始

<Columns cols={2}>
  <Card title="下载安装" icon="download" href="/desktop/start/install">
    从 GitHub Releases 安装 macOS / Windows / Linux 包。
  </Card>

  <Card title="准备环境" icon="wrench" href="/desktop/start/setup">
    配好 runtime、API Key 和各引擎 CLI。
  </Card>

  <Card title="供应商 / CLI" icon="boxes" href="/desktop/providers/overview">
    Claude、Codex、Kimi、Grok、OpenCode、Pi、DSH 各自成页。
  </Card>

  <Card title="发出第一条消息" icon="message-square" href="/desktop/start/first-task">
    添加项目、选供应商、完成第一次对话。
  </Card>

  <Card title="看懂界面" icon="layout-dashboard" href="/desktop/start/interface">
    首页、对话、文件树、Git、终端和设置。
  </Card>
</Columns>