功能

• Shell-first 工作区 - 围绕持久化 shell 会话，而不是 chat-first 流程
• 多 provider Shell - 在同一套 UI 中启动 Claude Code、Codex、Cursor 风格会话、Gemini CLI 或系统 Shell
• 按项目保留 Shell 历史 - 切换项目后可恢复对应 shell 工作区
• Provider 感知的新建 Shell - 在头部直接按 provider 创建 shell，并显示对应图标
• 响应式设计 - 支持桌面、平板与移动端
• 文件浏览器 - 交互式文件树，支持语法高亮与实时编辑
• Git 浏览器 - 查看、暂存并提交改动，也可切换分支
• 会话管理 - 在侧边栏浏览项目与 session 历史
• 插件系统 - 通过自定义标签页、后端服务与集成扩展 UI。开始构建 →
• TaskMaster AI 集成 (可选) - AI 任务规划、PRD 分析与工作流自动化
• 模型兼容性 - 支持 Claude、GPT、Gemini 模型家族（完整列表见 shared/modelConstants.js）

快速开始

自托管

使用 npx 立即运行这个 fork（需要 Node.js v22+）：

npx @luzedong/claude-code-ui

或全局安装：

npm install -g @luzedong/claude-code-ui
cloudcli

打开 http://localhost:3001，系统会自动发现本地已有项目与会话。

从源码运行

git clone https://github.com/luzedong/claudecodeui.git
cd claudecodeui
npm install
npm run dev

包与链接

• npm: @luzedong/claude-code-ui
• GitHub: luzedong/claudecodeui

哪个选项更适合你？

这个 fork 面向希望在本地 CLI 工具之上使用 shell-first UI 的开发者。

| | luzedong fork | |---|---| | 适合对象 | 需要本地 agent 会话 shell-first UI 的开发者 | | 访问方式 | 浏览器通过 [yourip]:port 访问 | | 安装方式 | npx @luzedong/claude-code-ui | | 机器需保持开机 | 是 | | 移动端访问 | 网络内任意浏览器 | | 可用会话 | 自动发现本地项目与 session 历史 | | 支持 Agents | Claude Code、Cursor CLI、Codex、Gemini CLI | | Files / Git / MCP | UI 内置 | | 包名 | @luzedong/claude-code-ui |

🔒 重要提示: 所有 Claude Code 工具默认禁用，可防止潜在的有害操作自动运行。

启用工具

1. 打开工具设置 - 点击侧边栏齿轮图标
2. 选择性启用 - 仅启用所需工具
3. 应用设置 - 偏好设置保存在本地

工具设置界面 - 只启用你需要的内容

推荐做法: 先启用基础工具，再根据需要添加其他工具。随时可以调整。

插件

CloudCLI 配备插件系统，允许你添加带自定义前端 UI 和可选 Node.js 后端的选项卡。在 Settings > Plugins 中直接从 Git 仓库安装插件，或自行开发。

可用插件

| 插件 | 描述 | |---|---| | Project Stats | 展示当前项目的文件数、代码行数、文件类型分布、最大文件以及最近修改的文件 |

自行构建

Plugin Starter Template → — Fork 该仓库以构建自己的插件。示例包括前端渲染、实时上下文更新和 RPC 通信。

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

常见问题

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 保持运行于云端 — 关闭本地设备也不会中断代理运行，无需监控终端。

需要。CloudCLI 只提供环境。你仍需自行获取 Claude、Cursor、Codex 或 Gemini 订阅。CloudCLI Cloud 从 $7/月起提供托管环境。

可以。自托管时，在你的设备上运行服务器，然后在网络中的任意浏览器打开 [yourip]:port。CloudCLI Cloud 可从任意设备访问，内置原生应用也在开发中。

会的。自托管模式下，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 驱动的项目管理与任务规划

赞助商

• Siteboon - AI powered website builder