服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 官方将 0.1.9 列为 2026 年 10 月 3 日的稳定版，已有 Windows 与 macOS 下载。
- 先确认一个代理能够登录并完成小任务，再逐步增加数量，便于定位失败发生在哪一步。
- 把资料梳理、方案比较、测试设计和改动审阅分开，先写清输入与交付物，再尝试并行。
- 合并前检查实际改动与测试结果，不把代理结束或状态卡变绿当作功能已经可用。
先确认四开资格，再区分两类限制
本文依据 KalCode 0.1.9 官方文档整理，未安装或实测。Pro 的并行上限是 4 个代理；套餐限制按整个应用统计，不是每个项目各有一份。先查看所有工作区中正在运行的任务，再计算还能启动几个。
如果点击启动就提示数量达到上限，优先核对 KalCode 账户的套餐与现有代理数量；如果代理已经打开，随后报告模型用量不足，则应检查所选 Claude 账户的提示。把这两类现象分开，才能避免为了模型额度问题重复购买工作区套餐。不要只凭四个终端窗口就判断有四个代理在工作，普通 shell 和开发服务器也可能占据面板。
第一次可以先在免费计划上确认单个代理的登录与任务流程，再决定是否需要更多并行容量。升级前想清楚四项工作能否独立推进：若后面三项都必须等待第一项产出，同时启动只会增加等待和重复解释。
按平台安装，先核对下载文件
下载页当前列出 0.1.9 build1340：Windows 10 1809 或以上的 64 位系统，以及 macOS 14 或以上的 Apple silicon Mac；Linux 尚无可用构建。Intel Mac 用户不能把 Apple silicon 下载包理解为通用 Mac 版本。
从文末官网下载页选择对应平台，并对照该页面的 SHA-256。Windows 可在下载目录运行 Get-FileHash .\KalCode_0.1.9_build1340_x64-setup.exe -Algorithm SHA256；macOS 可运行 shasum -a 256 ./KalCode_0.1.9_build1340_arm64.dmg。以后文件名或构建变化，应使用当时下载页对应的值，不要拿旧哈希验新版。
macOS 标准用户按官方说明将应用复制到 ~/Applications，便于后续应用内更新。安装后先打开一个可丢弃的练习项目，检查应用能否正常启动和识别路径，再接入日常仓库。首次验收不需要使用客户数据，也不必把完整项目交给代理。
旧版升级先看版本与操作系统
0.1.7、0.1.8 可通过 Restart to update 或 Settings → Updates 升级。Windows 0.1.6 无法自行更新，需从官网下载新版安装器运行一次；macOS 0.1.6 可在应用内更新。官方说明 Windows 覆盖升级会保留数据。
建议升级前先结束当前测试，保存文件并记录正在处理的任务；完成后重新打开应用，确认显示的版本、项目路径和账户名称。接着重复升级前能够完成的同一个小任务。这样若出现问题，可以区分应用启动失败、账户未登录和某项任务自身报错，而不是直接归因于新版。
排错时把操作系统、旧版本、新版本和错误文字放在一起。不要为重试安装清空应用数据目录；先按官方对应版本的说明排查，再决定是否恢复旧版。
在 KalCode 内连接自己的 Claude 账户
先安装受支持的 Claude Code CLI。KalCode 文档列出的范围是 2.1.282 或之后的 2.1 系列正式版，不支持预发布构建。进入 Providers → Accounts，添加 Claude Code 账户并选择 Sign in，通过提供商的浏览器登录完成连接。
每个账户使用独立的托管配置。另开系统终端登录 CLI，并不会登录 KalCode 使用的那个配置；检测到 CLI 已安装也不等于账户已登录。应回到应用中的账户条目检查状态，再启动任务。
建议给个人和工作账户使用容易辨认的名字。先用一个明确的账户做测试，不要一开始就混用多个登录身份。若认证失败，记录应用显示的错误与 CLI 版本，核对是否选中了预期账户；不要把访问令牌、登录回调或完整账户凭据粘贴到公开求助帖中。
从一个代理验收到四个独立任务
在 Code 点击 New agent，或从面板的加号入口启动，选择提供商、账户、模型、effort 和数量，再点击 Launch。每个代理会打开自己的终端面板。先只启动一个，确认面板中的身份与刚才选择一致。
可用这样的练习请求验收：“只阅读这个示例项目，列出入口文件和测试命令，不修改文件、不运行安装。”检查它是否读到了正确目录，回复是否能对应实际文件；需要审批时，先看清请求的具体动作。此处是建议的检查样例，不是本文的运行结果。
通过后再逐步增加到四个代理，分别负责结构梳理、方案比较、测试设计和现有改动审阅。为每个任务写明输入、禁止触碰的范围、完成标准和交付位置，并逐个核对任务归属。第一次练习可先让它们只给建议，确认没有串任务后，再向指定代理授权一项小改动。
某个代理迟迟无输出时，先看它是否在等登录、审批或前置资料。保留报错所在的面板，不要立即启动一份相同任务，以免留下两份互相竞争的修改。
检查分支和改动，再决定怎样合并
官方说明，在 Git 工作区新建的代理各用自己的 worktree 与分支。先核对分支，再看实际差异；目录隔离不能替你判断改动是否正确。
如果混用 Codex，0.1.9 的已知问题是它不能在自己的 worktree 中提交，需使用代理卡片的 Commit changes。不要把这个例外套到所有 Claude Code 任务，也不要仅为消除状态提示就提交未审阅的文件。
建议指定一个最终集成者，先读每个分支的差异，再按依赖顺序合并。例如一个代理改了接口，另一个写了调用方测试，应先对照参数与返回值是否一致；各自任务都完成，并不代表组合后可以运行。合并后再执行项目已有的相关测试，并检查是否留下重复实现或过期说明。
首次使用保留审批，并识别尚未开放的功能
权限文档将 Approve 列为默认模式：工作区读取可进行，写入和命令在没有适用规则时需要询问。第一次并行建议保留这一模式，逐项看清文件修改、命令和目标目录，再决定是否批准。
Gemini CLI 在 KalCode 0.1.9 中不可用；这是当前集成的限制，不能推广为其他 Gemini 产品都不能使用。若你的目标是四个 Claude Code，本次验收只围绕已经接入的 Claude 账户进行。
官网把 Squads、Agent Handoff Chains 和文件归属冲突预警等列为 Coming soon，不能拿演示布局或套餐路线图当作已具备这些能力。现阶段应自己写清任务交接条件：由谁检查结果、下一项工作依赖什么，以及遇到重复修改时由谁决定保留哪一份。
验收结束时，回到每个代理确认实际输出，再检查仓库差异和仍在运行的任务。四开成功的标准应是四项工作各有清楚的责任与可检查的结果，而不是屏幕上同时出现四个忙碌窗口。
资料来源
常见问题
免费 KalCode 能同时运行四个 Claude Code 吗？
不能。Free 的并行代理上限是 1 个，Pro 为 4 个。套餐容量与 Claude 账户的模型使用额度是两回事，应分别核对。
升级后仍然只能开一个，先查哪里？
先核对当前 KalCode 账户和套餐，再盘点其他工作区中的运行任务，最后记录启动时的准确报错。先确认失败发生在哪一步，不要反复购买套餐或重复启动同一任务。
Windows 0.1.6 点更新没有反应怎么办？
官方列明该版本不能自行更新，需要从官网下载新版安装器运行一次。先保存当前工作，再按下载页核验文件，不要为升级删除应用数据。
系统终端中的 Claude 已经登录，为什么 KalCode 还要登录？
两者可能使用不同配置。KalCode 为每个账户维护独立托管配置，应在 Providers → Accounts 内完成对应账户的 Sign in。
四个代理都说完成，就可以直接交付吗？
建议先检查四份结果是否针对正确任务，审阅实际文件差异，再合并并运行相关测试。尤其要核对接口、配置和测试假设是否一致，完成回复本身不能替代验收。