快速上手

5 分钟跑通第一个智能体。目标读者：会写代码、但第一次接触智能体开发的工程师。

1. 安装

需要 Node.js ≥ 22.19.0。

coremind-cli@1.0.1 是本发布线的目标包；安装前以 npm 实时页面确认公开可用性。

bash

npm install -g coremind-cli@1.0.1
coremind --version              # 验证安装成功
coremind --help                 # 查看帮助

bash

coremind providers
coremind create my-agent --template translator --language typescript --provider alibaba-model-studio
cd my-agent

看一下生成的 coremind.yaml——这是智能体定义。项目还会生成测试/评测骨架、双语需求与架构、开发 SOP、验收清单、项目 Skill 和 checkpoint 目录；已有文件不会覆盖。

powershell

Copy-Item .env.example .env     # Windows PowerShell

bash

cp .env.example .env           # Linux

编辑 .env，填入 DASHSCOPE_API_KEY=<你的 key>。CLI 会自动加载当前工作目录下的 .env，因此先进入刚创建的 my-agent；详见CLI 使用指南。

凭据只放在环境变量中。嵌入式宿主也可提供 SecretRef resolver；敏感 Header（包括常见 API key 和 token 别名）不得使用明文字面量。

交互终端会询问 Provider；非交互脚本必须显式使用 --provider。本例选择阿里云百炼入口；1.0.1 正式发布必须取得绑定本次候选的严格真实调用认证，其他可配置 Provider 不因此自动获得认证。供应商矩阵是较早的静态台账，发布证据见正式 Release。

bash

coremind run coremind.yaml --prompt "翻译：你好，世界"

你会看到 agent 流式输出，最后一行是质量摘要：

✓ 运行完成：工具 0 次调用 · 耗时 2.1s · 约 45 tokens · 输出 18 字

命令怎么装、在哪敲、key 怎么管理、常见坑——详见CLI 使用指南。

命令	用途
`coremind create <name>`	新建或接入项目（`--template`、`--language`）
`coremind run <file>`	运行一次（`--prompt` 首条输入 / `--json-events` 输出机器可读事件 / 启用 session 后以 `--session <id>` 保存会话）
`coremind chat <file>`	多轮 TUI（审批、预算、Trace、checkpoint/diff/恢复）
`coremind check [file]`	检查配置、安全、项目材料和质量档
`coremind eval [file]`	重复运行 `evals/scenarios.yaml`
`coremind templates`	查看全部 8 个模板（兼容 `list-templates`）
`coremind providers`	查看可配置 Provider 与当前认证状态
`coremind doctor`	环境自检（Node 版本 / 配置 / API key 是否存在）