在飞书中高效使用 Claude Code / Codex

在工作中各种 coding agent 给研发带来了很大的效率提升。如何让飞书群里的其它非技术同学也能受益？Botmux 可以把 Claude Code / Codex 等编程 Agent 接入飞书，通过飞书聊天就能使用，显著降低了使用门槛。

但用飞书操作 coding agent，要想获得大的收益，不仅仅是艾特机器人聊天、或者读写飞书文档那么简单。最关键的地方是如何管理智能体的上下文。本文简述怎么在飞书上做编程 Agent 的上下文管理。

💡 在 botmux 里，「一个话题 = 一个独立的 AI 大脑」。每个会话有自己独立的对话记忆，彼此完全不串。用好它的关键，就是有意识地为不同任务开不同的话题，并管理好这些会话的生命周期。

一、一分钟搞懂 botmux

botmux 把飞书和 AI 编程 CLI（Claude Code、Codex、Cursor、Gemini 等）连了起来。你在飞书里发消息，它在后台为你跑一个真正的 AI 编程命令行，并把过程实时回传成飞书卡片。

对使用者来说，只需要记住一件事：你不是在和一个「全局 AI」聊天，而是在和一个个独立的「会话」聊天。每个会话背后是一个独立的 CLI 进程加一份独立的对话记忆。

💡 botmux 不重造 AI 能力，而是直接桥接成熟的编程 CLI。所以 CLI 自带的记忆、上下文压缩、工具调用、Skill、斜杠命令你都能用，区别只是入口从终端换成了飞书。

二、心智模型：会话 = 独立的上下文容器

日常使用 botmux，绝大多数时间只在两个地方：普通群，以及和机器人的私聊。这两个场景的「会话边界」规则正好相反，搞清楚它们，是用对上下文的关键。

💡 核心差异：普通群默认「整群共享一个会话」，大家的消息进同一份上下文；私聊默认「每条顶层消息开一个独立话题」，条条隔离。两者用法相反。

🏢 场景一：普通群

默认行为是整群共享一个会话（chat-scope），群里所有人的消息都进同一份上下文。这意味着别人插话会混进同一记忆；你前后聊的不同任务也会互相串味。正确用法：

• 开始一件新任务，先发 /t 开一个独立话题，把它从群聊里「切」出来，避免被别人的消息或上一个任务干扰。
• 只有当多人要围绕同一份上下文协作时，才让大家在整群里直接聊。
• 任务结束，在该话题里 /close 归档，保持清爽。

👤 场景二：和机器人私聊

默认行为是你每发一条顶层消息，就自动开一个独立话题（thread），机器人在那个话题里回复你。这意味着连发两条不相关的消息等于两个空白会话，第二条不知道第一条。正确用法：

• 互不相关的小任务，直接发新消息，天然各自隔离，不会互相污染。
• 想接着上一条继续聊，在机器人那条话题卡片里「回复」，而不是发一条新的顶层消息。
• 想要全程一条连续对话线（像普通聊天软件），让管理员把私聊配成 p2pMode=chat。

✅ 推荐记忆法：记住这个反差——普通群要你「主动开话题」才隔离；私聊默认就隔离，要你「主动回复」才连续。

无论哪种场景，底层规则都一样：一个会话 = 位置（anchor）× 机器人。所以同一个话题里 @ 不同机器人，它们的上下文也彼此不通。

三、该在哪开会话？

每次准备发消息前，花一秒问自己：「这是接着刚才的事，还是一件新事？」按下图选择即可：

flowchart TD
  A[准备发起一个任务] --> B{接着刚才的对话吗?}
  B -->|是, 延续上下文| C[在原话题里直接回复]
  B -->|否, 这是新任务| D{需要干净独立的上下文}
  D -->|话题群| E[直接发起一个新话题]
  D -->|普通群| F[先发 /t 开一个新话题]
  C --> G[同一会话: 记忆延续, AI 知道前因后果]
  E --> H[全新会话: 空白上下文, 不受其他任务干扰]
  F --> H

❗ 在普通群里直接连发不相关的任务，会把它们全堆进同一个会话的记忆里，AI 可能被前一个任务的上下文带偏。任务一换，就开新话题。

四、上下文隔离的黄金法则

