接入5大AI编码Agent:IM.codes连接Claude Code、Codex、Gemini CLI、OpenClaw与Qwen全流程
接入5大AI编码Agent:IM.codes连接Claude Code、Codex、Gemini CLI、OpenClaw与Qwen全流程
IM.codes 是一款专为 AI 编码 Agent 打造的"IM 工具",它能把 Claude Code、Codex、Gemini CLI、OpenClaw、Qwen 五大主流 AI 编码 Agent 接入同一个看板:一个界面里看所有 Agent 的终端输出、Git 变更与任务状态,还能让它们共享记忆、互相发消息、跨模型审计。本文将带你从零开始,走通"安装 → 绑定 → 接入 5 大 Agent → 多 Agent 协作"的完整流程,全程只有三条核心命令。
一、为什么需要统一入口?💡
日常写代码时,很多人同时装了几个 AI 编码 Agent:Claude Code 负责重构、Codex 跑测试、Gemini CLI 做评审……但问题来了:
- 每个 Agent 都关在各自的终端里,人一走开,工作流就断掉,回来得靠 SSH 或 tmux attach 一个个找;
- Agent 之间互不通信,上下文也各存各的,换个模型就丢掉前文;
- 单模型输出不稳定,缺少跨模型的交叉审查。
IM.codes 的定位不是再造一个 AI IDE,而是做一个围绕这些 Agent 的消息、记忆与控制层。它通过一个轻量 daemon 管理本机 Agent 会话,再经自托管 Server 同步到浏览器和手机,架构非常简单:
你(浏览器 / 手机)
↓ WebSocket
Server(自托管)
↓ WebSocket
Daemon(你的开发机)
↓ tmux / SDK / 托管 MCP
Claude Code · Codex · Gemini CLI · OpenClaw · Qwen
↔ imcodes send(Agent 互发消息)
二、动手前准备:环境要求清单 ✅
在开始之前,请确认开发机满足以下条件:
| 项目 | 要求 |
|---|---|
| 操作系统 | macOS / Linux(已验证);Windows 10+ 实验性支持(ConPTY,无需 WSL) |
| Node.js | ≥ 22 |
| 终端复用器 | Linux/macOS 需安装 tmux;Windows 自动使用 ConPTY |
| Agent | 至少安装下文 5 大 Agent 中的任意一个 |
💡 五大 Agent 的接入方式略有不同:Claude Code 和 Codex 支持"CLI 或 SDK"两种形态,Gemini CLI、OpenClaw、Qwen 各有专属通路,下文逐一说明。
三、两步部署:安装 IM.codes 并绑定开发机
1️⃣ 一条命令安装
npm install -g imcodes
2️⃣ 绑定你的机器
快速体验可以用官方共享实例,正式使用则强烈建议自托管(下文附一键自托管命令):
imcodes bind https://app.im.codes/bind/<api-key>
imcodes bind 会一次性完成四件事:绑定机器 → 启动 daemon → 注册为系统服务 → 让这台机器出现在 Web/移动端面板里。如果你希望数据完全留在自己的基础设施里,只需加一步:
imcodes setup --domain imc.example.com
这条命令会自动生成配置、启动 PostgreSQL + Server + Caddy(自动 HTTPS)、创建管理员账户并绑定本机 daemon,全程一条命令,最后打印出登录凭据。
四、两种接入模式:搞懂 Agent 是怎么连上来的
IM.codes 内部把 Agent 分成两类运行时(类型定义见 shared/agent-types.ts):
- 进程型(Process):通过 tmux 在终端里拉起 Agent CLI,靠解析终端输出判断状态。目前包含
claude-code、codex、opencode、gemini以及shell、script,驱动映射逻辑在 src/agent/session-manager.ts; - 传输型(Transport):通过网络协议或本地 SDK 直连 Agent,拿到结构化事件流,支持实时 delta 更新、工具调用跟踪和会话恢复,体验接近原生流式输出。
五种状态(idle / streaming / thinking / tool_running / permission 等)的检测规则集中在 src/agent/detect.ts,这也是侧边栏能实时显示每个 Agent"在思考 / 在跑工具 / 在等确认"的原理。
结论:你不需要为每个 Agent 写配置——只要本机装好了对应的 CLI 或 gateway,IM.codes 就能识别并以合适的方式接入。
五、逐个接入:5 大 Agent 全流程 🚀
1. Claude Code:CLI 与 SDK 双形态
- CLI 形态:本机装好 Claude Code 并配置好登录凭据后,在面板中新建一个
claude-code类型会话即可,daemon 通过 tmux 托管,支持原始终端与结构化聊天视图切换; - SDK 形态(推荐):走 Claude Code SDK 的流式通路,事件结构化、支持子 Agent 状态跟踪,SDK 接入实现见 src/agent/providers/claude-code-sdk.ts。SDK 型会话还能自动获得 IM.codes 的托管 MCP 工具面(记忆检索、Agent 互发消息、Cron 定时任务)。
2. Codex:与 Claude Code 完全对称
Codex 同样支持 codex(CLI/tmux)与 codex-sdk(SDK 流式)两种接入方式,SDK 实现见 src/agent/providers/codex-sdk.ts。接入后可以在聊天视图里看到 Codex 的 thinking block 和 shell 工具调用,而不是满屏乱码。
3. Gemini CLI:终端型接入最省事
Gemini CLI 走进程型通路,daemon 通过 tmux 拉起 gemini 进程并识别其特有的提示符与转场状态;也提供 gemini-sdk 流式备选(见 src/agent/providers/gemini-sdk.ts)。接入后即可在面板中查看 Gemini 的实时输出与 Git 变更。
4. Qwen:SDK 流式,开箱即用
Qwen 属于传输型 Agent,通过本地 SDK 直连,提供原生流式输出、工具调用跟踪与会话恢复能力,实现见 src/agent/providers/qwen.ts。无需任何额外命令,装好 Qwen 后在面板新建 qwen 会话即可。
5. OpenClaw:一条 connect 命令打通 gateway
OpenClaw 走 gateway 的 WebSocket 通路,接入命令最特别:
imcodes connect openclaw
这条命令会自动完成一整套动作:连接 ws://127.0.0.1:18789、复用 ~/.openclaw/openclaw.json 里的 gateway token、把 OpenClaw 主会话与子会话同步为 IM.codes 的传输型会话、保存配置到 ~/.imcodes/openclaw.json 并重启 daemon 使其自动重连。实现见 src/agent/providers/openclaw.ts,命令入口在 src/index.ts。
几个实用变体:
imcodes connect openclaw --url ws://127.0.0.1:18789 # 指定地址
imcodes disconnect openclaw # 断开并删除配置
⚠️ 注意:OpenClaw 连接流程目前只在 macOS 上验证过;远程非 TLS 的
ws://地址需加--insecure。
六、接入完成后的"爽点":多 Agent 协作玩法 ✨
五大 Agent 接入同一个看板后,真正有意思的事才开始:
① 多会话并行 + 子会话。 面板支持可拖拽标签页,一个运行中的主会话内部还能再派生子会话(Sub-session),让多个 Agent 并行处理不同任务。每个会话都可以随时切换"原始终端 / 结构化聊天"两种视图:
② Agent 互发消息。 任何 Agent 都能用 imcodes send 给兄弟会话发指令,比如让 Codex 去 review Claude Code 改过的文件,--reply 还能让结果自动回传。SDK 型 Agent 也可以通过 MCP 的 send_list_targets / send_message 完成同样的事情,全程无需人工中转。
③ 跨模型 Team 讨论与审计。 输入 @@ 选择参与者,用 @@all(config) 一键发起 audit / review / discuss / brainstorm 多阶段流水线:每轮所有 Agent 读取彼此的前序贡献再作答。一个模型发现竞态条件,另一个指出遗漏的迁移,第三个质疑 API 设计——跨 provider 交叉审查能抓出单模型常漏掉的问题,减少返工。
④ 共享记忆。 IM.codes 会把已完成的 Agent 工作沉淀成"问题 → 解决方案"记忆(只保留最终回答,过滤工具调用等噪音),并在后续会话按相关度自动注入,多语言 embedding 支持跨中、英、日、韩等语言召回。
⑤ 手机上继续盯进度。 面板同步到 iPad / iPhone,任务完成会推通知,Shell 会话还能在手机键盘里直接交互输入,Apple Watch 支持快速查看与快捷回复:
七、常见问题速查 ❓
| 问题 | 解决方式 |
|---|---|
| Linux/macOS 会话建不出来 | 确认已安装 tmux(进程型 Agent 依赖它) |
| Windows 升级后 daemon 不重启 | 执行 imcodes repair-watchdog 重建启动链 |
Windows 提示 imcodes 不是命令 |
npm prefix -g 拿到全局目录后加入 PATH |
| OpenClaw 连不上 | 该流程目前仅 macOS 验证过;非 TLS 远程地址需 --insecure |
| 共享实例不稳定 | 官方建议自托管:imcodes setup --domain 你的域名 |
八、总结
回看整个流程,核心其实只有三步:
npm install -g imcodes—— 安装;imcodes bind(或imcodes setup自托管)—— 绑定机器;- 为 Claude Code、Codex、Gemini CLI、Qwen 新建会话,对 OpenClaw 执行
imcodes connect openclaw—— 接入五大 Agent。
从这一刻起,你的多个 AI 编码 Agent 就共享了同一个消息层、记忆层与审计层:终端、Git、文件、本地 Web 预览全部可视,Agent 之间还能互相协作。单模型会盲视,多模型会收敛——这正是 IM.codes 想带给每位多 Agent 用户的东西。更多功能细节可阅读 README.i18n/README.zh-CN.md 与 src/agent/provider-registry.ts 中的 provider 注册逻辑。



