项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2110
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 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
上一篇:triliumnext-mcp
同类项目推荐
heurist-agent-framework
开源
用 Python 快速搭出会推理、能调工具、可上链的智能体服务
A flexible multi-interface AI agent framework for building agents with reasoning, to···
AlexClaw
开源
在你的硬件上跑私有 AI 代理,数据不出门。
BEAM-native personal AI agent built on Elixir/OTP. Runs on your hardware. Your data ···
Dais
开源
把AI员工装进桌面,多智能体协作搞定本地任务
Your Desktop AI Staffs.
learn-hermes-agent
开源
27章手把手带你从零写出会自我进化的AI智能体
A 27-chapter hands-on tutorial for building an autonomous AI agent from zero in Pyth···
commonplace
开源
让AI代理把知识库当活文档,边读边执行
The theory of LLM wikis, running as one. A framework for agent-operated knowledge: t···
bolna
开源
几行配置,快速搭建能打电话的 AI 语音助手
Conversational voice AI agents
sample-autonomous-cloud-coding-a···
开源
在 AWS 上把编码任务变成自动 PR,后台代理帮你干活。
Autonomous background coding agents on AWS. Turn tasks into pull requests via isolat···
hermes-agent
开源
越用越懂你的智能助手,记住你的习惯,陪你一起成长
The agent that grows with you
chatcli
开源
在终端里直接和 AI 对话,干活更顺手
ChatCLI is a command-line application that utilizes LLMs—such as those from Anthrop···