• 一话题一任务。不同任务开不同话题，别在一个会话里混着推进多件事。
• 需要延续上下文，就回到原话题。会话的记忆只在它自己的话题里，换地方说等于失忆。
• 上下文脏了就重开。聊跑偏、试错太多导致 AI「记忆污染」时，开个新话题比反复纠正更高效。
• 关闭 ≠ 删除。/close 只是停掉进程，对话历史还在，随时能恢复接着聊。
• 换目录保上下文用 /cd，换仓库用 /repo（会新开会话）。想保留当前对话、只换工作目录，用 /cd（同一会话不变，上下文延续）；/repo 是换仓库，会关闭当前会话、另起一个空会话，旧上下文不带走。

✅ 把话题当成「一次性的专注工作台」——开一个、用完它、需要时归档恢复。不要指望一个话题承载你所有的事。

五、管理你的会话：命令、恢复与面板

会话只有两种状态：运行中（active）和已关闭（closed）。关闭不丢历史，随时能恢复，这是 botmux 上下文管理的核心保障。

它们之间的流转是这样的：

stateDiagram-v2
  [*] --> Active: 在话题里首次发言
  Active --> Active: 继续对话 (记忆累积)
  Active --> Closed: /close (停进程, 留历史)
  Closed --> Active: 点恢复按钮 (--resume 接回原记忆)
  Closed --> NewSession: 话题里直接再发消息
  NewSession --> Active: 全新空白会话
  note right of Closed: 历史不删, jsonl 留在磁盘

常用的会话管理命令：

💡 关键事实：关闭后在同一个话题里再发消息，会开一个全新的空白会话，而不是接回旧的。想接着旧上下文，必须点「恢复」按钮。同一个话题下因此可以同时存在「1 个运行中 + 多个已关闭」的历史会话。

想总览和管理所有会话，用 Web Dashboard：按机器人和 scope 分组列出全部运行中 / 已关闭会话，能看标题、状态、工作目录、最后活跃时间，并一键「定位飞书聊天 / 恢复 / 关闭 / 开终端」。

六、除了上下文，日常还要留意的几点

把会话上下文管好之后，下面几件事同样影响 agent 干活的效果，本质上都是「另一种上下文」或交互习惯。

❗ 最该先确认的是工作目录 / 仓库。每个会话只在一个目录里看代码、改文件。新会话的第一步，先确认 agent 在对的仓库里；不对就用 /repo 切换。选错目录等于它在看错的代码，这种错比上下文串味更隐蔽、更难发现。

✅ 把「选对仓库 + 给足资料（附件 / 引用）」当成每次开新任务的固定开场动作，agent 的产出质量会明显更稳。

七、高效使用的技巧

开会话的技巧

• 新任务一律 /t 或新话题起步，给它一块干净上下文。
• 话题名 / 首条消息写清目标，方便日后在 dashboard 里认出它。
• 长任务连发多条没关系，Claude 支持「忙时排队」，消息不会丢。

管上下文的技巧

• 聊跑偏了别硬掰：开新话题重来，比反复纠正省 token、更准。
• 阶段成果出来后，及时 /close 归档，保持会话列表清爽。
• 需要回看老任务：dashboard 找到那个 closed 会话，点恢复。

经验法则：上下文是有成本的资源。会话越长，AI 要「背」的东西越多，越容易跑偏也越费 token。主动切分话题、及时归档，就是在帮 AI 保持专注。

八、常见误区

💡 误区一：以为机器人有「全局记忆」。它没有。换个话题，它就完全不知道你在别处聊过什么。每个会话的上下文是隔离的。

💡 误区二：在普通群里把所有事都堆一起聊。整群共享一个会话，不同任务互相污染上下文。请用话题或 /t 切分。

💡 误区三：以为 /close 会丢历史，所以不敢关。恰恰相反，关闭只停进程不删记忆，随时能恢复。大胆关、保持清爽。

💡 误区四：关闭后想接着聊，却直接在话题里发消息。那样只会开一个全新空白会话。要续上旧记忆，必须点卡片上的「恢复」按钮。

把每个话题当成一个独立的、可归档可恢复的「专注工作台」：为新任务开新话题，需要延续就回到原话题，乱了就重开，事毕就归档。管好了会话，就管好了 botmux 的上下文。

参考资料

• botmux · GitHub（deepcoldy/botmux）