你是否曾想让 ChatGPT 直接“读懂”你电脑里那个还没推到 GitHub 的新项目?又或者,你厌倦了反复复制粘贴文件内容、手动描述目录结构来向 AI 提问?CodexPro 正是为此而生——它不是另一个大模型聊天界面,而是一套轻量级本地代理系统,能让官方 ChatGPT 网页版(开启 Developer Mode 后)实时感知你本地文件夹的完整上下文,像一位坐在你工位旁的资深同事一样,精准理解、修改、解释甚至重构你的代码。
核心功能
- 本地代码即上下文:自动扫描指定项目目录(支持 .gitignore 过滤),将文件结构、关键代码片段和注释构建成 Codex 风格的语义索引,不上传任何源码到云端
- 无缝对接 ChatGPT Web:通过 MCP(Model Context Protocol)协议桥接,让启用 Developer Mode 的 ChatGPT 原生识别并调用你的本地代码知识库,提问如“帮我修复 src/utils/date.ts 中的时区 bug”即可生效
- 免配置隧道服务:内置 Cloudflare Tunnel 或 ngrok 自动代理能力,无需公网 IP 或复杂端口映射,一键启动即可让 ChatGPT 安全访问本地服务
- 开发者模式增强支持:专为 ChatGPT 的 Developer Mode 设计,支持长上下文理解、多轮深度调试、生成可执行补丁(diff 格式)、跨文件逻辑推理等高级编码行为
- 极简本地部署:纯 TypeScript 编写,单命令全局安装(
npm install -g codexpro),启动后仅占用约 80MB 内存,Windows/macOS/Linux 全平台原生支持 - 隐私优先架构:所有文件解析、索引构建、上下文压缩均在本地完成;ChatGPT 仅接收脱敏后的结构化元数据与摘要,原始代码永不离开你的设备
适合哪些人用
如果你是以下角色之一,CodexPro 将显著提升你的开发效率与体验:
- 独立开发者 / 创业者:快速迭代私有项目,无需担心代码泄露,又能享受顶尖 AI 的编码辅助;
- 企业内网开发者:在无法访问公网大模型 API 的隔离环境中,依然能用上 ChatGPT 的 Developer Mode 能力;
- 教学与学习者:边写边问,让 AI 实时理解你刚写的 5 个函数之间的调用关系,告别“AI 不知道我在写什么”的挫败感;
- 开源贡献者:克隆任意 GitHub 仓库到本地,30 秒内让 ChatGPT “吃透”整个项目,大幅提升 PR 阅读与协作效率。
快速上手
只需三步,立刻启用:
- 安装:打开终端,运行
npm install -g codexpro(需 Node.js 18+); - 启动:进入你的目标项目根目录,执行
codexpro --port 3001(默认监听 3001 端口); - 连接:确保 ChatGPT 网页版已开启 Developer Mode(可通过插件或实验性开关激活),然后在对话中输入
/codex connect http://localhost:3001—— 成功后,你就能直接提问关于当前项目的任何问题了。
进阶用户还可参考官方 Stable URL 指南,用自定义域名替代 localhost,实现更稳定的长期使用体验。
项目信息
rebel0789/codexpro
GitHub
Use ChatGPT Developer Mode as a local coding agent for your repo through MCP.
432
Stars
40
Forks
TypeScript
MIT
TypeScript | 432 ⭐(GitHub Star 数)| MIT 开源协议 | GitHub 项目地址
如果你想要一个真正懂你本地代码、尊重你数据主权、且无需折腾服务器的 AI 编程搭档——CodexPro 不是未来概念,它今天就能跑在你的笔记本上。


