CloudCLI Cloud · 文档 · Discord · 错误报告 · 贡献指南

---

截图

特性

• 响应式设计 - 在桌面、平板和手机上均可无缝运行，因此您也可以在移动设备上使用 Agent
• 交互式聊天界面 - 内置聊天界面，可与 Agent 顺畅沟通
• 集成 Shell 终端 - 通过内置的 shell 功能直接访问 Agent 的 CLI
• 文件浏览器 - 带语法高亮和实时编辑功能的交互式文件树
• Git 浏览器 - 查看、暂存并提交更改，还可切换分支
• 会话管理 - 恢复对话、管理多个会话并追踪历史记录
• 插件系统 - 使用自定义插件扩展 CloudCLI — 添加新标签页、后端服务和集成。构建属于您的插件 →
• TaskMaster AI 集成 (可选) - 基于 AI 的高级项目管理，包括任务规划、PRD 解析和工作流自动化
• 模型兼容性 - 支持 Claude、GPT 和 Gemini 系列模型（完整支持列表请参阅 shared/modelConstants.js）

快速入门

CloudCLI Cloud（推荐）

最快上手方式——无需本地部署。获取完全托管的容器化开发环境，可通过网页、移动应用、API 或您喜爱的 IDE 访问。

立即开始使用 CloudCLI Cloud

自托管（开源）

使用 npx 即刻试用 CloudCLI UI（需 Node.js v22+）：

npx @cloudcli-ai/cloudcli

或以全局方式安装以便日常使用：

npm install -g @cloudcli-ai/cloudcli
cloudcli

打开 http://localhost:3001 — 所有现有会话将自动被发现。

访问 文档 → 以了解更多完整的配置选项、PM2、远程服务器设置等信息

---

哪种方案适合您？

CloudCLI UI 是为 CloudCLI Cloud 提供支持的开源 UI 层。您可以将其自行托管在自己的机器上，也可以使用基于其构建的 CloudCLI Cloud，后者提供完整的托管云环境、团队功能和更深入的集成。

	CloudCLI UI（自托管）	CloudCLI Cloud
最适合	希望在本地机器上为代理会话使用完整 UI 的开发者	希望在云端运行代理、可随时随地访问的团队和开发者
访问方式	通过 [yourip]:port 在浏览器中访问	通过浏览器、任意 IDE、REST API、n8n 访问
设置	npx @cloudcli-ai/cloudcli	无需设置
机器需保持开机	是	否
移动访问	您网络中的任何浏览器	任何设备，原生应用即将推出
可用会话	自动发现 ~/.claude 中的所有会话	您云环境中所有会话
支持的代理	Claude Code、Cursor CLI、Codex、Gemini CLI	Claude Code、Cursor CLI、Codex、Gemini CLI
文件浏览器和 Git	是，内置于 UI 中	是，内置于 UI 中
MCP 配置	通过 UI 管理，并与本地 ~/.claude 配置同步	通过 UI 管理
IDE 访问	您的本地 IDE	连接到您云环境的任何 IDE
REST API	是	是
n8n 节点	否	是
团队共享	否	是
平台成本	免费，开源	起价每月 7 美元

两种方案均使用您自己的 AI 订阅（Claude、Cursor 等）——CloudCLI 提供的是环境，而非 AI。

---

安全与工具配置

🔒 重要提示：所有 Claude Code 工具默认处于禁用状态。这可以防止潜在有害的操作自动执行。

启用工具

要使用 Claude Code 的全部功能，您需要手动启用工具：

1. 打开工具设置 - 点击侧边栏中的齿轮图标
2. 按需启用 - 仅开启您需要的工具
3. 应用设置 - 您的偏好将保存在本地

建议做法：先启用基础工具，根据需要再逐步添加更多。您随时可以调整这些设置。

---

插件

CloudCLI 拥有插件系统，允许您添加带有自有前端界面及可选 Node.js 后端的自定义标签页。您可以在 设置 > 插件 中直接从 Git 仓库安装插件，或自行构建。

可用插件

插件	描述
项目统计	显示当前项目的文件数量、代码行数、文件类型分布、最大文件以及最近修改的文件
Web 终端	具有多标签支持的完整 xterm.js 终端

构建您自己的插件

插件入门模板 → — 分支此仓库以创建您自己的插件。它包含一个可运行的示例，具备前端渲染、实时上下文更新以及与后端服务器的 RPC 通信功能。

插件文档 → — 关于插件 API、清单格式、安全模型等的完整指南。

---

常见问题解答

这与 Claude Code 远程控制有何不同？

Claude Code 远程控制允许您向本地终端中已运行的会话发送消息。您的机器必须保持开机状态，终端窗口也需一直打开，且在约 10 分钟无网络连接的情况下会话将超时退出。

CloudCLI UI 和 CloudCLI Cloud 是对 Claude Code 的扩展，而非与其并列存在——您的 MCP 服务器、权限、设置和会话与 Claude Code 原生使用的完全一致。没有任何内容被复制或单独管理。

具体来说：

• 涵盖所有会话，而不仅限于一个 — CloudCLI UI 会自动发现您 ~/.claude 文件夹中的每一个会话。而远程控制仅暴露当前活动的单一会话，以便在 Claude 移动应用中使用。
• 您的设置即为您的设置 — 您在 CloudCLI UI 中更改的 MCP 服务器、工具权限和项目配置会直接写入您的 Claude Code 配置，并立即生效，反之亦然。
• 支持更多代理 — Claude Code、Cursor CLI、Codex 和 Gemini CLI，而不仅仅是 Claude Code。
• 完整的 UI，而不仅是聊天窗口 — 内置文件浏览器、Git 集成、MCP 管理以及 Shell 终端。
• CloudCLI Cloud 在云端运行 — 即使合上笔记本电脑，代理也会继续运行。无需时刻监控终端，也不必让机器保持唤醒状态。

