Capy 文档
目录capy 命令行与 coding agent

开发者

capy 命令行与 coding agent

用 capy 命令行管理项目,让 Claude Code、Codex 等 coding agent 读 Capy 里的消息和资料、接卡皮派的开发任务。

capy 是 Capy 的命令行工具。它有两个用处:

  1. 管理项目:添加、同步、派任务、拉回改动、开终端,见项目。
  2. 接上你自己的 coding agent:让 Claude Code、Codex 等直接读你在 Capy 里能看到的消息、待办、任务和文档库资料,并且接卡皮派来的开发任务。

安装

桌面 App 自带命令行。在 Mac 上,点 App 菜单里的「安装 capy 命令…」即可。

登录:在 App 里确认

命令行登录不需要输入密码,而是在你已经登录的 App 上确认:

  1. 在终端运行 capy login,输入企业代码和账号。终端会显示一个 4 位确认码。
  2. 你手机、电脑或网页上已登录的 Capy 会弹出「电脑上的 capy 命令行要登录你的账号」,并写明是哪台设备、什么时间、什么网络。
  3. 输入终端上的 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 来说是资料,不是指令。

接卡皮派的开发任务

  1. 把项目设成本机 agent:项目的「运行设置 → 任务在哪做」选「我电脑上的 agent」,或运行 capy project settings --runner agent。
  2. 跟卡皮说要做什么,或在项目文件夹里运行 capy run "…"。
  3. 在项目文件夹里打开 agent,说「处理 Capy 的任务」。agent 会领取任务,在 .capy/tasks/<任务>/ 下单独的工作目录里改代码,分支是 capy/<任务>。你当前的工作区和分支不会被动到,.env 和像密钥的文件也不会被带进去。
  4. 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内网中继
界面截图来自 Capy 演示环境,公司名称、人名和数据均为示例。功能以 App 当前版本为准。 © 2026 Capy