Chat Codex：在你的个人微信和飞书中使用 Codex。手机即可操作本机 Codex，支持图片/文件、审批机制、远程控制。
项目介绍
Chat-Codex 是一个轻量的聊天渠道中间件，把本机运行的 OpenAI Codex CLI 接入微信（个人微信）和飞书。
让你可以直接在聊天窗口里与 Codex 对话、执行任务、审批操作、远程控制本机电脑。
核心职责
| 职责 | 说明 |
|---|
| 消息转换 | 把微信/飞书的消息转换为统一内部协议 |
| Session 管理 | 按聊天 route 分配独立的 Codex session |
| 生命周期管理 | 管理 session、任务队列、权限和审批流 |
| 终端 TUI | 统一管理渠道、绑定和运行状态 |
解决了什么问题
| 痛点 | Chat-Codex 解法 |
|---|
| Codex 只能在本地终端用，不能随时随地访问 | 接入微信/飞书，手机即可操作本机 Codex |
| 多个聊天同时使用时上下文容易混乱 | 每个聊天 route 绑定独立的 Codex session，严格隔离 |
| Codex 执行危险操作前没有确认环节 | 内置审批机制，敏感操作需在聊天中显式批准 |
| 本机文件/截图无法方便地发给 Codex 处理 | 支持图片/文件接收，自动下载到本机后作为上下文输入 |
| 无法远程获取 Codex 生成的文件 | 支持 /sendfile 让 Codex 把本地文件发回聊天 |
系统架构
┌─────────────────────────────────────────────────────────────┐
│ Chat-Codex 系统架构 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ │
│ │ 微信 │ │ 飞书 │ │
│ │ WeChat │ │ Feishu │ │
│ └──────┬──────┘ └──────┬──────┘ │
│ ↓ ↓ │
│ ┌─────────────────────────────────────┐ │
│ │ Chat-Codex 中间件 │ │
│ │ • 消息协议转换 │ │
│ │ • Session 管理 │ │
│ │ • 审批流程 │ │
│ │ • 文件传输 │ │
│ └──────────────────┬──────────────────┘ │
│ ↓ │
│ ┌─────────────────────────────────────┐ │
│ │ Codex CLI + TUI │ │
│ │ • 本地运行 │ │
│ │ • 自然语言处理 │ │
│ │ • 代码生成 │ │
│ └─────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
安装前准备
环境要求
| 要求 | 说明 |
|---|
| Node.js | 18.x 或更高 |
| npm/yarn | 包管理器 |
| Codex CLI | 已安装并配置好 |
| 网络 | 可访问 OpenAI API |
准备工作
| 步骤 | 操作 |
|---|
| 1 | 安装 Node.js（如果还没有） |
| 2 | 安装 Codex CLI |
| 3 | 配置 Codex API Key |
| 4 | 克隆项目代码 |
详细安装步骤
Step 1：安装 Node.js
| 平台 | 命令 |
|---|
| macOS | brew install node |
| Linux | curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - && sudo apt-get install -y nodejs |
| Windows | 下载安装包：https://nodejs.org/ |
Step 2：安装 Codex CLI
bash# macOS / Linux
npm install -g openai-codex
# 验证安装
codex --version
Step 3：克隆项目
bash# 克隆仓库
git clone https://github.com/your-repo/chat-codex.git
# 进入目录
cd chat-codex
# 安装依赖
npm install
Step 4：配置
bash# 复制配置模板
cp config.example.yaml config.yaml
# 编辑配置
# 填入你的配置信息
Step 5：启动
bash# 开发模式
npm run dev
# 生产模式
npm run build
npm start
微信接入配置
前提
| 要求 | 说明 |
|---|
| 个人微信 | 需要一个微信账号 |
| 网页登录 | 微信需要开启网页登录 |
配置步骤
| 步骤 | 操作 |
|---|
| 1 | 在 config.yaml 中启用 WeChat 渠道 |
| 2 | 运行启动命令 |
| 3 | 用微信扫码登录 |
| 4 | 绑定微信账号和 Codex session |
配置示例
yamlchannels:
wechat:
enabled: true
auto_login: false
session_per_user: true
飞书接入配置
前提
| 要求 | 说明 |
|---|
| 飞书账号 | 企业或个人账号 |
| 自建应用 | 需要创建一个飞书自建应用 |
创建飞书应用
配置步骤
| 步骤 | 操作 |
|---|
| 1 | 在 config.yaml 中启用 Feishu 渠道 |
| 2 | 填入 App ID 和 App Secret |
| 3 | 配置 Webhook 地址 |
| 4 | 重启服务 |
配置示例
yamlchannels:
feishu:
enabled: true
app_id: "cli_xxxxx"
app_secret: "xxxxx"
verification_token: "xxxxx"
encrypt_key: "xxxxx"
命令参考
基本命令
| 命令 | 功能 |
|---|
@codex 你好 | 激活 Codex 并发送消息 |
/new | 创建新的 Codex session |
/clear | 清除当前 session 上下文 |
/model gpt-4 | 切换模型 |
/abort | 终止正在执行的任务 |
文件命令
| 命令 | 功能 |
|---|
/sendfile | 让 Codex 发送文件到聊天 |
/upload | 上传文件给 Codex 处理 |
审批命令
| 命令 | 功能 |
|---|
/approve | 批准当前操作 |
/reject | 拒绝当前操作 |
/pending | 查看待审批操作 |
管理命令
| 命令 | 功能 |
|---|
/status | 查看连接状态 |
/session list | 列出所有 session |
/session switch | 切换 session |
审批机制
为什么需要审批
| 场景 | 风险 |
|---|
| 删除文件 | 可能误删重要文件 |
| 执行命令 | 可能破坏系统 |
| 发送文件 | 可能泄露敏感信息 |
审批流程
Codex 发起操作请求
↓
系统拦截操作
↓
用户收到审批提示
↓
用户批准 / 拒绝
↓
执行 / 取消操作
配置审批规则
yamlapproval:
enabled: true
rules:
- type: "delete"
require_approval: true
- type: "execute"
require_approval: true
- type: "network"
require_approval: true
常见问题
| 问题 | 解决方案 |
|---|
| 微信扫码登录失败 | 检查网络，尝试重新扫码 |
| 飞书消息收不到 | 检查 Webhook 配置 |
| Codex 不响应 | 检查 API Key 配置 |
| Session 混乱 | 使用 /new 创建新 session |
适用场景
| 场景 | 说明 |
|---|
| 移动办公 | 手机上随时调用 Codex |
| 远程协助 | 远程控制家庭/办公电脑 |
| 多账号管理 | 不同聊天绑定不同 session |
| 审批流程 | 敏感操作需要批准 |
一句话总结
Chat-Codex = 把 Codex 接入微信/飞书，手机上随时用 AI 编程助手，支持文件传输、审批机制、远程控制。
核心价值：
- 移动端随时访问本地 Codex
- 多账号严格隔离
- 内置审批机制保护安全
- 文件和截图直接发给 Codex 处理
适用人群：需要在移动端使用 Codex、需要审批流程、多账号管理的用户。