我是否需要另外付费购买 AI 订阅？

是的。CloudCLI 提供的是运行环境，而非 AI 服务本身。您需要自行准备 Claude、Cursor、Codex 或 Gemini 的订阅。在此基础上，CloudCLI Cloud 的托管环境起步价为每月 7 美元。

我可以在手机上使用 CloudCLI UI 吗？

可以。对于自托管版本，您只需在本地机器上运行服务器，并通过局域网内的任意浏览器访问 [yourip]:port 即可。而对于 CloudCLI Cloud，则可在任何设备上直接访问，无需 VPN、端口转发或额外设置。同时，原生应用也在开发中。

我在 UI 中所做的更改会影响我的本地 Claude Code 设置吗？

是的，对于自托管版本而言。CloudCLI UI 读取并写入与 Claude Code 原生相同的 ~/.claude 配置文件。您通过 UI 添加的 MCP 服务器会立即反映在 Claude Code 中，反之亦然。

---

社区与支持

• 文档 — 安装、配置、功能及故障排除
• Discord — 获取帮助并与其他用户交流
• GitHub Issues — 错误报告与功能请求
• 贡献指南 — 如何参与项目贡献

许可证

GNU Affero 通用公共许可证 v3.0 或更高版本（AGPL-3.0-or-later）— 完整文本请参见 LICENSE，其中包含第 7 条下的附加条款。

本项目遵循 AGPL-3.0-or-later 许可证，属于开源软件，您可以自由使用、修改和分发。如果您修改了该软件并将其作为网络服务运行，则必须向该服务的用户提供您修改后的源代码。

CloudCLI UI - (https://cloudcli.ai)。

致谢

使用的技术

• Claude Code - Anthropic 官方 CLI
• Cursor CLI - Cursor 官方 CLI
• Codex - OpenAI Codex
• Gemini-CLI - Google Gemini CLI
• React - 用户界面库
• Vite - 快速构建工具与开发服务器
• Tailwind CSS - 实用优先的 CSS 框架
• CodeMirror - 高级代码编辑器
• TaskMaster AI (可选) - 基于 AI 的项目管理和任务规划

赞助商

• Siteboon - AI 驱动的网站构建工具

---

Cloud CLI (Claude Code UI) 快速上手指南

Cloud CLI 是一个专为 Claude Code、Cursor CLI、Codex 和 Gemini-CLI 设计的桌面与移动端用户界面。它允许你在本地或远程通过浏览器管理项目、查看会话历史、操作文件系统及 Git，并提供完整的交互式聊天终端。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统：Windows, macOS, 或 Linux
• Node.js：版本需为 v22 或更高（必需）
  • 检查版本命令：node -v
  • 如未安装或版本过低，请访问 Node.js 官网 下载最新版。
• AI 客户端：需预先安装并配置好以下任一 CLI 工具：
  • Claude Code (claude)
  • Cursor CLI (cursor)
  • OpenAI Codex
  • Gemini CLI
• API Key：确保你已拥有对应 AI 服务的有效订阅和 API 密钥（Cloud CLI 仅提供界面环境，不提供 AI 模型本身）。

国内开发者提示：如果访问 npm 源速度较慢，建议在安装前配置淘宝镜像源：

npm config set registry https://registry.npmmirror.com

安装步骤

你可以选择即时运行（无需全局安装）或全局安装（适合频繁使用）。

方式一：即时运行（推荐尝试）

使用 npx 直接启动，无需占用全局空间：

npx @cloudcli-ai/cloudcli

方式二：全局安装

如果你需要经常使用该工具，建议全局安装：

npm install -g @cloudcli-ai/cloudcli

安装完成后，在终端输入以下命令启动服务：

cloudcli

基本使用

1. 启动服务 运行上述安装命令后，终端会显示服务已启动。默认监听地址为 http://localhost:3001。

2. 访问界面 打开浏览器（支持桌面、平板及手机），访问：

   http://localhost:3001
   

   如果是自托管模式且需在手机访问，请确保手机与电脑在同一局域网，并使用 http://[你的电脑IP]:3001 访问。

3. 自动发现会话 进入界面后，系统会自动扫描并加载本地 ~/.claude 目录下的所有现有会话和项目。你可以直接在左侧栏切换不同的 Agent 会话。

4. 启用工具权限（重要） 出于安全考虑，所有 Claude Code 工具默认处于禁用状态。

   • 点击侧边栏的 齿轮图标 (Settings)。
   • 进入 Tools 选项卡。
   • 手动开启你需要的工具（如文件读写、Shell 执行等）。
   • 设置会自动同步至本地的 Claude Code 配置文件。

5. 开始交互

   • 聊天：在中间聊天框输入指令，Agent 将响应并执行任务。
   • 文件管理：使用左侧文件浏览器查看、编辑代码（支持语法高亮）。
   • Git 操作：在 Git 面板中查看变更、暂存文件并提交 commit。
   • 终端：直接使用内置的 Shell 终端运行命令。

现在，你已经成功部署并开始使用 Cloud CLI 来增强你的 AI 编程工作流。