capsul

capsul 快速上手：安装、首次运行、第一组数字

安装 capsul，确认环境，打开交互会话，再用你已经配置好的代理 CLI 执行任务。

1. 安装

npm i -g @penra/capsul

需要 Node 20 或更高版本。

2. 检查环境

doctor 会报告它能识别到哪些代理 CLI、配置了哪些凭据，以及东西存放在哪里。它告诉你它们在哪，却从不显示它们是什么。

capsul doctor

如果这里没能识别到你的代理 CLI，后面什么都跑不通。先把这一步解决掉。

3. 开始会话

打开交互会话，并选择已经配置好的代理 CLI。你输入任务之前，不会发送模型请求。

capsul

4. 发送任务

请求会交给你已登录的代理 CLI，由你现有的 Claude 或 ChatGPT 套餐回答。无需粘贴 API 密钥，也没有第二份模型账单。

capsul ask '修好跳转死循环' --budget 3000

之后

  • capsul stats 累计一段时间里省下的 token。台账是你自己磁盘上的一个普通文件。
  • capsul burn 按代理、模型和项目拆解本地花费。
  • 机械性工作用 --model haiku：重命名、格式化、单文件修改。
  • --budget <n> 给上下文设硬上限，不会有任何东西悄悄越界。

常见问题

我需要 API 密钥吗？

不需要。capsul 驱动你已经登录的代理 CLI，所以回答的是你现有的订阅。API 密钥是按会话选择的可选项，所有套餐都可用。

它支持哪些代理？

Claude 和 Codex。无论由哪一个回答，预算、审批提示和节省台账都是同一套。

会向模型发送什么？

你的任务、你点名的文件，以及你所在仓库的简短片段，从不发送整个仓库。你的密钥留在系统钥匙串里，台账是你自己磁盘上的一个普通文件。

如果预算对我的任务来说太低怎么办？

它会停在上限处，并告诉你留下了什么没带。不会有任何东西悄悄越界。用 --budget 调高，或者用 --open 点名你在意的文件。

$ npm i -g @penra/capsul

← 全部指南