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

1. 安装

$npm i -g @penra/capsul

2. 检查环境

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

$capsul doctor

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

3. 不花一分钱地构建一次上下文

这是最该先跑的命令，用你手头真实的任务来跑。它组装上下文并报告开销，不调用模型，也不动你的配额。

$capsul context '为什么登录跳转会死循环'

加 --json 得到机器可读的输出；已经知道关键文件时加 --open：

$capsul context '修好跳转死循环' --open src/middleware.ts --json

4. 跑这项任务

ask 做同样的组装，然后把请求交给你已登录的代理 CLI。回答的是你现有的 Claude 或 ChatGPT 套餐：没有 API 密钥要粘贴，也没有第二份模型账单。

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

不带子命令直接运行 capsul，则会打开交互式会话，在里面选代理并对话。

$capsul

之后

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