CodexFlowFLOW 7 / TECH
EN GitHub

本地代理基础设施 / Flow7 Tech

一个命令。所有项目。任意对话。

CodexFlow 为 ChatGPT 提供可靠的本地编码后端。项目、实时任务与 subagent 进度、worktrees、Git、持久终端、原生审查、定时任务、Computer Use 与可标注的临时浏览器，都通过一条清晰可控的连接进入对话。

npm install -g https://github.com/tarunspandit/codexflow/releases/download/v0.50.2/tarunspandit-codexflow-0.50.2.tgz
查看完整流程
  • 01没有设置向导
  • 02不执行 Codex CLI
  • 03MIT 开源

Broker 已就绪

连接
Token 保护
项目
自动发现
会话
独立路由

工作原理

模型留在 Web。
工作留在你的电脑。

CodexFlow 是两者之间精确的一层：理解项目、可检查，并始终被限制在每个对话自己选择的文件夹里。

01 / 模型层

ChatGPT 负责思考和对话。

你现有的 ChatGPT 账号提供模型、推理和对话。当 ChatGPT Work 创建 subagents 时，CodexFlow 只为每个 child 提供私有项目 route；它不会启动或代理模型。

02 / 执行层

你的电脑保存真实状态。

仓库指令、当前文件、git 状态、项目 skills 和受控命令都保留在本地，只有当前对话请求时才会使用。

03 / 连接层

一个 broker 把关系保持清楚。

一条经过身份验证的 MCP endpoint 可以服务多个聊天，同时为每个会话保留独立的项目绑定。

从零到可用

三个动作。
没有仪式。

安装一次。裸命令完成项目发现、broker、身份验证和 tunnel。每个新聊天只需要选择它应该在哪个项目工作。

  1. 01

    启动

    运行 codexflow。

    自动发现最近项目，启动本地 MCP broker，创建私有 token，并准备安全 URL。

    $ codexflow就绪
  2. 02

    连接

    把 URL 添加到 ChatGPT 一次。

    创建 Developer Mode app，粘贴生成的 Server URL，并选择无需额外身份验证—token 已经在 URL 中。

    设置→Apps→创建
  3. 03

    选择

    把聊天绑定到一个项目。

    可以在对话内选择，也可以回复准确的项目名称。两种方式都会把文件、git、编辑与命令绑定到该项目。

    ~/DEV/atlas-web

独立路由

一条连接。
各自的工作记忆。

每个 ChatGPT 对话都拥有自己选择的项目。切换预览，看看同一个 broker 如何路由不同任务，同时不跨越工作区边界。

01broker
∞对话
N项目
会话路由本地 / 就绪
CHATGPT 会话优化新手流程conversation_01
CFtoken 保护
已选项目atlas-web~/DEV/atlas-web
›工作区已绑定 · skills 已加载 · 就绪✓

原生桌面应用

你的电脑。
一个清晰界面。

CodexFlow 会在 Mac 或 Windows PC 上打开原生应用。统一监督 web 任务、已配对电脑、嵌套 Active / Done agents、计划、阻塞、环境、worktrees、diff、Computer Use 与网站 origin 审批。

CodexFlow / 当前正在此电脑上运行
当前运行

一切运行，一目了然。

项目
自动发现
环境
项目共享
聊天路由
各自独立
终端
随路由持久
01 / 实时进度进行中的任务
  1. 优化新手流程atlas-web
    2 agents · 运行中chat-a40c97f2
  2. 重构身份验证signal-api
    reviewer · 完成chat-7eac13b8
  3. 发布审查codexflow
    git status · 运行中chat-29d1f640

这是原生应用的示意预览。真正的桌面应用只读取你本机经过身份验证的 CodexFlow broker；此公共网站无法看到你的项目或聊天。浏览器页面只保留为精简恢复入口。

工具能力

足够完成工作。
也足够清楚，值得信任。

CodexFlow 提供专注的编码能力，而不是一个没有边界的 shell。模型获得需要的上下文与操作，每一步都限定在已选工作区内。

01

发现

项目已经在那里。

读取最近的本地项目 metadata 和配置的 roots，在每个新对话中提供清晰的选择器。

自动
02

理解

行动之前先读懂仓库。

加载 AGENTS.md，映射文件和符号，定位测试，读取 git 状态，并在改动前识别潜在影响。

项目原生
03

修改

在一个 root 中精确编辑。

搜索、读取、写入、编辑并应用受保护补丁，不暴露其他项目，也不在机器中越界。

工作区范围
04

并行

一个任务，一个受管 checkout。

在本机或已配对 CodexFlow 电脑上创建隔离 worktrees，安全带入当前改动；如果目标 checkout 被独立修改，则拒绝覆盖。

受保护交接
05

协调

每个真实 child 都有自己的 route。

当 ChatGPT Work 创建 subagents 时，parent 分配独立项目 route，children 只能报告自己的受限状态；原生 Tasks 显示 Active 与 Done，但不会启动第二个模型后端。

