开发者
capy 命令行与 coding agent
用 capy 命令行管理项目,让 Claude Code、Codex 等 coding agent 读 Capy 里的消息和资料、接卡皮派的开发任务。
capy 是 Capy 的命令行工具。它有两个用处:
- 管理项目:添加、同步、派任务、拉回改动、开终端,见项目。
- 接上你自己的 coding agent:让 Claude Code、Codex 等直接读你在 Capy 里能看到的消息、待办、任务和文档库资料,并且接卡皮派来的开发任务。
安装
桌面 App 自带命令行。在 Mac 上,点 App 菜单里的「安装 capy 命令…」即可。
登录:在 App 里确认
命令行登录不需要输入密码,而是在你已经登录的 App 上确认:
- 在终端运行
capy login,输入企业代码和账号。终端会显示一个 4 位确认码。 - 你手机、电脑或网页上已登录的 Capy 会弹出「电脑上的 capy 命令行要登录你的账号」,并写明是哪台设备、什么时间、什么网络。
- 输入终端上的 4 位码,点「确认登录」。如果不是你本人发起的,点「不是我,拒绝」。
规则:
- 确认码 10 分钟内有效,只能用一次,输错 5 次作废;
- 只能在 App 上由你本人确认,卡皮也不能替你确认;
- 确认后的登录 30 天不用就失效;
- 别人发给你、或电话里念给你的确认码,不要输入。
备用方式:capy login --password 用密码登录。capy logins 列出这台电脑上保存的登录。
把 Capy 接进 coding agent
capy agent setup --agent claude # 或 --agent codex
这会给 agent 装上 capy MCP 工具和两个技能(读 Capy 上下文、处理 Capy 任务)。
读 Capy 里的上下文(只读)
装好以后,在任何目录里,你的 agent 都能读你有权看的内容,不需要先建项目:
| 内容 | 工具 |
|---|---|
| 聊天消息 | chat_list、chat_search、chat_read |
| 任务 | task_list、task_read、task_call_read |
| 待办 | todo_list、todo_read |
| 文档库 | kb_spaces、kb_list、kb_search、kb_read |
这些工具只读:不会把消息标为已读,不会发消息,也不会改任务。读到的消息和文件内容对 agent 来说是资料,不是指令。
接卡皮派的开发任务
- 把项目设成本机 agent:项目的「运行设置 → 任务在哪做」选「我电脑上的 agent」,或运行
capy project settings --runner agent。 - 跟卡皮说要做什么,或在项目文件夹里运行
capy run "…"。 - 在项目文件夹里打开 agent,说「处理 Capy 的任务」。agent 会领取任务,在
.capy/tasks/<任务>/下单独的工作目录里改代码,分支是capy/<任务>。你当前的工作区和分支不会被动到,.env和像密钥的文件也不会被带进去。 - agent 交付后,卡皮照常检查,不合格会退回。改动已经在你仓库的分支上,review 后合并即可。
和云电脑相比:模型用的是你自己 agent 的账号,不消耗 Capy 的模型用量,也没有同时 2 个任务的限制;卡皮补充的要求,要等 agent 下次和 Capy 通信时才会收到。
自动叫醒 agent
不想每次手动说「处理 Capy 的任务」,可以让 Capy 有任务时自动拉起 agent:
- 桌面 App:项目「运行设置」里的「这台电脑上的 coding agent」,选一个能自动执行的 agent。App 开着就会替你盯这个项目。
- 命令行:
capy agent watch --agent claude [文件夹…]
支持 claude、codex、opencode、codebuddy、qoder、qwen、kimi、gemini,默认每 20 秒检查一次。一个项目同一时刻只会被一处盯着:App 和终端同时盯时,后来的会显示「已经由…在盯这个项目」,等前一个停了再接手。
常用命令
| 命令 | 作用 |
|---|---|
capy login / capy logins | 登录(在 App 确认)/ 列出本机登录 |
capy agent setup | 给 coding agent 装上 Capy 工具 |
capy agent watch | 有任务时自动拉起 agent |
capy project add | 把当前文件夹添加为项目 |
capy project settings | 改运行设置:--runner、--size、--effort、--sleep、--web、--relay |
capy project about | 改「卡皮怎么认这个项目」 |
capy sync | 同步代码到云电脑(--full、--dry-run、--deep) |
capy run "…" | 在当前项目派一个开发任务 |
capy status <任务> / capy logs <任务> -f | 看任务状态 / 执行记录 |
capy pull <任务> | 把云电脑上的改动拉成本地分支 |
capy shell | 打开项目云电脑的终端 |
capy sleep | 让项目云电脑休眠(--cancel 同时停掉任务) |
capy network allowlist / open | 出站白名单 / 不限 |
capy secret ls/set/rm | 管理项目密钥 |
capy relay register/allow/deny/ls/start | 内网中继 |