资料来源飞书 CodeM 官方帮助中心(公开飞书知识库《欢迎使用飞书 CodeM》及其下的快速入门、Bot、CLI、桌面 App、管理应用、沙箱、插件、飞书项目集成、配置迁移、计费、FAQ、更新日志)、官网 codem.feishu.cn,以及飞书帮助中心《飞书 AI 用量套餐权益与额度消耗规则说明》《管理员为企业 AI 权益设置限额》。成熟度为「预览」,版本迭代很快,以官方更新日志为准。
CodeM 是什么
飞书 CodeM 是飞书原生的企业级 Coding Agent,2026 年 7 月 15 日正式发布。它和 Claude Code、Codex 干的是同一类活(写代码、修 Bug、跑测试、做需求),区别在于面向团队:可以挂在飞书项目的流程节点上自动触发,工作结果记在飞书项目里,企业能统一配置规范、知识库和云端沙箱。它由四部分组成:
| 组成 | 用来做什么 |
|---|---|
| 飞书 CodeM Bot | 飞书里私聊或在群里 @ 它派活,任务路由到你绑定的设备上执行 |
| CLI | 装在本机的命令行,一台电脑就是一个执行环境 |
| 桌面 App | macOS、Windows 客户端,内置 CLI |
| Web 管理应用 | 配置项目空间、关联飞书项目、知识库、团队规范、沙箱、数据报表 |
开通
- 组织要先有 CodeM 使用权益:在官网
codem.feishu.cn/contact申请试用,或购买额度(见下文计费)。2026 年 8 月 17 日起开始计费,此前领的试用额度作废。 - 飞书 SaaS 租户和飞书数据私有化租户可以买,纯私有化租户不支持。CodeM 本身是 SaaS。
- macOS App 要求 macOS 14 及以上。
1安装和登录
# macOS / Linux / Windows WSL
curl -fsSL https://codem-public.tos-cn-beijing.volces.com/codem/install.sh | bash
# Windows PowerShell
irm https://codem-public.tos-cn-beijing.volces.com/codem/install.ps1 | iex
安装脚本会装 CodeM CLI(npm 包 @lark-codem/codem-cli,命令 codem),并顺带装好飞书 CLI 和飞书项目 CLI;本机没有合适的 Node.js 时会自动装一个。
| 你打算怎么用 | 登录命令 |
|---|---|
| 只在飞书里用 Bot | codem login,按提示打开授权页或扫码 |
| Bot 和命令行都用 | 直接执行 codem,授权后进入 CLI |
两个命令都会拉起常驻的 daemon。Bot 只能把任务派到 daemon 在线的设备上,电脑关了 Bot 就没法在这台机器上干活。Windows 上 codem service start 会弹出一个终端窗口,关掉它 daemon 也停了。
别装错包npm 上叫 codem 的包是个人项目,和飞书无关。FAQ 里出现过一个字节内网的安装地址,外部用户以快速入门里的公开地址为准。
2常用命令
codem auth status # 登录状态;codem logout 退出
codem service start|status|restart|stop # 管理 daemon
codem daemon --cwd ~/code/my-app # 指定工作目录启动 daemon
codem -p "修复登录页的表单校验" # 单次执行
codem -p "..." --plan # 先出计划
codem -p "..." --reasoning-effort high
codem sessions list # 会话记录在 ~/.codem/sessions/ 下
codem bg # 后台任务;codem bg-kill <pid> 结束
codem update # 升级
codem report # 上报问题
--yolo 跳过所有确认,官方只建议在可信沙箱里用。
3在飞书里用 Bot
- 飞书搜索「飞书 CodeM」,选 Bot(前提是已经装好 CLI 并登录)。
- 通过菜单新建会话、切换空间、切换设备、切换目录、设置权限模式。
- 群聊里必须 @ 飞书 CodeM 才会触发,谁发起就路由到谁的设备;话题里可以单独选工作目录。
执行过程以卡片形式回来:进度、向你提问、权限确认(仅允许本次 / 本会话允许 / 拒绝)、结果和交付确认。交付物(预览链接、图片、文件、视频)会标注「已验证」或「待验证」。常用斜杠命令有 /new、/clear、/context、/skills、/stop、/help。权限模式在「默认模式」「全部放行」之外,9 月 10 日的版本新增了「替我审批」。
4桌面 App
从官网下载,首次启动检查 CLI 并用飞书登录。执行前可以选权限(默认 / 完全访问)、开「规划模式」(先出计划,确认后执行)、调推理强度。App 里还有待办面板、Git 变更面板(暂存、提交、推送、切分支)、内置终端、技能和插件、本地定时自动化(需要 App 保持运行)。常用快捷键:⌘K 全局搜索、⌘N 新建会话、⌘. 停止当前任务。
从 Claude Code、Codex 迁过来
官方专门写了《零成本迁移已有 Coding Agent 配置》,说明怎么把 Claude Code、Codex、Cursor 里已有的规范文件、技能等配置搬到 CodeM。团队已经给 Claude Code 写好了 AGENTS.md 这类规范的,先看这篇。空间级的「行为准则」本身也是 AGENTS.md 形式。
团队配置:项目空间、沙箱、插件
| 能力 | 个人空间 | 项目空间 |
|---|---|---|
| 关联飞书项目 | 不支持 | 支持,一个 CodeM 空间只关联一个飞书项目空间 |
| 沙箱 | 不支持 | 支持 |
| 数据报表 | 不支持 | 支持 |
空间里配置「智能体定义」(行为准则、关联的飞书项目、知识库)和「技能与工具」(技能、MCP 工具、插件,可设对成员会话、沙箱任务或两者生效)。
沙箱让飞书项目的流程在云端自动跑 CodeM:
- 在「智能体定义 → 飞书项目空间」关联飞书项目。
- 在「沙箱」里「创建沙箱集群」:填名称、执行要求、基础镜像,选环境模式(普通模式授权 GitHub / GitLab 仓库;自定义模式写初始化脚本)。
- 在「凭证管理」录入环境变量,只有空间管理员可见。
- 「添加沙箱实例」:选 CodeM 云端沙箱,或点「生成指令」拿一次性连接指令,把企业自己的机器接进来。
- 在飞书项目的自动化或 AI 节点里选这个 CodeM 空间和沙箱集群。
和飞书项目联动:飞书项目的「AI 操作」里有「CodeM AI 操作」,官方举的例子是工作项流转到「AI 修复」状态时自动调用 CodeM 修 Bug。配置路径为「空间配置 → 工作项类型 → 流程配置 → 点状态 → AI 应用」,或在「自动化配置」里添加。飞书项目 AI 只对旗舰版和行业专版开放。
插件:入口文件 .codem-plugin/plugin.json,可以包含 agents、skills、commands、hooks、.mcp.json,打包成 ZIP 导入,压缩前后都不超过 10MB。CodeM 内置飞书 CLI,读写飞书资料时按你本人权限,首次使用或需要新权限时会弹授权。
计费与限额
| 额度来源 | 官方说明 |
|---|---|
| 飞书 AI 用量套餐 | 目前只能用于 CodeM;刊例价 99,000 元/年,每月 20 万点、按月刷新不结转,赠送 10 台云沙箱;可叠加购买 |
| 飞书 AI 版本的通用额度 | 也能扣 CodeM,但不含云沙箱权益 |
- 按任务复杂度和实际消耗扣点,生成中断或失败不扣;两种额度都有时先扣月度额度。选高推理强度会更费。
- 买了之后默认全员可用、不限量。管理员在飞书管理后台「资产管理 → AI 使用管理 → 限额管理」里分别给「AI 月度额度」和「AI 通用额度」设上限:「CodeM Coding 智能体」可按成员、部门、用户组限,「CodeM 沙箱应用」只能整体限。两处要分别配。
- 用量日志里能看到调用入口(CLI、Bot、桌面端)、设备名和空间 ID;月度额度的数据从 2026 年 8 月 17 日起才有。
官方文档
- 官网 · codem.feishu.cn · 更新日志
- 帮助中心 · 欢迎使用飞书 CodeM · 快速入门 · CLI · Bot · 零成本迁移已有 Coding Agent 配置 · 沙箱使用与配置 · 计费配置与用量查看 · FAQ
- 飞书帮助中心 · 飞书 AI 用量套餐权益与额度消耗规则说明 · 管理员为企业 AI 权益设置限额
- 飞书项目帮助中心 · AI 操作