# @cloudcli-ai/cloudcli 中文文档 规范地址：https://npmcn.com/package/%40cloudcli-ai/cloudcli/ 版本：1\.37\.8 npm 元数据更新时间：2026-11-07T13:57:12.950Z 中文译文更新时间：2026-11-10T02:47:01.245Z 软件包许可：AGPL-3\.0-or-later 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40cloudcli-ai/cloudcli 原文对照：https://npmcn.com/package/%40cloudcli-ai/cloudcli/?lang=original 项目主页：https://cloudcli.ai/ 源码仓库：https://github.com/siteboon/claudecodeui ## 关键信息（来自 npm 元数据） - 包体积（解压后）：20.1 MB，1152 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - 运行依赖：64 个 - 首次发布：2026-04-03T15:40:56.283Z - 最新版本发布：2026-11-07T13:57:12.623Z - 近 30 天下载量：23478（2026-10-10 至 2026-11-08，npm 官方下载统计） - 已发布版本数：36（近 12 个月 36 个） ## 中文简介 Claude 代码 CLI 的网络用户界面 ## 安装 ```sh npm install @cloudcli-ai/cloudcli ``` 也可以使用：`pnpm add @cloudcli-ai/cloudcli`、`yarn add @cloudcli-ai/cloudcli`、`bun add @cloudcli-ai/cloudcli` ## README ![CloudCLI UI](https://npmcn.com/package/%40cloudcli-ai/cloudcli/public/logo.svg) # Cloud CLI( 克劳德代码 UI) 用于桌面和移动 UI [克劳德代码](https://docs.anthropic.com/en/docs/claude-code), (中文(简体) ), [光标 CLI](https://docs.cursor.com/en/cli/overview),以及 [代码](https://developers.openai.com/codex)。 。 。 . 在本地或远程查看您正在运行的项目和会话. [云CLI 云雾](https://cloudcli.ai/) • 妇女 [文档](https://cloudcli.ai/docs) • 妇女 [解析器](https://discord.gg/buxwujPNRE) • 妇女 [错误报告](https://github.com/siteboon/claudecodeui/issues) • 妇女 [捐款](https://npmcn.com/package/%40cloudcli-ai/cloudcli/CONTRIBUTING.md) [![CloudCLI Cloud](https://img.shields.io/badge/%E2%98%81%EF%B8%8F_CloudCLI_Cloud-Try_Now-0066FF?style=for-the-badge)](https://cloudcli.ai/) [![Join our Discord](https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/buxwujPNRE) [![siteboon%2Fclaudecodeui | Trendshift](https://trendshift.io/api/badge/repositories/15586)](https://trendshift.io/repositories/15586) _**联合国** • 妇女 [Русский](https://npmcn.com/package/%40cloudcli-ai/cloudcli/docs/README.ru.md) • 妇女 [德国](https://npmcn.com/package/%40cloudcli-ai/cloudcli/docs/README.de.md) • 妇女 [한국어](https://npmcn.com/package/%40cloudcli-ai/cloudcli/docs/README.ko.md) • 妇女 [简体中文](https://npmcn.com/package/%40cloudcli-ai/cloudcli/docs/README.zh-CN.md) • 妇女 [繁體中文](https://npmcn.com/package/%40cloudcli-ai/cloudcli/docs/README.zh-TW.md) • 妇女 [日本語](https://npmcn.com/package/%40cloudcli-ai/cloudcli/docs/README.ja.md) • 妇女 [蒂尔克切](https://npmcn.com/package/%40cloudcli-ai/cloudcli/docs/README.tr.md) • 妇女 [印度尼西亚](https://npmcn.com/package/%40cloudcli-ai/cloudcli/docs/README.id.md)_ * * * ## 截图

桌面视图

Desktop Interface
显示项目概况和聊天的主要接口

移动经验

Mobile Interface
带有触摸导航的响应性移动设计

CLI 选择

