codexpro

把 ChatGPT 变成你的本地编码代理，直接操作仓库代码

CodexPro 是一个开源项目，它通过 MCP（模型上下文协议）将 ChatGPT 的开发者模式接入本地代码仓库，让你能够将 ChatGPT 作为本地编码代理使用。它解决了 AI 编码助手难以直接操作本地文件系统、运行命令和访问完整项目上下文的问题。核心能力包括：通过 Cloudflare Tunnel 或 ngrok 建立安全隧道，将本地开发环境暴露给 ChatGPT；利用 MCP 协议让 ChatGPT 能够读取、修改文件，执行终端命令，并理解项目结构；支持与 Codex CLI 集成，提供类似 GitHub Copilot 的交互体验，但更侧重于将 ChatGPT 作为独立的代理来驱动编码任务。项目基于 JavaScript 构建，使用 apps-sdk 和 chatgpt 相关技术，适合开发者快速搭建个人 AI 编码工作流。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2033

维护状态活跃

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队rebel0789

所属国家

官网地址https://rebel0789.github.io/codexpro

GitHubhttps://github.com/rebel0789/codexpro

定价模式free

价格说明开源项目，MIT许可证，本地部署使用，完全免费。

访问状态

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型apps-sdk,chatgpt,cloudflare-tunnel,codex,local-development,mcp,ngrok

GitHub 星标★ 2033

30天Star增速

HF 下载量

上线时间2026-06-16 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：进阶约 15 分钟部署方式：命令行工具 7 步

环境要求

Node.js 20 或更高版本
一个可以创建自定义 MCP 插件的 ChatGPT 账号
一个指向本机的 HTTPS 地址（隧道或 Tailscale Funnel）
本地已克隆或存在的代码仓库目录

安装与启动步骤

1确认 Node 版本

CodexPro 要求 Node.js 20+，先检查本机版本；低于 20 需要先升级再继续。
```
node -v
```
2全局安装 CodexPro

通过 npm 全局安装 codexpro 命令行工具，安装完成后系统会出现 codexpro 命令。
```
npm install -g codexpro
```
3进入目标仓库

切换到你要让 ChatGPT 操作的代码仓库目录，后续授权范围以该目录为根。
```
cd /path/to/your/repo
```
4运行初始化配置

在仓库目录下执行 setup 完成初始化，README 未展示后续交互细节，按提示操作即可。
```
codexpro setup
```
5准备 HTTPS 地址

ChatGPT 网页版需要通过 HTTPS 访问你的机器，README 建议使用隧道或 Tailscale Funnel 暴露。
6开启开发者模式

在 ChatGPT 中进入 Settings -> Security and login，打开 Developer mode 开关。
7添加自定义 MCP 插件

在 ChatGPT 中创建自定义 MCP 插件，填入指向本机的 HTTPS 地址完成连接。

如何确认成功

在 ChatGPT 中确认自定义 MCP 插件已连接，并能读取你允许的仓库目录中的文件内容。

常见问题

Q：必须安装 Node.js 吗？版本有要求吗？

A：需要。README 明确要求 Node.js 20 及以上版本，可用 node -v 检查，版本过低请先升级。

Q：需要 Docker 或服务器吗？

A：不需要。CodexPro 是运行在本机的本地 MCP 服务器，不是托管 SaaS，按 npm 全局安装后本地运行即可。

Q：为什么需要 HTTPS 地址？

A：ChatGPT 网页版无法直接访问 localhost，README 要求提供指向本机的 HTTPS 地址，可通过隧道或 Tailscale Funnel 实现。

Q：ChatGPT 会不会访问我整个磁盘？

A：不会。README 说明它被限制在你明确允许的仓库根目录内，读取、搜索、编辑都只在那些 roots 中进行。

注意事项

README 节选未给出隧道（Cloudflare Tunnel / ngrok）的具体启动命令，请以官方文档或 codexpro setup 的提示为准。
CodexPro 不是模型代理、额度绕过或远程 shell 服务，请勿用于此类用途。
ChatGPT 只能在被授权的仓库根目录内操作，不要随意把敏感目录加入允许列表。
涉及隧道的凭证和 token 请妥善保管，不要提交到公开仓库。

核心亮点

通过 MCP 协议让 ChatGPT 直接读写本地文件，无需手动复制粘贴代码
利用 Cloudflare Tunnel/ngrok 实现安全远程连接，无需公网 IP
支持与 Codex CLI 集成，可自动化执行编码任务，提升效率

不足之处

依赖外部隧道服务，网络不稳定时可能影响连接
文档/社区待观察

适用场景

个人开发者快速实现 AI 辅助编码，无需切换工具
团队内部使用 ChatGPT 作为共享编码代理，统一代码风格
自动化代码审查和重构，通过 ChatGPT 代理执行批量修改

替代项目

OpenAI Codex CLI、Continue.dev、Aider

项目介绍

codexpro 是智能体领域的开源项目，由 rebel0789 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（2,033）位列前 30%，在智能体分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,568 增加到 2,033，净增 465。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。MIT许可证，本地部署使用，完全免费。

它主要面向的使用场景是：个人开发者快速实现AI辅助编码，无需切换工具。同类可对比的替代方案包括 OpenAI Codex CLI、Continue.dev、Aider。

上一篇：triliumnext-mcp

下一篇：google_workspace_mcp