简体中文
CloudCLI
CloudCLI 是一个跑 AI 编程会话的网页。CloudCLI 模块给受管机器上选定的每个账户运行一个实例，客户端选 打开 后直接进到已登录的页面。你在机器上安装的是 npm 包 @cloudcli-ai/cloudcli，版本固定在 1.37.3。要在同一个网页里用 Claude Code、Codex、Gemini CLI 等多种工具，选 Codeg 模块。
| 系统 | 能运行它的机器 |
|---|---|
| Linux | amd64 和 arm64 |
| Windows | amd64 |
| macOS | Apple 芯片和 Intel |
添加实例
- 在模块页的 CloudCLI 标签下，选择 安装。
- 选择 配置，标签下面展开 实例。
- 选择 添加实例。
- 在 账户 里填机器上一个账户的名字。
- 可选：改 端口。第一个实例用 3001，之后每个用已占用的最大端口加一。
- Windows 机器上，选这个账户的登录信息，那一栏的标题是账户名加 的 Windows 登录。
- 选择 应用 CloudCLI。
每个实例以它的账户身份运行。Windows 的登录信息存在凭据页。
每个账户第一次应用时，机器以这个账户的身份用 npm 装一次 CloudCLI，装在账户自己的目录里，这时标签读 安装中。安装程序还取来 Node.js 22，解包到被控端的目录里，所有账户共用，系统的 PATH 不变。安装要访问 nodejs.org、npm 和 GitHub。
服务的 PATH 里有什么
CloudCLI 服务的环境变量全部重新写过，不读登录配置文件。PATH 的第一项是 Node 的目录，后面接这些目录：
| 系统 | Node 目录之后 |
|---|---|
| Linux | ~/.local/bin、~/bin、/usr/local/bin、/usr/bin、/bin |
| macOS | /opt/homebrew/bin、/usr/local/bin、/usr/bin、/bin |
| Windows | %APPDATA%\npm，再接账户自己的 PATH |
CloudCLI 启动的 Claude Code 或 Codex，要由账户自己装在这些目录里。
让它的 AI 工具走网关
这个账户的 Claude Code、Codex 和 Gemini 读账户自己的设置文件。要它们改用中枢的 AI 网关，见把一台机器的 AI 工具指向网关。
从客户端打开
每个运行中的实例，都是服务页 网页 组里的一行，标题是 CloudCLI 加括号里的账户名。
- 在客户端的 网页 页上找到这一行。
- 选择 打开。
实例端口上监听的是被控端的转发器，CloudCLI 本身只在它后面的回环地址上监听。转发器核对令牌后，用中枢生成的密码登录 CloudCLI。不带有效令牌、也没有登录状态的浏览器，打开的是 401 页。
第一次打开
第一次选 打开 时，浏览器已经以这个账户登录，进的是 CloudCLI 自己的设置页。客户端先从中枢取一个一次性的令牌，见带令牌的条目；转发器核对令牌后，替浏览器登录 CloudCLI。这期间模块页上这个实例一行一直读 运行中，设置只写配置，服务照常运行。
CloudCLI 的设置
CloudCLI 的设置页是英文的，设置完再把界面换成中文。
在客户端的 网页 页上，这个实例一行选 打开。
在 Git Name 和 Git Email 里填名字和邮箱。CloudCLI 把它们写进这个账户的全局 git 设置。
选择 Next。
选择 Complete Setup。
选左上角的菜单按钮。
选列表底部的 Settings。
选 Appearance 标签。
在 Display Language 里选 简体中文。
Connect Your AI Agents 页上 Claude Code 的勾，来自账户的 ~/.claude/settings.json。会话要用 Claude Code，还要以这个账户把它装在服务 PATH 里的某个目录下。
第一个项目和会话
项目是机器上的一个文件夹，会话是在这个文件夹里的一次 Claude Code 对话。设置完时项目列表是空的：
选左上角的菜单按钮。列表读 未找到项目。
选列表顶上带加号的文件夹按钮。
在 工作区路径 里填这个账户名下一个文件夹的完整路径。
选择 下一步。
选择 创建项目。
在项目下面选 新建会话。
在底部的输入框里写一句话，再选发送按钮。
回复出现在这句话下面。项目的列表里多出这个会话，标题就是第一句话。
在终端里以这个账户运行过 Claude Code 的文件夹，也作为项目出现在列表里，空列表上的提示说的就是这件事。账户里没有 Claude Code 时，第一句话之后出现一条错误，说找不到 Claude Code 的程序；照服务的 PATH 里有什么一节装好它。
失败时
中枢重置或重装后会生成新密码，CloudCLI 里却还是旧中枢建的管理员。这时被控端让这个实例换一个新的数据库文件，重新启动一次。旧文件留在机器上，新文件里没有以前的记录。
其余原因见故障排查。