Coze CLI

Coze CLI 是扣子面向 AI Agent 和开发者提供的命令行工具。它将扣子编程中的项目开发、资源管理和内容生成能力封装为结构化命令，使 Agent 能够根据用户的自然语言指令，在后台完成从创建到交付的完整任务。

Coze CLI 是什么

在扣子编程网页端，用户通常通过页面完成项目创建、AI 对话开发、预览、部署和资源配置。Coze CLI 将这些操作转化为 Agent 和自动化程序可以调用的命令接口。用户不必逐项操作页面，只需说明目标，Agent 就可以选择合适的命令并执行任务。

Coze CLI 的包名为 @coze/cli。它既可以由开发者在终端中直接使用，也可以集成到支持命令行工具的 Agent 中。对多数用户而言，推荐的使用方式不是记忆命令，而是直接向 Agent 描述需求，由 Agent 通过 Coze CLI 操作扣子。

Coze CLI 与扣子编程使用相同的账号、组织和工作空间体系。通过 CLI 创建的项目、生成的内容和配置的资源会保存在用户授权的扣子账号下，用户可以继续在扣子编程中查看和管理。

为什么需要 Coze CLI

传统命令行工具主要用于让开发者更高效地操作软件；Coze CLI 则同时面向开发者和 AI Agent。它将一系列可重复、可标准化的产品操作转化为结构化接口，使 Agent 不仅能够理解需求，还能够实际创建项目、修改应用、配置资源并交付结果。

• 对于 Agent 用户，Coze CLI 减少了在不同页面之间切换和逐项配置的成本。创建应用时，用户可以从一句需求开始，让 Agent 持续完成开发、调试、预览和部署；生成图片、语音或视频时，也可以让 Agent 统一组织生成任务并交付产物。
• 对于开发者和企业团队，Coze CLI 提供了更稳定的自动化入口。项目、代码仓库、数据库、环境变量和工作空间等资源可以通过命令统一管理，并使用结构化输出接入脚本、Agent 或其他自动化流程。

Coze CLI 能做什么

Coze CLI 将扣子编程的核心能力开放给 AI Agent。用户只需说明目标，Agent 就可以在后台完成项目开发、问题修复、资源配置和内容生成，并将可预览、可部署或可下载的结果直接交付给用户。

一句话开发应用

无需在页面中逐项创建和配置项目。你可以直接告诉 Agent 想做什么，例如创建一个决策助手、活动报名网站或业务数据看板。Agent 会通过 Coze CLI 创建项目，与编程 AI 持续对话，完成代码生成、功能开发和页面设计，并返回在线预览地址。

预览过程中发现问题时，可以继续通过自然语言提出修改要求。Agent 能读取项目上下文和运行结果，定位并修复问题；验收完成后，还可以继续部署生产版本、配置环境变量和自定义域名。对于已有工程，也可以从 GitHub 仓库或本地 ZIP 文件导入，在原有代码基础上继续开发。

你的指令：

使用 Coze CLI，做一个好玩又实用的小东西吧，做个决策助手网站

对话过程：

你的产物：

让 AI 完成调试和工程协作

应用开发通常需要多轮修改，而不是一次生成。Coze CLI 支持 Agent 将项目代码、需求文档和错误日志作为上下文发送给编程 AI，并持续跟踪开发任务。遇到部署失败时，Agent 可以查询部署状态和日志，调用 AI 分析失败原因并尝试修复。

对于更完整的工程流程，Agent 还可以管理远程代码仓库、云数据库、模型、工具、Skill 和环境变量。这样，Coze CLI 不仅适合从零生成应用，也可以进入已有项目的日常开发和协作流程。

你的指令：

换个风格，换成活泼可爱的

对话过程：

你的产物：

在遇到运行错误时，AI 会自动读取 CLI 的后台运行日志，精准定位报错位置、分析执行链路，并自动修复问题。

简单来说，当你在度假时忽然收到线上报错，你甚至不需要打开电脑，随手跟 Agent 说一句就行。它会自己去看报错日志，找出是哪里卡住了，然后自己修改错误、重新测试，直到帮你把整个流程彻彻底底地跑通。

