14aef73cc6
* docs: standardize hero badges and language order across README translations * fix: label README command blocks as bash * docs: translate remaining sections to Japanese * fix(readme): remove sponsor duplicate in Japanese readme * fix(readme): japanese translation fixes * fix(readme): remove duplicate sections --------- Co-authored-by: Haile <118998054+blackmammoth@users.noreply.github.com>
9.8 KiB
Cloud CLI（又名 Claude Code UI）
Claude Code、Cursor CLI、Codex 和 Gemini-CLI 的桌面和移动端 UI。可在本地或远程使用，从任何地方查看激活的项目与会话。
CloudCLI Cloud · 文档 · Discord · Bug 报告 · 贡献指南
截图
桌面视图
显示项目概览和聊天的主界面 |
移动体验
具有触控导航的响应式移动设计 |
CLI 选择
在 Claude Code、Gemini、Cursor CLI 与 Codex 之间进行选择 |
|
功能
- 响应式设计 - 在桌面、平板和移动设备上无缝运行，让您随时随地使用 Agents
- 交互聊天界面 - 内置聊天 UI，轻松与 Agents 交流
- 集成 Shell 终端 - 通过内置 shell 功能直接访问 Agents CLI
- 文件浏览器 - 交互式文件树，支持语法高亮与实时编辑
- Git 浏览器 - 查看、暂存并提交更改，还可切换分支
- 会话管理 - 恢复对话、管理多个会话并跟踪历史记录
- 插件系统 - 通过自定义选项卡、后端服务与集成扩展 CloudCLI。 开始构建 →
- TaskMaster AI 集成 (可选) - 结合 AI 任务规划、PRD 分析与工作流自动化，实现高级项目管理
- 模型兼容性 - 支持 Claude、GPT、Gemini 模型家族（完整支持列表见
shared/modelConstants.js）
快速开始
CloudCLI Cloud（推荐）
无需本地设置即可快速启动。提供可通过网络浏览器、移动应用、API 或喜欢的 IDE 访问的完全集装式托管开发环境。
自托管（开源）
启动 CloudCLI UI，只需一行 npx（需要 Node.js v22+）：
npx @siteboon/claude-code-ui
或进行全局安装，便于日常使用：
npm install -g @siteboon/claude-code-ui
cloudcli
打开 http://localhost:3001，系统会自动发现所有现有会话。
更多配置选项、PM2、远程服务器设置等，请参阅 文档 →
哪个选项更适合你？
CloudCLI UI 是 CloudCLI Cloud 的开源 UI 层。你可以在本地机器上自托管它，也可以使用提供团队功能与深入集成的 CloudCLI Cloud。
| CloudCLI UI（自托管） | CloudCLI Cloud | |
|---|---|---|
| 适合对象 | 需要为本地代理会话提供完整 UI 的开发者 | 需要部署在云端，随时从任何地方访问代理的团队与开发者 |
| 访问方式 | 通过 [yourip]:port 在浏览器中访问 |
浏览器、任意 IDE、REST API、n8n |
| 设置 | npx @siteboon/claude-code-ui |
无需设置 |
| 机器需保持开机吗 | 是 | 否 |
| 移动端访问 | 网络内任意浏览器 | 任意设备（原生应用即将推出） |
| 可用会话 | 自动发现 ~/.claude 中的所有会话 |
云端环境内的会话 |
| 支持的 Agents | 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 工具默认禁用，可防止潜在的有害操作自动运行。
启用工具
- 打开工具设置 - 点击侧边栏齿轮图标
- 选择性启用 - 仅启用所需工具
- 应用设置 - 偏好设置保存在本地
工具设置界面 - 只启用你需要的内容
推荐做法: 先启用基础工具，再根据需要添加其他工具。随时可以调整。
插件
CloudCLI 配备插件系统，允许你添加带自定义前端 UI 和可选 Node.js 后端的选项卡。在 Settings > Plugins 中直接从 Git 仓库安装插件，或自行开发。
可用插件
| 插件 | 描述 |
|---|---|
| Project Stats | 展示当前项目的文件数、代码行数、文件类型分布、最大文件以及最近修改的文件 |
自行构建
Plugin Starter Template → — Fork 该仓库以构建自己的插件。示例包括前端渲染、实时上下文更新和 RPC 通信。
插件文档 → — 提供插件 API、清单格式、安全模型等完整指南。
常见问题
与 Claude Code Remote Control 有何不同？
Claude Code Remote Control 让你发送消息到本地终端中已经运行的会话。该方式要求你的机器保持开机，终端保持开启，断开网络后约 10 分钟会话会超时。
CloudCLI UI 与 CloudCLI Cloud 是对 Claude Code 的扩展，而非旁观 — MCP 服务器、权限、设置、会话与 Claude Code 完全一致。
- 覆盖全部会话 — CloudCLI UI 会自动扫描
~/.claude文件夹中的每个会话。Remote Control 只暴露当前活动的会话。 - 设置统一 — 在 CloudCLI UI 中修改的 MCP、工具权限等设置会立即写入 Claude Code。
- 支持更多 Agents — Claude Code、Cursor CLI、Codex、Gemini CLI。
- 完整 UI — 除了聊天界面，还包括文件浏览器、Git 集成、MCP 管理和 Shell 终端。
- CloudCLI Cloud 保持运行于云端 — 关闭本地设备也不会中断代理运行，无需监控终端。
需要额外购买 AI 订阅吗？
需要。CloudCLI 只提供环境。你仍需自行获取 Claude、Cursor、Codex 或 Gemini 订阅。CloudCLI Cloud 从 $7/月起提供托管环境。
能在手机上使用 CloudCLI UI 吗？
可以。自托管时，在你的设备上运行服务器，然后在网络中的任意浏览器打开 [yourip]:port。CloudCLI Cloud 可从任意设备访问，内置原生应用也在开发中。
UI 中的更改会影响本地 Claude Code 配置吗？
会的。自托管模式下，CloudCLI UI 读取并写入 Claude Code 使用的 ~/.claude 配置。通过 UI 添加的 MCP 服务器会立即在 Claude Code 中可见。
社区与支持
- 文档 — 安装、配置、功能与故障排除指南
- Discord — 获取帮助并与社区交流
- GitHub Issues — 报告 Bug 与建议功能
- 贡献指南 — 如何参与项目贡献
许可证
GNU 通用公共许可证 v3.0 - 详见 LICENSE 文件。
该项目为开源软件，在 GPL v3 许可证下可自由使用、修改与分发。
致谢
使用技术
- 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 驱动的项目管理与任务规划