CodexPro 是本機 MCP 伺服器。它把你的 ChatGPT 工作階段接到你明確允許的本機倉庫。ChatGPT 可讀取、搜尋、編輯、審查、驗證、匯入附件，並寫 handoff 計畫；範圍限制在這些 root 內。
CodexPro 是本機 MCP 伺服器。它連接你的 ChatGPT 工作階段、你的機器，以及你明確允許的倉庫。GitHub 倉庫描述為：Use ChatGPT Developer Mode as a local coding agent for your repo through MCP。
在 workspace write 模式（官方稱為常規 agent 設定）下，ChatGPT 可讀取、搜尋、檢查倉庫；用 write、edit 或受保護的 apply_patch 編輯；用 import_file 匯入 ChatGPT 附件；用 bash 跑白名單檢查；用 show_changes 審查 diff；在 .ai-bridge 寫計畫；並為不能呼叫工具的工作階段匯出 context bundle。
官方 README 列出它不是託管 SaaS、模型代理、配額繞過、帳號池或遠端 shell 服務。所有請求仍走你自己的 ChatGPT 工作階段與該帳號現有限制。
前置條件：Node.js 20+；能建立自訂 MCP 外掛的 ChatGPT 帳號；ChatGPT Web 需要指向本機的 HTTPS 位址（tunnel 或 Tailscale Funnel）。官方 FAQ 建議全域安裝一次，之後在目標倉庫跑 codexpro setup。
路徑：Settings → Security and login，開啟 Developer mode，並保持 Enforce CSP in developer mode 開啟。再到 Settings → Plugins 的 Plugins 分頁，點搜尋框旁的 +。
名稱填 CodexPro。Connection 選 Server URL，貼上 CodexPro 複製的 URL。Authentication 選 No Authentication / None；表單可能預設 OAuth，建立前改掉。CodexPro 的認證就是該 URL 內的 token，不要分享這個 URL。
沒有 codexpro update。重新安裝套件後重啟連線：
codexpro connection-test，確認 ChatGPT 請求是否到達本機伺服器。FAQ 仍接受 npx codexpro@latest start 作為不安裝的後備路徑。~/.codexpro 下的已存設定在更新後會保留。
CLI 負責安裝、啟動、診斷與本機執行器。MCP 工具面由 --tool-mode、--mode 與 bash / write 開關決定。官方網站列出預設 standard 工具包含 server_config、open_current_workspace、open_workspace、tree、search、read、view_image、write、edit、bash、show_changes、read_handoff、wait_for_handoff、export_pro_context、handoff_to_agent。
~/.codexpro/profiles/。--root、--headless、--no-bash 與各 tunnel 旗標。read、tree、search、load_skill；關閉寫入、bash 與 tool cards。終端機會標示請求是否到達 /mcp。show / set / list / delete --yes。用 --project 加入額外允許的倉庫；--clear-projects 清除。--json；CODEXPRO_ANALYSIS=0 可關閉此層。write / edit / apply_patch。ChatGPT 只寫 .ai-bridge 計畫檔。codexpro pro-bundle --copy。server_config，再以 include_tree=false 開啟啟動倉庫。open_current_workspace。expected_sha256 擋過期覆寫。敏感路徑預設封鎖。--no-bash 從工具清單移除。--bash full 僅適用受信任本機倉庫。git_status / git_diff 僅在 --tool-mode full 時使用。.ai-bridge/current-plan.md。內建 OpenCode、Pi、Codex 與受限自訂 --command。先用 --dry-run。--review-command 與 --max-iters。不暴露為遠端 MCP 工具。| 你在做什麼 | 指令 |
|---|---|
| 第一次把 ChatGPT Web 接到本機倉庫 | codexpro setup，再把複製的 Server URL 貼進 Plugins |
| 同一倉庫日常連線 | codexpro start |
| 只規劃、不改原始碼 | codexpro start --mode handoff |
| 模型或產品界面不能呼叫 MCP 工具 | codexpro start --mode pro 或 codexpro pro-bundle --copy |
| 不要讓 ChatGPT 觸發 shell | codexpro start --no-bash |
| 快速 demo（URL 每次重啟會變） | codexpro start --tunnel cloudflare |
| 穩定 Server URL | codexpro ngrok --hostname … 或 codexpro stable --hostname … |
| 一個 connector 切多個允許專案 | codexpro settings set --project … |
| 兩個 ChatGPT 帳號或硬隔離 | 兩個 CodexPro 行程，不同連接埠與不同 Server URL |
| Plugins 建立失敗 | codexpro connection-test |
以下條目來自官方 README、FAQ 與 SECURITY.md。公網 tunnel 預設要求 HTTP token（至少 24 bytes）；寫入工具只在 workspace write 模式宣告；bash 預設 safe。
Enforce CSP in developer mode 維持開啟。CodexPro widget 依 CSP 路徑建置，不需要遠端 script、外部字型、iframe 或第三方圖片。
來源 · FAQ.md · Should CSP stay enabled?CodexPro 認證就是 URL 內的 token。個人相容後備是 ?codexpro_token=。用戶端支援標頭時優先用 Authorization: Bearer <token>。
建立 ~/.codexpro/http-token：openssl rand -hex 32，權限 chmod 600。穩定 hostname 與穩定 token 搭配，才不必每次改 ChatGPT Server URL。
快速 demo 用 Cloudflare quick tunnel（重啟會換 URL）。穩定 URL 優先 ngrok free dev domain。自訂網域用 Cloudflare named tunnel。Tailnet 用 Tailscale Funnel。能連 localhost 的用戶端才用 --tunnel none。
沒有 POST /mcp received：請求沒到本機，查 Plugins 頁與 tunnel。401：貼上含 token 的完整 URL。2xx：ChatGPT 已到達 MCP endpoint。Cloudflare 530 / Error 1033 查 DNS。
同一個 connector 切專案：settings set --project，再請 ChatGPT 呼叫 open_workspace。兩個帳號、兩個 ngrok 網域或硬隔離：兩個行程、不同連接埠與不同 Server URL。
先讀檔，再把回傳的 SHA-256 傳給 write 或 edit。檔案在讀取後已變更時，操作會被拒絕。這不是協同 merge 伺服器；大範圍重疊修改仍用獨立 worktree。
safe 模式允許常見檢查、git、測試、lint、typecheck 與建置指令。SECURITY.md 註明它仍可跑倉庫 package scripts；不信任的倉庫用 --no-bash。
用 AGENTS.md 寫專案規則；.ai-bridge/decisions.md、current-plan.md、agent-status.md 保存決策、計畫與本機執行結果。不能呼叫工具時用 pro-bundle --copy。
FAQ 跟隨 GitHub main。文件寫了某個功能但 codexpro --version 還沒有，代表 main 比 npm latest 新。等下一版，或從帶 tag 的 GitHub release 安裝。
下列流程依官方 README 的安裝與連線步驟，以及 repo 內 CHATGPT_PROMPT.md 的建議呼叫順序。終端機指令是 verbatim CLI；ChatGPT 側示範方法，不宣稱特定倉庫目錄內容。
CHATGPT_PROMPT.md 要求先 server_config，再 open_current_workspace；未要求切 root 時不要呼叫 open_workspace。一般工作用 read、search、edit、bash、show_changes；git_status / git_diff 只在 --tool-mode full 時使用。
結束時摘要變更檔案、驗證指令，以及被擋住的項目。未明確要求規劃時，不要呼叫 handoff_to_agent 或 handoff_to_codex。
.env、金鑰、.git、建置快取與 symlink 逃逸，這些防護會降低風險，但不是 OS sandbox。
--no-auth 跑公網 tunnel。公網與非 loopback bind 在缺少 CODEXPRO_HTTP_TOKEN 時會 fail closed。token 短於 24 bytes 會被拒絕。
Authorization: Bearer。查詢字串 token 只是個人 connector 相容模式，不是多使用者正式驗證設計。
--bash full 僅適用受信任本機倉庫。在重要倉庫開 CODEXPRO_WRITE_MODE=workspace 前，先確認 root 範圍。
execute-handoff 與 loop-handoff 不是遠端 MCP 工具。不熟悉的 adapter 或自訂指令先 --dry-run。loop-handoff 保持小的 --max-iters，並優先 --require-human-confirmation。
--codex-sessions metadata 或 read，不會附加到進行中的 Codex 聊天。
預設路徑是全域安裝、在倉庫跑 setup、把 Server URL 貼進 ChatGPT Plugins。以下步驟在連線穩定後才需要。
1. 固定 ChatGPT Server URL。FAQ 建議大多數使用者用 ngrok free dev domain。有自己的網域時用 codexpro stable --hostname … --tunnel-name …。Tailnet 已開 Funnel 時用 codexpro tailscale --hostname …。細節見 DOMAIN_SETUP.md。
2. 一個 connector 允許多個專案。codexpro settings set --project ~/code/web --project ~/code/api，確認 settings show 列出額外 root，重啟 connector 後請 ChatGPT 呼叫 open_workspace。
3. 規劃與執行分開。codexpro start --mode handoff --no-bash 讓 ChatGPT 只寫 .ai-bridge/current-plan.md。本機再跑 codexpro execute-handoff --agent opencode --dry-run，確認後拿掉 --dry-run。
4. 有界本機迴圈。codexpro loop-handoff 需要本機 --review-command 與 --max-iters。先 --dry-run，並優先 --require-human-confirmation。它不自動化 ChatGPT Web，也不核准產品提示。
5. 背景啟動。交給 service manager 時用 codexpro start --headless。它不提問、不碰剪貼簿或瀏覽器；以 CODEXPRO_READY 回報就緒，HTTP runtime 意外退出時以非零狀態結束。
① SECURITY.md — 威脅模型、fail-closed 規則與硬性限制。
② FAQ.md — 帳號層級、tunnel 選擇、連線除錯與多專案。
③ DOMAIN_SETUP.md — ngrok、Cloudflare named tunnel 與穩定 hostname。