Codor 是一个面向多 AI 编程代理协作的本地化“共享频道”工具。它允许 Claude Code、Codex、Cursor CLI、Gemini CLI、GitHub Copilot CLI、OpenCode 等不同编码 Agent 保持各自原生会话和上下文，同时在同一个持久频道中交换消息、任务、运行记录、文件证据和状态。项目使用 TypeScript 开发，MIT 许可，目前处于 alpha 阶段，重点强调本地自托管、隐私保护和跨设备私有访问。
适用领域
AI 编程助手 / 多 Agent 协作 / 开发者工具 / 本地自托管 / CLI 工具 / PWA/Web 控制台 / 隐私优先协作系统 / 远程开发工作流
配置难度
中等偏高。基础安装相对简单，一条 npx 命令即可完成；但要充分发挥多 Agent 协作、已有会话接管、远程访问、hooks/notify、隐私配置等能力，需要熟悉 CLI、Node.js、本地服务、Tailscale 以及各类 AI Agent 工具。
商业价值
对 AI 编程重度用户和研发团队有较高探索价值。它可以把多个编码代理组织成可追踪、可恢复、可协作的工作流，提升复杂任务中的规划、实现、评审和验证效率。其本地优先和隐私导向设计适合对代码安全敏感的场景。不过由于仍处于 alpha 阶段，短期更适合个人效率提升、内部实验、多 Agent 工作流研究和原型验证；若用于商业生产环境，需要先评估稳定性、安全隔离、权限控制和团队运维成本。
01
技术亮点
- 支持多个主流编码 Agent 在同一频道中协作，而每个 Agent 仍保留自己的原生会话和上下文。
- 本地优先：消息、提及、工具证据、文件、未读状态和运行历史保存在用户机器上。
- 安装体验较完整，一条 npx 命令即可完成守护进程配置、配对和本地 Web 访问。
- 跨平台支持 Linux、macOS、Windows 原生环境和 WSL2。
- 支持将已有 Claude Code 或 Codex 会话加入频道，降低迁移成本。
- 支持 PWA 浏览器界面，适合长期观察 Agent 工作流。
- 可通过 Tailscale 实现手机、平板或其他电脑上的私有远程访问。
- 提供 CLI 常用命令，例如 channels、post、tail、revive、join、adopt、attach。
- 强调隐私，不通过 Codor 托管服务传输频道数据，远程 relay 无法解密频道内容。
- MIT 许可证，便于个人和商业场景二次开发或集成。
02
目标用户
- 同时使用多个 AI 编程代理的开发者
- 希望让 Claude Code、Codex、Gemini、Copilot 等工具协同工作的个人开发者
- AI Coding 工作流重度用户
- 需要长期运行、可恢复 Agent 会话的工程师
- 关注代码和上下文不经过第三方托管服务的隐私敏感团队
- 研究多 Agent 软件工程流程的开发者
- 愿意尝试 alpha 阶段工具并反馈问题的早期用户
03
配置要求
- Node.js 22.12.0 或更高版本是必需条件。
- 普通安装主要使用 npx @richhardry/codor install。
- Git 和 pnpm 仅在源码开发时需要；推荐 pnpm 10.9。
- 需要至少一个已认证的 AI Agent CLI。
- 默认本地端口为 8137，建议保持监听在 localhost。
- 远程访问建议使用 Tailscale Serve 等私有认证隧道，不建议直接暴露到公网。
- Windows WSL2 用户可在 WSL 中运行 setup，然后从 Windows 浏览器访问 http://127.0.0.1:8137。
- 如果启用远程 relay、push、DHT lines 或桥接功能，应先阅读隐私文档并理解元数据与加密边界。
- Agent 进程仍以当前 OS 用户身份运行；如需真正隔离，应使用单独系统账户、虚拟机或容器。
04
适用场景
- 在一个频道中让 planner、coder、reviewer 等多个 Agent 分工协作
- 通过 @mention 给特定 Agent 分配任务并等待回复
- 将已有 Claude Code 或 Codex 会话加入 Codor 频道，而不必重新开始上下文
- 在浏览器 PWA 中查看人类和 Agent 的完整时间线、未读状态和运行历史
- 电脑休眠、断网或服务重启后恢复 Agent 工作流
- 通过 Tailscale Serve 从手机、平板或另一台电脑私有访问本地 Codor
- 在本地保存消息、工具证据、文件、运行记录，减少敏感数据外泄
- 为复杂开发任务建立多角色 AI 评审、实现、测试流程
05
部署与配置
- 确认本机 Node.js 版本为 22.12.0 或更高。
- 至少安装并登录一个受支持的 Agent CLI，例如 Claude Code、Codex、Cursor CLI、Antigravity agy、Gemini CLI、GitHub Copilot CLI 或 OpenCode。
- 执行安装命令：npx @richhardry/codor install。
- 按照交互式安装向导完成本机检查、私有文件准备、浏览器连接方式选择和守护进程启动。
- 安装完成后打开输出的配对链接，使用 URL、二维码或 8 位配对码完成浏览器配对。
- 默认通过 http://127.0.0.1:8137 本地访问 Codor。
- 如需预览安装但不修改系统，可执行：npx @richhardry/codor install --dry-run。
- 如需无人值守安装，可执行：npx @richhardry/codor install --yes --access localhost，或选择 --access tailscale。
- Linux 会安装为 systemd user service；macOS 会安装为登录后启动的 LaunchAgent；Windows 原生环境会安装为隐藏的每用户 Task Scheduler 服务。
- 源码开发时可克隆仓库后运行 pnpm install --frozen-lockfile && pnpm -r build，并使用 scripts/install-cli.sh 或 scripts/install-cli.ps1 安装开发版 CLI。
06
风险与注意事项
- 项目明确标记为 alpha，功能可能未完成、不稳定或频繁变化，不适合直接用于关键生产流程。
- 对 Node.js 版本要求较新，低版本环境需要升级。
- 多 Agent 工作流本身复杂，配置 hooks、notify、session 识别、Tailscale 等高级功能可能有一定学习成本。
- Agent 凭据不是沙箱机制，Agent 仍以当前操作系统用户权限运行，存在误操作、读写敏感文件或执行危险命令的风险。
- 如果错误地将 8137 端口暴露到公网，可能带来安全和隐私风险。
- 依赖外部 Agent CLI 的稳定性、认证状态和接口行为；上游 CLI 变化可能影响 Codor 适配器。
- 仓库星标数量中等，生态和社区成熟度仍有待观察。
- README 中提到部分远程、桥接、DHT、push 等能力需要谨慎阅读隐私文档，说明安全模型较复杂。
2026-07-26
第27名
新收录 · github_search
2026-07-25
第30名
新收录 · github_search
