CodexBridge

CodexBridge 把 Codex 变成可管理的团队 AI 助手入口，支持飞书、Telegram 和本地 operator 使用，并提供用户权限、积分、审计日志和持久化工作区。

语言：中文 · English · Français · 日本語 · 한국어

快速开始 · API Reference · 架构 · Roadmap · Telegram · Feishu

Ask Codex:
Install Moshiii/CodexBridge from GitHub and start CodexBridge.

预览

下面是当前产品截图，展示 CodexBridge 如何把 Codex 分发给团队用户，同时保留 operator 的用户、积分、runtime 和 workspace 管理能力。

飞书群聊入口 团队成员在飞书群里直接调用 CodexBridge。	团队配置与管理控制台 operator 管理 bot、runtime、渠道和团队访问。
本地 TUI 多轮对话 本地 operator 可以用 Codex 风格终端继续同一个 bot 线程。	CLI 入口与状态 从命令行查看当前 bot、runtime、渠道和 workspace。

为什么需要 CodexBridge

Codex 在本地终端里很强，但团队需要一种更安全的方式，让其他人也能使用这份能力，同时不把 shell、主机或未受控的账号访问权直接交出去。

CodexBridge 补上的是运营管理层：

• 给用户提供飞书和 Telegram 入口
• 按 bot 管理访问权限、私聊解锁、封禁和角色
• 支持每日免费额度、付费积分、使用流水和管理员审计日志
• 为文件、记忆、会话和日志提供持久化工作区
• 通过 Web 控制台管理 runtime 状态、用户、积分、安全和工作区文件
• 为 operator 提供 Codex 风格的本地 TUI 使用体验

核心价值不是再做一个聊天窗口，而是受控分发。用户获得简单的聊天入口，operator 保留对身份、额度、成本、工作区状态和风险的控制。

典型场景

• 飞书团队 AI 助手：让指定同事或群组直接请求调研、写作、总结、文件处理和任务规划。
• 受控 Codex 访问：让他人使用 Codex-backed 工作能力，但不暴露你的终端或主机。
• 共享工作区 bot：为不同项目、客户、团队或工作流创建独立 bot。
• Operator 治理：查看运行记录、管理积分、审查日志、停止 runtime，并控制外部访问。

快速开始

要求

• Node.js >=22
• 已安装 Codex CLI，并可通过 codex 命令访问
• 当前 codexbridge tui 需要 Rust/Cargo
• 只有接入外部聊天渠道时才需要 Telegram 或飞书凭据

安装

多数用户可以直接让 Codex 安装：

Install Moshiii/CodexBridge from GitHub and start CodexBridge.

手动安装：

npm install -g github:Moshiii/CodexBridge
codexbridge

不要使用 npm install -g codexbridge 或直接 npx codexbridge；npm registry 上的 codexbridge 名称目前指向另一个包。

首次运行

codexbridge 会打开当前 bot 的 operator 菜单：

CodexBridge Menu · Default (default)
Start chat with current bot
Start runtime
Switch bots
Connect Telegram or Feishu
User management

启动本地对话：

codexbridge tui

启动 Web 管理控制台：

codexbridge web

可以管理什么

CodexBridge 按 bot 将状态保存在 ~/.codexbridge/bots/<id>。

每个 bot 都有独立的：

• 工作区和记忆文件
• 飞书和 Telegram 渠道配置
• 用户、积分、封禁和私聊权限
• 会话、运行记录、日志和审计记录
• runtime 配置和安全状态

完整设置见 快速开始。命令和本地 API 见 API Reference。

状态与安全

CodexBridge 目前是 alpha 阶段的开发者工具。

你需要自备已授权的 Codex/OpenAI 访问能力。CodexBridge 不是模型提供商，不是 subscription 转售层，也不是共享账号凭据的方式。它是围绕你自己已批准 runtime 的 operator-controlled gateway。

请先在本地使用，并先对可信用户测试。外部聊天访问应视为敏感能力。应用层策略不是主机级隔离。在允许不可信外部用户通过你的机器运行 Codex 之前，请使用独立 OS 用户、容器、sandbox、microVM 或 remote worker 验证硬隔离。

文档

• Getting Started - 安装、首次运行、TUI、Web 控制台、Telegram、飞书
• API Reference - CLI 命令和本地 Web API
• Runtime Layout - ~/.codexbridge 下的文件结构
• Current Architecture - 模块边界和 runtime 模型
• Capability Overview - 当前能力面
• Demo Workflows - 示例任务
• Roadmap - 产品与工程方向
• Test Plan - 验证方案
• Telegram Bridge - Telegram 渠道细节
• Feishu Channel State - 飞书/Lark 当前状态

开发

npm install
npm test
npm start

支持与安全

• Bug 和功能请求：请提交 GitHub issue。
• 安全问题：不要公开发布 secrets 或私有日志，请使用私密渠道联系维护者。
• 运营安全：邀请不可信外部用户之前，请使用硬隔离。

License

MIT