开发者
项目
把代码文件夹接进 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 和方向键。
派开发任务、拿回改动
- 跟卡皮说要在哪个项目里做什么,或者在文件夹里运行
capy run "把登录页的报错修好"。 - 用
capy status <任务>看状态和每个仓库的改动,capy logs <任务> -f跟着看执行记录;App 里的进度页也能看。 - agent 在每个仓库的
capy/<任务>分支上提交。卡皮按交付说明、改动和测试结果检查,不合格会退回重做。 - 云电脑项目:在本机文件夹里运行
capy pull <任务>,每个仓库多一个本地分支,你自己 review 后合并。本机 agent 项目:改动已经在你的仓库分支上,不用拉。
休眠
概览页的「休眠」可以手动让云电脑休眠,命令行是 capy sleep。有任务在跑时,要选「停掉任务并休眠」(capy sleep --cancel)。
告诉卡皮这个项目是什么
概览页的「卡皮怎么认这个项目」可以直接改:项目说明、聊天里大家怎么称呼它、问题记在哪个文件、关联哪些聊天。填好以后,群里有人说「后台登录又挂了」,卡皮就知道说的是这个项目。