不用公网 IP，不用域名，办公室内网也能跑。

OpenAI 发布 Codex CLI 的时候，我第一时间就在想：这东西能不能接到飞书里，让团队直接在群聊中调用？

毕竟 Codex 的定位是「软件工程 Agent」——能写代码、能跑测试、能查 bug。如果产品经理在飞书里甩个需求，Codex 直接产出代码草稿，开发同学再接手完善，这个流程听起来就很顺畅。

问题是：Codex 官方没有飞书集成。

这篇文章记录我摸索出来的解决方案 —— 用 cc-connect 把 Codex 桥接到飞书，整个过程 5 分钟搞定。

---

先看效果

配置完成后，在飞书群里 @机器人：

用户：帮我写一个 Python 函数，把 CSV 转换成 JSON，要处理中文编码

Codex：🤔 思考中...
      🔧 执行: Read(csv_to_json.py)
      ✅ 已生成代码，包含 utf-8 编码处理：

      import json
      import csv

      def csv_to_json(csv_file, json_file):
          with open(csv_file, 'r', encoding='utf-8-sig') as f:
              reader = csv.DictReader(f)
              rows = list(reader)
          with open(json_file, 'w', encoding='utf-8') as f:
              json.dump(rows, f, ensure_ascii=False, indent=2)

不需要终端，不需要 SSH 到服务器，飞书里直接对话即可。

---

架构思路

Codex 和 Claude Code 一样，都是本地运行的 CLI 工具。它们需要：

1. 本地代码仓库（工作目录）
2. 与用户的对话交互
3. 执行 Bash、读写文件的权限

飞书机器人本身做不到第 1 和第 3 点 —— 它在云端，你的代码在本地。

cc-connect 的作用就是搭桥：

飞书用户消息 → 飞书开放平台 → WebSocket 长连接 → cc-connect → Codex CLI → 本地代码
                      ↑                                              ↓
                      └──────────── 代码/回复返回 ───────────────────┘

关键点：WebSocket 长连接。这意味着：

• ❌ 不需要公网 IP
• ❌ 不需要域名和 HTTPS 证书
• ❌ 不需要 ngrok/frp 反向代理
• ✅ 办公室内网、家里 NAS、个人笔记本都能跑

---

5 分钟配置流程

1. 安装 cc-connect

npm install -g cc-connect

或者用二进制：

curl -L -o cc-connect https://github.com/chenhg5/cc-connect/releases/latest/download/cc-connect-linux-amd64
chmod +x cc-connect
sudo mv cc-connect /usr/local/bin/

2. 一键配置飞书机器人

cc-connect 内置了飞书配置命令，会自动帮你：

• 生成二维码创建飞书应用
• 申请必要权限
• 配置事件订阅
• 写回 config.toml

cc-connect feishu setup --project my-codex

终端会显示二维码，用飞书 App 扫码即可完成创建。

3. 配置 Codex Agent

编辑 ~/.cc-connect/config.toml：

[[projects]]
name = "my-codex"

[projects.agent]
type = "codex"

[projects.agent.options]
work_dir = "/path/to/your/project"  # Codex 的工作目录
mode = "default"                     # 权限模式：suggest / auto-edit / full-auto / yolo

# 可选：配置你的 OpenAI API Key（如果环境变量已设置可省略）
[[projects.agent.providers]]
name = "openai"
api_key = "sk-xxx"

[[projects.platforms]]
type = "feishu"

[projects.platforms.options]
app_id = "cli_axxxxxxxxxxxx"
app_secret = "QhkMpxxxxxxxxxxxxxxxxxxxx"

Codex 支持几种权限模式：

模式	说明
suggest	仅受信命令自动执行，其他需确认
auto-edit	模型自行决定是否执行
full-auto	自动执行 + 沙箱保护
yolo	跳过所有确认，全自动

建议先用 suggest 或 auto-edit，熟悉后再切 yolo。

4. 启动服务

cc-connect

日志显示 platform started 即表示连接成功。

5. 飞书里添加机器人

• 私聊：直接搜索机器人名称发送消息
• 群聊：群设置 → 群机器人 → 添加机器人

---

进阶玩法

语音消息转文字

飞书群里发语音，cc-connect 自动转文字发给 Codex。需要配置 OpenAI 或 Groq 的 Whisper API。

[speech]
enabled = true
provider = "openai"

[speech.openai]
api_key = "sk-xxx"

定时任务

让 Codex 定时执行任务：

/cron add 0 9 * * 1 检查上周代码提交，生成周报草稿

每周一早上 9 点自动执行。

多机器人协作

群里同时有 Claude Code 和 Codex：

/bind codex      # 绑定 Codex
/bind claudecode # 绑定 Claude Code

然后可以让它们讨论方案：「@codex 写个实现，@claudecode review 一下」。

运行时切换 Provider

/provider switch openai
/provider switch anthropic

不用重启服务，随时切换底层模型。

---

对比其他方案

方案	需要公网IP	配置复杂度	多Agent支持	语音/定时任务
自建 Webhook 服务	✅ 需要	高	无	无
ngrok 代理	❌ 不需要	中	无	无
cc-connect	❌ 不需要	低	7个Agent	支持

如果你只是想把 Codex 接到飞书，不想折腾服务器和域名，cc-connect 是目前最省心的选择。

---

常见问题

Q: Codex 和 Claude Code 有什么区别？

Codex 是 OpenAI 的软件工程 Agent，在代码生成、重构、测试方面很强，支持 suggest / auto-edit / full-auto 三种执行模式。Claude Code 是 Anthropic 的 Agent，工具调用更丰富，支持浏览器、图片分析等。两者可以都用，场景不同。

Q: 飞书长连接会断吗？

cc-connect 内置自动重连，断线后会自动恢复。

Q: 可以在群聊里用吗？

可以。群聊中 @机器人即可，也支持 thread 隔离（每个话题独立会话）。

Q: 支持其他平台吗？

cc-connect 还支持钉钉、Telegram、Discord、Slack、企业微信、LINE、QQ。配置方式类似。

---

相关资源

• GitHub: github.com/chenhg5/cc-connect
• 飞书接入文档: docs/feishu.md
• 完整使用指南: docs/usage.zh-CN.md

---

如果你成功把 Codex 接到了飞书，欢迎在评论区分享你的使用场景。

觉得有用的话，给 cc-connect 点个 ⭐️，让更多人看到这个工具。