Theme / v0.5.0

CatDesk

把 ChatGPT Web 變成本地 Coding Agent

平台安裝

ChatGPT Web(Custom Connector)

CatDesk 的主要執行裝具:透過 ChatGPT Custom Connector 連接本地 MCP 伺服器。涵蓋訂閱需求、連接器設定、權限權衡、web.search 不相容問題與各訂閱層級的上下文視窗。

ChatGPT Web(Custom Connector)

ChatGPT Web 是 CatDesk 設計與測試的主要環境。CatDesk 在你電腦上跑一個本地 MCP 伺服器 (MCP Server),透過 ngrok 隧道 (tunnel) 暴露給 ChatGPT Web,再由 Custom Connector 連接。效果是:ChatGPT Web + CatDesk ≈ 精簡版 Codex ≈ 沒有 cron 與其他主動工具的 OpenClaw。

✅ 前置需求檢查清單

  • ChatGPT Plus 或 Pro 訂閱:Custom Connector 僅開放給 Plus 與 Pro 用戶
  • 本地已安裝 Node.js(用 npm install -g catdesk 安裝)
  • 已取得 ngrok authtoken 與 ngrok 靜態網域(從 ngrok 儀表板)
  • 已完成連接器設定(完整 9 步流程見快速上手工作流

🔌 連接器設定回顧

連接器只需設定一次(靜態網域與隨機路徑都持久化在 ~/.catdesk/config.toml,完整 MCP URL 每次啟動都相同):

  • Name:CatDesk 或任意名稱
  • MCP Server URL:TUI 顯示的完整 URL
  • Authentication:None

若更換 MCP 相關設定(工具模式、widget 開關),要開新對話並在 ChatGPT 設定裡重新整理 CatDesk。最可靠:移除並重裝連接器。

⚖️ 權限權衡 (Permission Trade-offs)

權限 行為 適用時機
Allow read actions(預設) 只允許讀取類工具 起步建議;程式碼審查、理解專案
Allow all actions 等同 Codex --yolo,允許寫入與執行指令 環境已容器化隔離、工作流穩定後

從保守端開始,確認一切正常再放寬。切換權限後記得開新對話。

⚠️ web.search 不相容

網頁工具與自訂連接器無法同時使用。 這是一個硬性限制:

  • /@ 手動選擇連接器時,會把能力限制在該連接器,但 web.searchweb.open 會被停用
  • 建議:讓 ChatGPT 自動決定連接器,就能同時保留網頁工具與 CatDesk

穩定性小技巧:若自動選擇不穩、ChatGPT 忘記呼叫 CatDesk,可以臨時手動選擇以強制使用——但犧牲就是失去網頁工具,做完記得切回自動。

📏 上下文視窗(依訂閱層級)

ChatGPT Web 的上下文視窗與 Codex CLI 不同(輸入 + 輸出 = 總和):

訂閱層級 CatDesk + ChatGPT Web Codex CLI
Plus 128K + 128K = 256K 258K(實驗性 1M)
Pro 272K + 128K = 400K 258K(實驗性 1M)

256K 對大型專案偏緊。這也是為什麼「每個小功能開新 Session」的紀律這麼重要——詳見快速上手工作流的 Session 紀律與交接筆記 (handoff note) 模式。

🩺 常見問題速查

  • Widget 空白:重新整理頁面並重新連接連接器;或停止回應後重送訊息
  • 紅色 CSP 按鈕:在 Advanced connector settings 開啟 Enforce CSP in developer mode 即可移除
  • 連接器一直要求重新 Connect:已知 bug,已修復;重裝連接器可解