從零到開工：CatDesk 快速上手流程

CatDesk 讓你把 ChatGPT Chat 當成本地編碼代理 (Local Coding Agent) 使用，不需要逆向工程、不需要 API、也不需要 Codex。只要 ChatGPT Plus 訂閱就夠了。本工作流涵蓋從安裝到送出第一個編碼任務的完整旅程，共 9 個步驟。

⚠️ 安全提醒：CatDesk 功能強大，可能刪除整個磁碟或產生非預期結果。強烈建議在 VM 或容器 (DevContainer 是好選擇) 內執行。詳見 VM / 容器隔離執行環境。

步驟 1：全域安裝 CatDesk

用 npm 全域安裝：

npm install -g catdesk

步驟 2：啟動 catdesk

在任意終端機目錄執行：

catdesk

預設監聽 port 3200（可用 PORT 覆寫）；Workspace 根目錄預設為啟動時的工作目錄（可用 WORKSPACE_ROOT 覆寫）。

步驟 3：選擇控制模式 (Computer / Browser / Both)

啟動時選擇 Control Computer、Control Browser 或 Both：

只想編輯檔案與執行指令 → Computer
要做網頁開發、爬蟲，讓 ChatGPT 讀取元素並控制瀏覽器分頁 → 需要瀏覽器模式
兩者都要 → Both

在模式選擇畫面按 l 可切換英文與繁體中文，偏好會存到 ~/.catdesk/config.toml。若啟用瀏覽器控制，需再選擇一個支援的 Chromium 瀏覽器。

步驟 4：輸入 ngrok authtoken 與靜態網域

首次啟動時，CatDesk 會要求你的 ngrok authtoken 與 ngrok 靜態網域 (ngrok static domain)，例如 my-app.ngrok-free.dev。兩者都從 ngrok 儀表板取得，之後會存入 ~/.catdesk/config.toml 並重複使用。

步驟 5：從 TUI 複製 MCP Server URL

等待 TUI 顯示完整的 MCP Server URL，格式類似：

https://xxxx.ngrok-free.dev/Ab3kL9xQ2pTm7VhC/mcp

🔒 切勿分享此 URL。任何拿到 URL 的人都能存取你的電腦。靜態網域與隨機路徑都會持久化，所以每次啟動 URL 都一樣，連接器只需設定一次。

步驟 6：建立 ChatGPT Custom Connector

開啟 ChatGPT 連接器設定 (chatgpt.com/plugins#settings/Connectors?create-connector=true)，填寫表單：

Name：CatDesk（或任意名稱）
MCP Server URL：貼上步驟 5 複製的完整 URL
Authentication：None

依序點擊「I understand and want to continue」→「Create」→「Connect」。

步驟 7：設定權限（先從 Allow read actions 開始）

連接器權限預設為 Allow read actions（僅允許讀取動作）。建議先從這個保守設定開始熟悉工具；等確定環境已隔離、工作流穩定後，再考慮切換到 Allow all actions（等同 Codex 的 --yolo，請謹慎使用）。

步驟 8：貼上 Custom instructions 片段

在 ChatGPT 的 Custom instructions 加入這段文字，讓 ChatGPT 知道何時該用 CatDesk：

CatDesk is a coding tool and a custom connector. Always use CatDesk if the user wants to do anything related to file operations. Always call `catdesk_instruction` after `list_resources`, and follow the instructions it contains.

步驟 9：送出第一個編碼任務

從 ChatGPT Web 開始使用連接器。讓 ChatGPT 自動決定連接器（理由見下方提醒）。第一個任務可以很簡單，例如要求它讀取專案內某個檔案並解釋結構，驗證 read 工具正常運作。

Session 紀律：每個小功能開新 Session

這是最重要的使用習慣。ChatGPT Web 對話在累積 50+ 次工具呼叫後會變得極度緩慢（實測記憶體占用 3.9 GB）。對策：

每個小功能開一個新 Session，不要在同一個對話裡連續做好幾個功能。
若新 Session 需要上下文，在結束舊 Session 前，請 ChatGPT 寫一份交接筆記 (handoff note)：已完成什麼、改了哪些檔案、下一步是什麼。把這份筆記貼進新 Session 即可無縫接續。

範例提示詞：

Before we finish, please write a handoff note summarizing: what was completed, which files were modified, and what the next steps are. I will paste it into a new session.

若你更換了 MCP 相關設定（工具模式 tool mode、widget 開關），記得開新對話，並在 ChatGPT 設定裡重新整理 CatDesk。最可靠的做法是移除並重裝連接器（重跑步驟 6-7）。