你的指令：

“决策助手”这个项目，抛硬币这里有点问题，图片是正面，文字提示是反面，帮我修复一下

对话过程：

修复结果：

一站式内容创作

Coze CLI 可以调用扣子提供的内容生成能力，完成图片、语音和视频创作。例如，用户可以让 Agent 根据一份产品资料批量生成宣传图片、产品配音和营销短片。Agent 会提交生成任务、跟踪状态，并在任务完成后取得最终产物。

生成结果和本地文件还可以上传为在线可访问资源，便于用户直接预览、下载或继续用于应用开发。整个过程可以在同一次对话中完成，无需用户在多个创作工具和存储服务之间切换。

例如直接对话，就能生成小红书高密度风格信息图、生成视频、音频：

对话过程：

生成的信息图：

生成的视频：

云端存储产物

之前用过 Openclaw 的朋友可能都遇到过一个痛点：Agent 明明生成了文件，但给出的链接却经常无法打开。这其实是因为文件只存在于 Agent 的虚拟沙盒里，缺乏公共的对象存储能力。

现在通过 扣子编程 CLI 接口，Agent 可以直接把生成的内容上传到云端，可以理解为给 Agent装上了一个“自动同步云盘”，这样你最终收到的，就是一个能直接点击预览、随时下载的公网链接，让文件获取更轻松！

核心能力

当前 Coze CLI 的核心能力可以归纳为六个模块。

不同项目类型、账号版本和组织权限下，可用能力可能存在差异。具体命令及参数以当前安装版本的命令帮助和 npm 包说明为准。

如何使用 Coze CLI

在扣子中使用

扣子已集成 Coze CLI。用户可以直接在对话中描述需求，例如创建网站、修改已有项目或生成多媒体内容。扣子会根据任务选择相应能力，无需用户自行安装和执行命令。

你的指令：

帮我用 Coze CLI 创建一个网页应用，介绍  Coze CLI  的功能及使用方式 

对话过程：

预览作品：

在其他 Agent 中使用

如果你使用 TRAE、Claude Code、扣子编程 OpenClaw 助手等其他 Agent，需要先安装 Coze CLI。

1. 安装 Coze CLI。
   • 通过 Skill 安装。
     我们已经把安装过程打包成了 Skill 并上传到了虾评。把这段话发给你的Agent，它自己就能学会如何安装并使用 Coze CLI。

     去这里学一下 Coze CLI Skill：
     https://xiaping.coze.site/skill/aee0a560-9634-415e-9ff3-77b1587a4134?ref=628be309-5da3-434f-8b1a-722e65b450e3
     

   • 对话中直接安装。
     可以复制以下信息，并发送给你的 AI Agent，立即完成安装。

     # 帮我安装 Coze CLI
     npm install -g @coze/cli
     

2. 登录你的扣子账号。
   复制以下信息，并发送给你的 AI Agent。Agent 会自动生成授权链接，你需要按照页面提示完成账号授权。

   # 帮我登录扣子账号 
   coze auth login --oauth
   

3. 发起第一个任务。
   复制以下信息，并发送给你的 AI Agent。通过简单对话，快速生成并部署一个网页应用。

   帮我用 Coze CLI 创建一个网页应用，介绍  Coze CLI  的功能及使用方式 
   创建完成后，请将预览链接发给我
   

下一步

接下来，你可以通过以下教程，在实际任务中使用 Coze CLI。可以按顺序阅读，也可以直接选择与你当前目标对应的教程：

• Coze CLI：账号登录与授权
• Coze CLI：10 分钟开发并上线 Web 应用
• Coze CLI：导入已有项目并通过 AI 持续开发
• Coze CLI：构建带数据库的 AI 应用
• Coze CLI：批量生成营销内容
• Coze CLI：管理企业团队资源

如需查询完整命令、选项和参数，请参考 @coze/cli npm 包说明。Coze CLI 仍在持续迭代，实际能力以当前安装版本的 coze --help 和对应子命令帮助为准。