CLI Selection
在克劳德代码、 Cursor CLI 和 Codex 之间选择
## 特征 - **响应设计** - 在桌面、平板电脑和移动设备之间无缝工作,这样也可以使用移动设备的代理 - **交互式聊天界面** - 与代理人进行无缝通信的内置聊天接口 - **综合壳牌终端** - 通过内置外壳功能直接进入代理人CLI - **文件浏览器** - 交互式文件树,带有语法突出显示和活编辑 - **Git 浏览器** - 查看,舞台和输入您的修改。 也可以切换分枝 - **浏览器使用** - 为网页研究、测试和代理驱动的浏览器任务开放浏览器会议 - **会话管理** - 恢复对话,管理多个会话,跟踪历史 - **插件系统** - 以自定义插件来扩展 CloudCLI —— 添加新的标签,后端服务,以及集成. [自己盖起](https://github.com/cloudcli-ai/cloudcli-plugin-starter) - **任务主 AI 整合** _(备选)_ - 高级项目管理,包括人工智能任务规划、PRD解析和工作流程自动化 - **模型兼容性** - 与克洛德和GPT模式家庭合作(支助模式的全部清单通过运行时间提供) `GET /api/providers/:provider/models`(中文(简体) ) ## 快速启动 ### 云CLI云 (建议) 最快的起动方式——不需要本地设置. 从网络、移动应用程序、API或你最喜欢的IDE中获取一个完全管理、集装箱化的开发环境. **[开始云CLI云](https://cloudcli.ai/)** ### 自建( 开放源码) #### 无 立即尝试 CloudCLI UI **npx 数据** (所需经费) **节点.js** v22+): (中文(简体) ) ``` npx @cloudcli-ai/cloudcli ``` 或者安装 **全球** 用于经常用途: ``` npm install -g @cloudcli-ai/cloudcli cloudcli ``` 打开 `http://localhost:3001` ——您所有现有的会话都是自动发现的. 访问 **[∗∗∗](https://cloudcli.ai/docs)** 用于完整的配置选项, PM2, 远程服务器设置等. #### Docker Sandboxes (实验) (实验) 在孤立的沙盒中运行特工 具有超视星等隔离。 默认启动 Claude 代码 。 要求 [`sbx` 国 际](https://docs.docker.com/ai/sandboxes/get-started/)。 。 。 . ``` npx @cloudcli-ai/cloudcli@latest sandbox ~/my-project ``` 支持克洛德代码和代码. 见 [沙盒文档](https://npmcn.com/package/%40cloudcli-ai/cloudcli/docker/) 用于设置和高级选项. ### 桌面辅助应用程序 CloudCLI桌面是CloudCLI Cloud和Llocal CloudCLI的可选本地伴侣. 它从这个寄存器的 GitHub 发布器中运出 并且从您的菜单栏或托盘中保留 CloudCLI . - **[马科斯](https://cloudcli.ai/download/macos)** - **[窗口](https://cloudcli.ai/download/windows)** - **[下载页面](https://cloudcli.ai/download)** • 妇女 **[GitHub 发布和校验和](https://github.com/siteboon/claudecodeui/releases)** 用于打开CloudCLI Cloud环境,切换本地和远程工作空间,并复制移动/浏览器URL. 要在当地工作,选择 **当地 CloudCLI** 在桌面应用程序中; 它会使用您运行的本地服务器或为您启动一个服务器 . * * * ## 哪个选择适合你? CloudCLI UI是开源UI层,能给CloudCLI Cloud提供动力. 你可以在自己的机器上自行主机,在多克沙盒中运行以隔离,或者使用CloudCLI Cloud来完全管理环境. | | 自带( npm) | 自设套座( Docker Sandbox) _(经验)_ | 云CLI 云雾 | | --- | --- | --- | --- | | **最好还是** | 在您的机器上进行本地代理会话 | 带有网络/移动 IDE 的孤立剂 | 在云中寻找特工的队伍 | | **你如何访问它** | 浏览器通过 `[yourip]:port` | 浏览器通过 `localhost:port` | 浏览器,任意 IDE, REST API, n8n | | **设置** | `npx @cloudcli-ai/cloudcli` | `npx @cloudcli-ai/cloudcli@latest sandbox ~/project` | 不需要设置 | | **隔离** | 运行在主机上 | 超显相相级沙盒( 微VM) | 全云隔离 | | **机器需要继续** | 对 | 对 | 没有 | | **移动接入** | 您网络上的任何浏览器 | 您网络上的任何浏览器 | 任何设备 | | **桌面伴侣** | 可选的 选择本地 CloudCLI | 可选的 选择本地 CloudCLI | 可选的 打开云环境 | | **支助代理人** | Claude 代码, 光标 CLI, 代码 | Claude Code, 代码 | Claude 代码, 光标 CLI, 代码 | | **文件探索者和 Git** | 对 | 对 | 对 | | **MCP 配置** | 与 `~/.claude` | 通过UI管理 | 通过UI管理 | | **(原始内容存档于2013-10-12) (英语). REST API** | 对 | 对 | 对 | | **团队共享** | 没有 | 没有 | 对 | | **平台费用** | 自由、开源 | 自由、开源 | 开始为7欧元/月 | > 所有选项都使用您自己的AI订阅(Claude, Cursor等)——CloudCLI提供环境,而不是AI. * * * ## 安全工具配置( T) **重要通知**: 所有 Claude 代码工具都是 **默认禁用**。这可以防止潜在有害操作自动运行. ### 启用工具 要使用Claude Code的全部功能,你需要手动启用工具: 1. **打开工具设置** - 点击侧边栏中的齿轮图标 2. **选择性启用** - 打开你需要的工具 3. **应用设置** - 您的首选项是本地保存的 ![Tools Settings Modal](https://npmcn.com/package/%40cloudcli-ai/cloudcli/public/screenshots/tools-modal.png) _工具设置接口 - 只允许您需要的_ **建议的办法**:从启用的基本工具开始,并视需要增加更多的工具。 您可以在稍后调整这些设置 . * * * ## 插件 CloudCLI有一个插件系统,可以让您添加自定义标签,其中包含自己的前端UI和可选的Node.js后端. 从 git repos 直接安装插件 **设置 > 插件**,或者建立你自己. ### 可用的插件 | 插件 | 说明 | | --- | --- | | **[项目Stats](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** | 显示当前项目的文件计数、 代码行、 文件类型分解、 最大文件以及最近修改的文件 | | **[Web 终端](https://github.com/cloudcli-ai/cloudcli-plugin-terminal)** | 多塔布支持的全xterm.js终端 | | **[CloudCLI 调度器](https://github.com/grostim/cloudcli-cron)** | 通过 Codex 或 Claude 代码等本地的 CLI 创建工作空间范围调度提示并执行 | | **[PRISM CloudCLI (英语)](https://github.com/jakeefr/cloudcli-plugin-prism)** | CloudCLI 内部 Claude Code 的会话智能, 包括符号燃烧能见度 | | **[会议](https://github.com/strykereye2/cloudcli-plugin-session-manager)** | 查看、管理和杀死活动中的 Claude 代码会话 | | **[Token 成本计算器](https://github.com/NightmareAway/cloudcli-plugin-token-cost-calculator)** | 根据模型价格和象征性用途计算API成本,并预设模型定价支持 | | **[任务队列](https://github.com/TadMSTR/cloudcli-plugin-task-queue)** | 任务队列仪表板以查看、过滤和启动代理任务 | | **[GitHub 问题委员会](https://github.com/szmidtpiotr/claude-github-issue)** | GitHub 问题的 Kanban 棋盘, 双向 TaskMaster 同步和 /github- task CLI 技能自动安装 | | **[页:1](https://github.com/AaronWong1999/cloudcli-plugin-ccx)** | 显示 Claude 和 Codex 的用法, 并将打开的会话随其对话历史(macOS, 需要 ccx) 交给其他代理 | ### 建立你自己 **[插件启动模板](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** ——叉出此回放来创建自己的插件. 它包括一个具有前端渲染,活上下文更新,以及RPC通信到后端服务器的工作实例. **[插件文档 –](https://cloudcli.ai/docs/plugin-overview)** ——插件API的完整指南,显示格式,安全模型等. ### 私人仓库 服务器安装和更新插件 `git clone` 财务报告和审定财务报表 `git pull`,使用它运行的操作系统用户的 git 证书作为(系统化服务,单位的) `User=`) (中文(简体) ). 服务器无法在安装时回答密码或密码句, 因此在从私人仓库安装之前为该用户设置证书 : - **`https://` URL :** 例如, 配置 git 证书助手 `gh auth login` 接下来是 `gh auth setup-git`,或者在 `~/.git-credentials` 与 `git config --global credential.helper store`。 。 。 . - **`git@` URL :** 给用户一个 git 主机接受的 SSH 密钥, 而该密钥在不提示的情况下有效 : 它要么没有密码句, 要么被装入一个 `ssh-agent` 谁 `SSH_AUTH_SOCK` 服务器进程继承。 将主机添加到该用户的 `~/.ssh/known_hosts`,例如通过运行 `ssh -T git@github.com` 曾经是一个用户. 无全权证书 `https://` 安装失败, 信件中写着寄存器为私有或不存在 。 大多数git主机,包括GitHub,都以同样的方式回答两者. 如果主机拒绝证书(错误、过期或被吊销),或 Ssh 无法登录 `git@` URL,消息是这样说的. * * * ## 财务问题 这和克洛德密码遥控有什么不同? Claude 代码远程控制允许您向您本地终端已经运行的会话发送消息 。 你的机器必须保持正常运行 你的终端必须保持开放 大约10分钟后会话中断 没有网络连接. CloudCLI UI和CloudCLI Cloud扩展了Claude Code而不是与它并列——您的MCP服务器,权限,设置,和会话都是Claude Code本土使用的完全相同的. 任何情况都不重复或单独管理. 在实践中,这意味着: - **你所有的会议,不只是一次** —— CloudCLI UI 自动从您的每次会话中发现 `~/.claude` 文件夹。 远程控制只曝光单个活动会话,以在克洛德移动应用中提供. - **您的设置是您的设置** —— MCP 服务器,工具权限,以及您在 CloudCLI UI 中更改的项目配置直接写入您的 Claude 代码配置并立即生效,反之亦然. - **和更多探员合作** ——克洛德代码(Claude Code),Cursor CLI和Codex,不仅仅是克洛德代码. - **完整用户界面, 不只是聊天窗口** ——文件探险家,Git集成,MCP管理,以及一个外壳终端均被建入. - **云层CLI 云在云中飘来飘去** - 关闭你的笔记本电脑, 代理继续运行。 没有终端来照看, 没有机器来保持清醒. 需要我单独付人工智能订阅费吗? 对 CloudCLI提供环境,而不是AI. 你带来你自己的克洛德,克索尔, 或Codex订阅。 云层CLI 云的起始时间为7欧元/月,上面是主机环境. 我能用CloudCLI的手机吗? 对 自动托管, 运行您的机器并打开服务器 `[yourip]:port` 在您网络上的任何浏览器中。 为云CLI 云从任何设备打开——没有VPN,没有端口转发,没有设置. 作品中也有本地应用. 我对UI所做的修改会影响我本地的克洛德代码设置吗? 是的,是自办的 CloudCLI UI 读取和写到相同的 `~/.claude` 克洛德密码在本地使用的配置 您通过UI添加的MCP服务器立即出现在克洛德代码中,反之亦然. * * * ## 社区与支持 - **[文档](https://cloudcli.ai/docs)** - 安装、配置、特性和故障排除 - **[解析器](https://discord.gg/buxwujPNRE)** ——获得帮助并与其他用户连接 - **[GitHub 问题](https://github.com/siteboon/claudecodeui/issues)** ——错误报告和特性请求 - **[贡献指南](https://npmcn.com/package/%40cloudcli-ai/cloudcli/CONTRIBUTING.md)** ——如何为项目作贡献 ## 许可证 GNU Affero General Public License v3.0 或后期(AGPL-3.0-或后期)——参见 [自由主义](https://npmcn.com/package/%40cloudcli-ai/cloudcli/LICENSE) 全文,包括第7节下的补充条款. 这个项目是开放源代码,可自由使用、修改和根据AGPL-3.0-或-后期许可证分发。 如果您修改了此软件并作为网络服务运行,则必须让该服务的用户可以使用您修改过的源代码. CloudCLI UI (英语:[https://cloudcli.ai (英语)](https://cloudcli.ai/)) (中文(简体) ). ## 承认 ### 内设 - **[克劳德代码](https://docs.anthropic.com/en/docs/claude-code)** - Anthropic官方的CLI(英语:CLI) - **[光标 CLI](https://docs.cursor.com/en/cli/overview)** -克塞尔官方CLI - **[代码](https://developers.openai.com/codex)** - OpenAI 编码器 - **[反应](https://react.dev/)** - 用户界面库 - **[维特](https://vitejs.dev/)** - 快速构建工具和dev服务器 - **[尾风 CSS](https://tailwindcss.com/)** - 功能第一CSS框架 - **[代码](https://codemirror.net/)** - 高级代码编辑器 - **[任务主AI](https://github.com/eyaltoledano/claude-task-master)** _(备选)_ - 人工智能项目管理和任务规划 ### 发起人 - [Siteboon - AI 供电的网站构建器](https://siteboon.ai/) * * * **照顾克洛德密码,克索克密码和克多克克克斯密码.** ## 常见问题 ### @cloudcli-ai/cloudcli 是什么？ Claude 代码 CLI 的网络用户界面 ### 如何安装 @cloudcli-ai/cloudcli？ 在项目目录运行 npm install @cloudcli-ai/cloudcli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cloudcli，可以用 npx cloudcli 直接运行。 ### @cloudcli-ai/cloudcli 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cloudcli-ai\_\_cloudcli 是否存在。 ### @cloudcli-ai/cloudcli 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @cloudcli-ai/cloudcli 可以商用吗？ @cloudcli-ai/cloudcli 使用 AGPL-3\.0-or-later 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。 ### @cloudcli-ai/cloudcli 的下载量有多少？ 根据 npm 官方下载统计，@cloudcli-ai/cloudcli 在 2026/10/10 – 2026/11/08 这 30 天内被下载 23,478 次，日均约 783 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @cloudcli-ai/cloudcli 还在维护吗？ 最新版本 1\.37\.8 发布于 2026/11/07（2 天前）；至今共发布 36 个版本，其中过去 12 个月发布了 36 个；首次发布于 2026/04/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。