CloudCannon CLI 分为本地与远程两部分。本地部分在工作目录中读写文件，无需账号；远程部分通过 CloudCannon API 操作线上站点，需要凭据。
用途：查询命令及参数、登录与 CI 配置、列出/查看/创建站点与组织、读写托管站点文件并提交、触发重建、查看构建与同步日志、修改站点构建配置、列出表单提交。
不适用：决定 cloudcannon.config.yml 内容（属 cloudcannon-configuration）、本地运行站点（cloudcannon dev 属 cloudcannon-dev-server）、从代码调用 API（属 cloudcannon-sdk）、编写可编辑区域或片段（属 cloudcannon-visual-editing 与 cloudcannon-snippets）。
关键规则：对托管站点执行任何写操作前必须与用户确认。sites files commit 会推送到真实 git 仓库，sites rebuild 会启动真实构建，sites update-build-config 会改变后续所有构建行为，均无提示且不可通过重跑撤销。只读远程命令（list、get、print-*）可安全直接运行。注意：读取类命令也可能走 API，不能因只读就假定为本地。
要求：Node 24 或更新版本。安装：npm i -g @cloudcannon/cli，或用 npx @cloudcannon/cli <command> 调用。
快速开始： npx @cloudcannon/cli --help npx @cloudcannon/cli sites files commit --help npx @cloudcannon/cli configure generate --auto --initial-site-settings npx @cloudcannon/cli validate npx @cloudcannon/cli login npx @cloudcannon/cli sites list
常见错误：参数随版本变化，应查询 documentation.json 或运行 --help；构建设置可用 sites update-build-config 修改；上传文件先进入编辑会话，提交后才生效；读取命令输出 JSON，空结果为数组而非错误，应检查退出码；--site 接受名称、ID、UUID 或域名。
限制：具体命令参数、凭据存储与优先级、编辑会话模型等细节需查阅对应文档文件，本资料未完整展开。