codexpro

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

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 对话助手 🍴 复刻 230 🐛 待处理 23 👀 关注 2
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 2110
维护状态 维护中
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,本地部署使用,完全免费。

项目预览

codexpro 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类对话助手
开发团队rebel0789
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,本地部署使用,完全免费。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言JavaScript
技术栈/模型apps-sdk,chatgpt,cloudflare-tunnel,codex,local-development,mcp,ngrok
GitHub 星标★ 2110
上线时间2026-06-16 00:00:00
代码更新2026-10-01
仓库体积2.5 MB
本站数据更新2026-11-09
维护状态维护中
收录时间2026-08-09
浏览次数3

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2110

技术标签

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

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

环境要求

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

安装与启动步骤

  1. 1确认 Node 版本

    CodexPro 要求 Node.js 20+,先检查本机版本;低于 20 需要先升级再继续。

    node -v
  2. 2全局安装 CodexPro

    通过 npm 全局安装 codexpro 命令行工具,安装完成后系统会出现 codexpro 命令。

    npm install -g codexpro
  3. 3进入目标仓库

    切换到你要让 ChatGPT 操作的代码仓库目录,后续授权范围以该目录为根。

    cd /path/to/your/repo
  4. 4运行初始化配置

    在仓库目录下执行 setup 完成初始化,README 未展示后续交互细节,按提示操作即可。

    codexpro setup
  5. 5准备 HTTPS 地址

    ChatGPT 网页版需要通过 HTTPS 访问你的机器,README 建议使用隧道或 Tailscale Funnel 暴露。

  6. 6开启开发者模式

    在 ChatGPT 中进入 Settings -> Security and login,打开 Developer mode 开关。

  7. 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

上一篇:triliumnext-mcp

下一篇:google_workspace_mcp

同类项目推荐

heurist-agent-framework 开源

用 Python 快速搭出会推理、能调工具、可上链的智能体服务

A flexible multi-interface AI agent framework for building agents with reasoning, to···

★ 828 2026-09-13
AlexClaw 开源

在你的硬件上跑私有 AI 代理,数据不出门。

BEAM-native personal AI agent built on Elixir/OTP. Runs on your hardware. Your data ···

★ 119 2026-08-09
Dais 开源

把AI员工装进桌面,多智能体协作搞定本地任务

Your Desktop AI Staffs.

★ 86 2026-08-09
learn-hermes-agent 开源

27章手把手带你从零写出会自我进化的AI智能体

A 27-chapter hands-on tutorial for building an autonomous AI agent from zero in Pyth···

★ 238 2026-08-09
commonplace 开源

让AI代理把知识库当活文档,边读边执行

The theory of LLM wikis, running as one. A framework for agent-operated knowledge: t···

★ 92 2026-08-09
bolna 开源

几行配置,快速搭建能打电话的 AI 语音助手

Conversational voice AI agents

★ 820 2026-08-09
hermes-agent 开源

越用越懂你的智能助手,记住你的习惯,陪你一起成长

The agent that grows with you

★ 261927 2026-08-09
chatcli 开源

在终端里直接和 AI 对话,干活更顺手

ChatCLI is a command-line application that utilizes LLMs—such as those from Anthrop···

★ 94 2026-08-09