Capy 文档
目录项目

开发者

项目

把代码文件夹接进 Capy,开发任务交给卡皮,在独立的云电脑或你自己电脑上的 coding agent 上完成。

项目是你电脑上的一个文件夹(里面可以有一个或多个 git 仓库,也可以有普通目录),加上它的运行设置。把它接进 Capy 以后,你可以跟卡皮说「在 XX 项目里把登录页的报错修好」,卡皮会派一个开发任务,做完检查,再把改动以 git 分支的形式交还给你。

开发任务可以在两个地方做:

在哪做适合代码去哪
我电脑上的 agent(默认)你已经在用 Claude Code、Codex 等 coding agent代码不离开你的电脑,改动直接留在本地分支
云电脑想让任务在后台跑,不占你的电脑文件夹上传到这个项目自己的一台云电脑,和你做表格的那台分开

入口

侧栏菜单的「项目」,或者「设置 → 连接和规则 → 项目」。项目页有这些页签:

  • 概览:云电脑状态、每小时价格、上次同步时间、这个项目的任务;
  • 运行设置:在哪做、云电脑规格、休眠、思考强度、联网工具;
  • 网络和密钥:出站白名单、密钥、内网访问;
  • 终端:直接打开云电脑上的命令行。

本机 agent 项目只有「概览」和「运行设置」。

添加项目

在桌面 App 上:项目列表右上角「添加文件夹」→ 选文件夹 → 选「任务在哪做」:

  • 「我电脑上的 agent」:只记下这个文件夹,什么都不上传;
  • 「云电脑」:按钮会变成「添加并上传」,上传整个文件夹。

用命令行(见 capy 命令行):

capy project add [文件夹] [--name 名字] [--size 4c8g]   # 云电脑项目,第一次全量上传
capy project add --runner agent                         # 本机 agent 项目,不上传

手机和网页上能看项目、改设置、开终端、看任务进度,但添加文件夹和同步要在电脑上做。

同步代码(云电脑项目)

在桌面 App 的项目页点「同步」,或在文件夹里运行 capy sync。只上传有变化的部分;capy run 派任务前也会自动同步一次。

第一次上传前会先给你看清单:每个仓库有多少文件、多少提交、有没有没提交的改动、总大小,以及被 .capyignore 排除了什么。你确认了才上传。

发现像密钥的文件就停下:文件名像密钥(.env、*.pem、id_rsa 等),或者内容里出现私钥、云服务令牌的格式,Capy 会停下来,一个字节都不传,逐条请你确认「不是真密钥」后才继续。

  • 不想上传的东西,写进文件夹根目录的 .capyignore(写法和 .gitignore 一样);
  • 一次上传最大 200 MB。

运行设置

设置选项
任务在哪做云电脑 / 我电脑上的 agent
云电脑规格1 核 2 GB、2 核 4 GB、4 核 8 GB(默认)、8 核 16 GB。改规格会换一台新云电脑
休眠闲置 5 分钟后休眠(默认)/ 不休眠(一直计费)
思考强度低、中(默认)、高、最高;还可以允许卡皮按难度自己调高
联网工具默认关。打开前会提醒你:联网搜索和读网页会绕过出站白名单,可能把代码内容带出去

规格越大,每小时用量越高,具体以页面上显示的为准。

网络和密钥

为了防止代码被带出去,云电脑项目的出站网络默认只放行白名单:

  • 常用的包管理器国内镜像(npm、PyPI、Go 等);
  • Capy 自己的文件地址;
  • 你配置的密钥对应的域名;
  • 你自己加的域名。

你也可以改成「不限制」。出站规则没有生效之前,任务和终端都不会开始。

密钥有两种:

  • 请求头密钥:在出口按域名自动加到请求上,云电脑里、终端里都看不到它的值;
  • 环境变量密钥:执行任务时交给 agent,只在白名单模式下提供,记录里会遮住值。

密钥存好以后就看不到值了,只能换值或删除。

访问公司内网

如果任务要连公司内网里的数据库或服务,可以在内网一台常开的电脑上运行中继(请先取得 IT 同意):

capy login
capy relay register --name 机房中继
capy relay allow db.corp.example:5432    # 一条一个 主机:端口,不支持通配
capy relay start                         # 一直运行,只向外连 Capy,断线自动重连

然后到项目的「网络和密钥 → 内网访问」里选这个中继。

  • 只有出站是白名单模式的项目能开内网访问(页面上有一键「改成白名单并打开」);
  • 只支持 TCP,云电脑里的程序直接按内网地址连;
  • 能访问哪些地址只能在中继那台电脑上改,改了立即生效;
  • 每条连接都有记录;「设置 → 连接和规则 → 中继」里能看到中继是否在线、清单和用到它的项目,也能吊销。

终端

项目页的「打开终端」或「终端」页签(电脑、网页、手机都有),也可以在项目文件夹里运行 capy shell。打开的是云电脑上的命令行,目录是 /workspace,agent 的文件和日志都在这里。

  • 打开终端会唤醒云电脑,醒着时计费;
  • 5 分钟没有输入输出会自动断开,点「重新连接」恢复;
  • 手机上有一排 Esc、Tab、Ctrl 和方向键。

派开发任务、拿回改动

  1. 跟卡皮说要在哪个项目里做什么,或者在文件夹里运行 capy run "把登录页的报错修好"。
  2. 用 capy status <任务> 看状态和每个仓库的改动,capy logs <任务> -f 跟着看执行记录;App 里的进度页也能看。
  3. agent 在每个仓库的 capy/<任务> 分支上提交。卡皮按交付说明、改动和测试结果检查,不合格会退回重做。
  4. 云电脑项目:在本机文件夹里运行 capy pull <任务>,每个仓库多一个本地分支,你自己 review 后合并。本机 agent 项目:改动已经在你的仓库分支上,不用拉。

休眠

概览页的「休眠」可以手动让云电脑休眠,命令行是 capy sleep。有任务在跑时,要选「停掉任务并休眠」(capy sleep --cancel)。

告诉卡皮这个项目是什么

概览页的「卡皮怎么认这个项目」可以直接改:项目说明、聊天里大家怎么称呼它、问题记在哪个文件、关联哪些聊天。填好以后,群里有人说「后台登录又挂了」,卡皮就知道说的是这个项目。

界面截图来自 Capy 演示环境,公司名称、人名和数据均为示例。功能以 App 当前版本为准。 © 2026 Capy