GPT-CodeX 安裝到第一個專案
能以更經濟實惠的方式，獲得與 Claude Code 功能類似的強大 AI Agent，並完成安裝、安全設定與第一個專案的初始化。
§1 概覽
概覽
這個 Playbook 旨在提供使用者一個成本效益更高的 AI Agent 解決方案，即 GPT-CodeX，並指導其從下載安裝、關鍵安全設定到第一個專案初始化的全過程。使用者將學會如何妥善配置權限與沙盒，確保 AI 在安全可控的環境下運作，並掌握「專案」模式和「收工」指令等核心操作，以最佳化 AI 的使用體驗和成本。完成本 Playbook 後，使用者將具備啟動 AI 輔助開發專案的基本能力。
整體架構
使用者首先需下載並安裝 GPT-CodeX 桌面版應用程式，並用 OpenAI 帳號登入。接著，會進行基礎設定（如工作模式、多行提示詞），以及至關重要的安全設定，包括關閉「完整存取權」和將核准政策設為「on request」，確保 AI 的操作始終在使用者監控之下。隨後，使用者將建立並初始化第一個專案資料夾，讓 Codex 建立必要的管理檔案。最後，使用者會執行一個簡單指令來驗證專案功能，並學習使用「收工」指令來保存專案進度，以節省 Token 消耗。
---en---
Overview
This Playbook aims to provide users with a more cost-effective AI Agent solution, GPT-CodeX, and guides them through the entire process from downloading and installation, critical security settings, to the initialization of their first project. Users will learn how to properly configure permissions and sandboxing to ensure the AI operates in a safe and controllable environment, and master core operations such as “project” mode and “finish work” commands to optimize AI usage and costs. Upon completing this Playbook, users will have the fundamental ability to initiate AI-assisted development projects.
Overall Architecture
The user first needs to download and install the GPT-CodeX desktop application and log in with their OpenAI account. Next, basic settings (e.g., working mode, multiline prompts) will be configured, along with crucial security settings, including disabling “Full access” and setting the approval policy to “on request,” ensuring that the AI’s operations are always under user supervision. Subsequently, the user will create and initialize their first project folder, allowing Codex to create necessary management files. Finally, the user will execute a simple command to verify the project’s functionality and learn to use the “finish work” command to save project progress, thereby conserving token usage.
§2 前置準備
§3 Step-by-step
下載與安裝 GPT-CodeX
Do 下載並安裝 GPT-CodeX 桌面應用程式。
Why 這是使用本地 AI Agent 的基礎。
在 Google 搜尋「CodeX desktop」，找到官方下載頁面。下載對應你作業系統（Mac / Windows）的安裝檔。執行安裝檔。過程中如果系統提示安全性警告（未經驗證的開發者），請選擇信任並繼續安裝。
Verify 你的電腦應用程式列表中出現了「GPT-CodeX」圖示。
登入與基礎設定
Do 登入你的 OpenAI 帳號，並進行基礎的功能設定。
Why 正確的設定能讓 AI Agent 更好用，也更符合你的工作習慣。
打開 GPT-CodeX，使用你的 OpenAI 帳號登入（建議使用已訂閱 ChatGPT Plus 的帳號以獲得更佳體驗）。進入設定頁面，調整以下項目：工作模式 (Working Mode)：設為「日常工作 (Daily work)」。多行提示詞 (Multiline prompts)：開啟。後續跟進行為 (Follow-up behavior)：設為「排入序列 (Queue up)」。
Verify 設定儲存後，提示詞輸入框應支援多行輸入。
關鍵安全設定：權限與沙盒
Do 設定 Agent 的權限與沙盒，確保它在安全可控的範圍內運作。
Why **極其重要！** 避免 AI Agent 擁有過高權限，在未經你同意的情況下執行危險指令（如刪除系統檔案、訪問敏感資料）。
在設定中，找到「預設權限 (Default permissions)」區塊。**關閉「完整存取權 (Full access)」**。找到「組態政策 (Approval policy)」區塊。將核准政策設為「**on request**」（需要時才詢問）。找到「沙盒設定 (Sandbox settings)」區塊。選擇「**Workspace write**」（允許寫入專案資料夾），並**允許「網路寫入 (Network write)」**。
Verify 完成設定。現在 Agent 執行任何可能修改檔案的指令前，都會先彈窗請求你的批准。
建立與初始化第一個專案
Do 建立一個專案資料夾，並讓 Codex 在其中建立必要的管理檔案。
Why 專案功能是 AI Agent 的核心，讓它能理解並長期追蹤一個特定任務的上下文。
在你的電腦上建立一個新資料夾（例如 `My-Codex-Project`），建議存放在雲端硬碟（如 Google Drive）中以便同步。在 GPT-CodeX 介面中，選擇「專案 (Project)」功能。點選「使用現有資料夾 (Use existing folder)」，並選擇剛才建立的資料夾。Codex 會詢問是否初始化專案，點擊「是 (Yes)」。它會自動建立 `agents.md` 等檔案。它可能還會問是否初始化為 Git 專案，初學者可先選「否 (No)」。將專案的對話權限設定為「**自動審核 (Auto-approve)**」。
Verify 你的專案資料夾中出現了 `agents.md` 檔案，並且 Codex 的標題列顯示當前正在此專案中。
執行第一個指令並「收工」
Do 在專案中執行一個簡單指令，並學習使用「收工」指令來保存進度。
Why 「收工」是管理專案上下文、節省 Token 的好習慣。
在專案對話中，輸入：「請幫我建立一個 `README.md` 檔案，內容是『這是我的第一個 Codex 專案』」。Codex 會請求寫入檔案的權限，點擊「批准」。任務完成後，輸入指令：「**收工**」。Codex 會將這次的對話摘要記錄到 `agents.md` 中。
Verify `README.md` 成功建立，且 `agents.md` 中有內容更新。
§4 動手練習
動手練習
§5 自我檢核
§6 常見卡關
Codex 消耗的 Token 或費用好像很快？
這是因為 Agent 為了理解上下文會傳送大量資訊。務必養成使用「專案」模式和「收工」指令的習慣，避免在無專案的通用聊天中處理複雜任務。一次性給予完整指令，也比來回對話更節省 Token。
Codex 執行指令時，一直跳出權限請求視窗，很煩。
這是「on request」策略的正常現象，是為了安全。當你完全信任某個專案後，可以考慮在該專案的設定中調整為「自動審核」，但對於新專案或涉及敏感操作的專案，建議保持「on request」。
§7 延伸資源
§8 Badge unlock
💻 CodeX 初探者
完成所有步驟後解鎖。
恭喜！你已成功啟動 GPT-CodeX，準備好編寫你的第一個 AI 專案！