Coze CLI Skill

概述

该技能使 AI 智能体能够与 Coze CLI（@coze/cli）—— Coze/Cozeflow 开发的官方命令行工具 —— 进行交互。它支持通过终端命令完成项目创建、部署、消息发送、多媒体生成以及空间管理等功能。

适用场景：当用户希望创建或部署 Coze 项目、管理空间/组织、生成图像/音频/视频、向 Coze 项目发送消息，或通过 CLI 自动化 Coze 工作流时，可使用此技能。

快速开始

安装

npm install -g @coze/cli
coze --version   # 验证安装

身份认证

coze auth login --oauth   # 打开浏览器进行 OAuth 流程
coze auth status          # 验证登录状态

初始配置

# 选择组织
coze org list
coze org use 

# 选择工作区
coze space list
coze space use 

核心工作流

创建项目

# 使用自然语言创建项目
coze code project create --message "创建一个数据分析 Web 应用" --type web

# 带等待（阻塞至操作完成）
coze code project create --message "创建一个客服机器人" --type agent --wait

支持的类型：agent、workflow、app、skill、web、miniprogram、assistant

列出 / 获取项目

coze code project list                          # 列出所有项目
coze code project list --type agent --type web  # 按类型筛选
coze code project list --name "客服"            # 按名称搜索
coze code project get               # 获取项目详情

向项目发送消息

coze code message send "修复登录页面的样式问题" -p 

# 带本地文件上下文
coze code message send "重构 @src/utils.ts 中的代码" -p 

# 通过管道传递输入
cat error.log | coze code message send "分析这个错误日志" -p 

# 查看状态 / 取消操作
coze code message status -p 
coze code message cancel -p 

部署项目

coze code deploy            # 部署
coze code deploy  --wait    # 等待部署完成
coze code deploy status     # 查询部署状态

预览项目

coze code preview 

管理环境变量

coze code env list -p                    # 查看开发环境变量
coze code env list -p  --env prod        # 查看生产环境变量
coze code env set API_KEY xxx -p          # 设置环境变量
coze code env delete API_KEY -p           # 删除环境变量

生成多媒体内容

# 图像
coze generate image "一只在太空漫步的猫"
coze generate image "未来城市" --output-path ./city.png --size 4K --no-watermark

# 音频
coze generate audio "你好，欢迎使用 Coze CLI"
coze generate audio "你好世界" --output-path ./hello.mp3 --audio-format ogg_opus

# 视频
coze generate video create "一只跳舞的小猫"
coze generate video create "日落延时" --wait --output-path ./sunset.mp4 --resolution 1080p --duration 8
coze generate video status 

上传文件

coze file upload ./document.pdf

输出格式

# 文本格式（默认）
coze space list

# JSON 格式（适用于脚本处理）
coze space list --format json
coze code project list --format json | jq '.[].name'

CI/CD / 非交互式使用

export COZE_ORG_ID=
export COZE_SPACE_ID=
export COZE_PROJECT_ID=

coze code deploy  --wait --format json

全局选项

配置

配置优先级（从高到低）：

1. 环境变量（COZE_ORG_ID、COZE_SPACE_ID 等）
2. --config CLI 参数
3. COZE_CONFIG_FILE 环境变量
4. 项目目录下的 .cozerc.json
5. 全局配置文件 ~/.coze/config.json

coze config list
coze config get base_url
coze config set base_url https://api.coze.cn

详细命令参考

完整命令参考表请参阅：

→ references/commands.md

涵盖内容包括：auth、org/space、项目 CRUD、message、deploy、env、domain、skill、多媒体生成、file upload、config、completion、upgrade、CI/CD 环境变量，以及常用命令模板。