CHATGPT WORK / ROUTE 隔离
06

验证

Git 与终端状态持续存在。

只暂存并提交所选项目，运行受限验证，并让私有路由终端跨工具连接保持运行。

持久
07

审查

Diff 应该留在你的电脑。

分开 staged 与 unstaged 文件，逐 hunk stage 或 revert，并把逐行 review note 带入 web chat 的下一次改动审查。

原生
08

适配

项目环境也会随行。

使用与 Codex 相同的项目环境格式提供 setup、cleanup、actions、skills、plugins 和 MCP 清单，但不运行 Codex。

可互操作
09

定时

重复任务始终回到正确项目。

为 ChatGPT Scheduled 准备稳定运行：重新获得私有 route，并使用干净的受管 worktree，不增加第二个模型后端。

CHATGPT 原生
10

配对

一个代码连接另一台机器。

安装 CodexFlow 并输入短代码，另一台电脑的项目会自动出现在同一个 picker 中；文件、终端、环境、分析、worktrees、Git 传输与同步都通过端到端加密通道运行，不需要第二个 ChatGPT connector。

CLOUDFLARE RELAY / 端到端加密
11

操作

视觉操作仍然先征求同意。

从聊天请求一个绑定身份的原生应用，在当前电脑上批准，查看仅限目标应用的最新窗口快照，并在本机确认每个敏感的元素级操作。

COMPUTER USE / 已授权
12

浏览

和 Web chat 一起审查与调试真实页面。

批准一个网站 origin 后，可检查语义 DOM、受限 console/resource/source diagnostics，并选择准确元素留下仅该 route 可见的评论。跨 origin 跳转、下载、凭据、payload body 与敏感操作会被拒绝或要求本机确认。

WEBKIT + WEBVIEW2 / ROUTE 隔离

能力必须有边界

本地访问应该被认真对待。

这条连接之所以有用，正因为它的限制是明确的。公网路由需要生成的 token，每个文件操作都经过 root 检查，secrets 会被隐藏，危险能力始终需要主动开启。

阅读安全模型
  1. 01
    Token 保护的公网 URL

    未经身份验证的请求无法进入工具面。

  2. 02
    工作区 root 强制执行

    路径与 symlink 检查让所有操作始终在范围内。

  3. 03
    Secret 感知输出

    凭据和常见 secret 模式会被拦截或隐藏。

  4. 04
    受保护写入与终端

    安全默认值一直生效，直到你明确扩大权限。

  5. 05
    冲突感知 Worktrees

    交接前会验证两个 checkout，避免覆盖独立改动。

  6. 06
    受限 SSH 项目路由

    只接受具体 alias 与既有 host-key trust；每次调用都会重新检查目标、项目 root、blocked paths、symlink 与策略。

  7. 07
    临时浏览器隔离

    每个 tab 使用非持久 WebKit 或 WebView2 profile；重要操作绑定最新快照，准确元素评论与移除 query 的 console/resource/source diagnostics 保持受限且仅对所属 route 可见。

直接回答

连接之前。

CodexFlow 会运行 Codex CLI 吗？

不会。ChatGPT 提供模型与对话，CodexFlow 通过 MCP 提供本地项目上下文和工具后端。它不会启动、恢复或伪装成 Codex session。

需要手动注册每个项目吗？

不需要。运行 codexflow 会自动发现最近项目文件夹和配置 roots。每个对话为自己选择一个项目。

多个聊天可以同时工作吗？

可以。一个 broker 和 tunnel 能服务多个对话。每个聊天都有独立私有路由，跨工具连接和 broker 重启后仍保持项目绑定。

一个任务可以使用 subagents 吗？

可以，但需要 ChatGPT Work 提供。ChatGPT 负责 child threads 与模型用量；CodexFlow 为每个真实 child 分配隔离项目 route、收集受限状态与结果，并在原生应用显示 Active / Done。

定时任务能使用本地项目吗？

可以。ChatGPT Scheduled 负责模型运行与 cadence；CodexFlow 让每次运行重新获得项目、环境和可选的干净 worktree。电脑与 broker 需要保持运行。

为什么使用 Pro 时看不到 CodexFlow？

ChatGPT 的 Pro 模型变体不会开放 Apps。请使用 Extra High 或其他非 Pro 模型；Pro 订阅本身仍然支持。

这是额度或模型代理吗？

不是。请求仍使用你自己的 ChatGPT 账号和正常产品限制。CodexFlow 不合并账号、不转售访问，也不绕过额度。

安装需要什么？

Node.js 20 或更高版本，以及 ChatGPT Apps / Developer Mode 访问。普通启动流程包含 Cloudflare quick tunnel，也支持固定 tunnel 模式。

项目已经在你的电脑里

现在，在对话中与它们相遇。

安装一次，从任何目录运行，在聊天开始时选择工作区。

npm install -g https://github.com/tarunspandit/codexflow/releases/download/v0.50.2/tarunspandit-codexflow-0.50.2.tgz

然后运行 codexflow