安装与首次运行

方案一：通过 npm 安装 Cetas JS（推荐）

npm install -g @posoco/cetas
cetas --version

需要 Node.js 24 或更高版本（nodejs.org）。这是默认推荐的交互式终端，包含 Board 等 JS 专属集成。当前稳定 Cetas 发布版通过 npm 分发 JS 终端，不再把 cetas-bun 直接下载包作为首选入口。

方案二：Cetas Native（无需 Node.js）

Native 使用 Go/Bubble Tea v2 实现终端，底层同样运行 MoonBit Cetas/Posoco。它是第二种实现，不承诺与 JS 完全相同的功能。

Homebrew：macOS Apple Silicon / Linux x64

brew install colmugx/tap/cetas

Scoop：Windows x64

scoop bucket add cetas https://github.com/colmugx/scoop-bucket
scoop install cetas/cetas

直接安装或下载

也可以使用仓库中的 Unix 安装脚本 或 PowerShell 安装脚本。它们会先显示检测到的系统、版本、目标目录和文件清单，得到终端确认后才下载二进制。非交互场景需明确指定 --yes（Unix）或 -Yes（PowerShell）。

手工下载请在 GitHub Releases 选择 cetas-v* 版本（Memoh 使用独立版本系列）。当前 Native 支持 macOS ARM64、Linux x64 和 Windows x64。Windows 的 cetas-windows-x64.zip 含三个 EXE 和 cetas_moon.dll；DLL 必须与 cetas.exe 放在一起。

只需要编辑器 ACP 或一次性 Runner？

每个 Cetas Release 都继续保留可独立下载的资产：

这两种用途不必下载整个 Native 终端。校验文件使用同一个 Release 的 SHA256SUMS。

JS 与 Native 同时安装

两者都可能提供 cetas 命令，Shell 会运行 PATH 中排在前面的那一份。Unix 用 command -v cetas，PowerShell 用 Get-Command cetas 检查。配置共享 Cetas Home，但功能、确认界面和会话流程不保证一致。

从装好到第一条消息

四步。

1. 在你的项目目录里启动

cd /path/to/your/project
cetas

它读、改、执行的每一样东西都相对这个目录。还没有项目？新建一个空文件夹，进去一样能开始。

2. 登录一家供应商

Cetas 不带模型，调用的是供应商（DeepSeek、OpenAI 这类提供模型的公司）的接口。去供应商官网注册账号、建一个 API key，然后：

/login

选供应商，粘贴 key（或走它支持的浏览器授权），完成。列表比你预期的短？见供应商。

3. 选一个模型

/model

列表来自你刚登录的供应商，选一个就能用了。

4. 说第一句话

这个仓库的鉴权是怎么工作的？

没有仓库也一样，说什么都行——它能流式回答，就算通了。第一天用得上的几个键：

• @路径 挂一个工作区文件，Tab 补全；
• Esc 打断当前回合，运行中接着打字会排队；
• 完全信任它之前，/permission readonly 先把会话降到只读，见权限；
• /help 列出这份构建真正有的命令。

会话自动保留：/sessions 随时重开，/rewind 退回出错之前——没有“保存”这一步。

要用自己公司的端点？

Cetas 原生支持私有化部署的 OpenAI 兼容端点，走法在自定义模型。

卡住了

登录的凭据、选好的模型、聊过的会话，都自动收在一个 home 目录里，平时不用管；好奇它长什么样、怎么备份，见 Cetas Home。

接下来：自定义模型、权限、命令速查。