它可在 Windows、macOS 和 Linux 上運行,並使用官方 Godot 引擎。
截至 2026 年 9 月 29 日,在 Windows 上:若要使用 Codex,請安裝其命令列工具 (CLI),並使用 ChatGPT 登入。接著在 Flockbay 中開啟「連接器」(Connectors),連接您的代理 (MCP),進行設定,開啟,選擇 Codex,複製指令,然後將其貼到 PowerShell 中;在 Codex 中輸入 /mcp 即可列出 flockbay-stage。
若不使用 Codex,則在「連接器」中選擇 ChatGPT,使用任何方案(包括免費方案)登入 ChatGPT 即可。
Codex 的設計非常謹慎,它會先規劃,在沙盒環境中工作,並在執行任何不確定的操作前徵求您的同意。如果您要求它製作一個旋轉並在玩家觸碰時消失的硬幣,您會得到一個清晰的腳本和簡潔的解釋。然而,您不會看到 Codex 觀察玩家走進硬幣的畫面,因為它從未執行過遊戲,也沒有任何工具可以做到這一點。
Flockbay 正是缺失的另一半,它是一個基於 Godot 構建的免費 AI 遊戲製作工具。這是一個內建官方 Godot 4.7.2 的桌面應用程式(非分支版本),您的遊戲是一個真實的 Godot 4 專案,您可以開啟、閱讀和修改,並且世界工具都位於 Godot 編輯器內部。透過 MCP,它將正在運行的遊戲交給 Codex:Codex 會進行試玩測試,讀取錯誤,捕捉視埠畫面,並在回報前修復問題。
在 Flockbay 中,有兩種方式可以讓 OpenAI 的模型參與遊戲製作,它們是不同的產品。您可以自行執行 Codex 並連接它,或者您可以在 Flockbay 內部登入 ChatGPT,讓應用程式本身的 AI 根據您的訂閱來構建。本頁面涵蓋了這兩種方式,並提供了針對 Codex 的特定疑難排解。對於 Claude,相同的步驟適用於 Claude Code 製作遊戲。
使用 Codex 和 Flockbay,您需要 64 位元 Windows 11 (Intel 或 AMD 處理器)、配備 Apple Silicon 的 Mac,或作為 x86_64 AppImage 運行的 Linux 系統,Flockbay 就在這些平台上運行。在開發期間需要網路連線,以及一個 Flockbay 帳戶,該帳戶是免費的,並且在您首次開啟應用程式時會自動為您建立。
Codex 可以在 OpenAI 提供的三個地方之一取得:Codex 命令列工具 (CLI)、IDE 擴充功能,或 ChatGPT 桌面應用程式中的 Codex 選項。CLI 在 Windows 上原生運行;您可以透過下方指令或 npm install -g @openai/codex 從 PowerShell 安裝。首次運行 codex 時,請選擇「使用 ChatGPT 登入」。
您還需要一個 ChatGPT 帳戶。截至 2026 年 10 月 5 日,OpenAI 的 Codex 定價頁面顯示 Codex 適用於所有 ChatGPT 方案:免費方案用於快速編碼任務,Go 方案用於輕量級任務,而每月 20 美元的 Plus 方案則提供更多使用量。
OpenAI API 金鑰也適用,按 API 費率計費:codex login --with-api-key 會從標準輸入讀取金鑰。我們尚未在免費帳戶上自行運行獨立的 CLI;Flockbay 內部的 Codex 引擎確實可以在免費帳戶上構建。
安裝指令:powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
步驟 1:使用 codex mcp add 將 Codex 連接到 Flockbay。從 flockbay.com 安裝 Flockbay,開啟它並用一句話描述您的遊戲。應用程式會顯示它所理解的內容,並預選 2D 或 3D;選擇資料夾後按下「繼續」。您的遊戲會在 Flockbay 應用程式託管的 Godot 編輯器中開啟。請讓它保持開啟:Codex 只能存取應用程式中開啟的遊戲。
在 Flockbay 選單中選擇「連接器」(Connectors),然後在「連接您的代理 (MCP)」旁邊按下「設定」(Set up)。開啟它,從列表中選擇 Codex,然後點擊「複製」(Copy)。在 PowerShell 或命令提示字元中執行複製的指令。
這會將單一伺服器 flockbay-stage 註冊到 Codex 的全域設定中,因此 Codex 可以從任何資料夾看到它。在相同位置按下「安裝技能」(Install skills)。
這會將 Flockbay 的代理指令複製到 Codex 的技能中,讓 Codex 在開始前了解工具如何協同運作。Codex 只會取得技能;應用程式安裝的掛鉤是針對 Claude Code 和 Cursor 的。Flockbay 應用程式會為您寫入此內容,並填入真實的路徑:開啟帳戶選單,選擇「MCP 連線」(MCP connection),按下「開啟」(Turn on),選擇 Codex 並按下「複製」(Copy)。
這三個路徑是您機器特有的,並且在每次使用時保持不變,因此您只需貼上一次。以下是其形式,路徑為佔位符。
codex mcp add flockbay-stage --env "FLOCKBAY_LOCAL_STAGE_CAPABILITY_AUTHORITY_DESCRIPTOR=<descriptor>" -- "<node>" "<coordinator>" --external-stage-mcp
Codex 會將 Flockbay 伺服器保存在 config.toml 中,位於其家目錄:Windows 上的 %USERPROFILE%\.codex\config.toml。命令列工具 (CLI)、IDE 擴充功能和 ChatGPT 桌面應用程式共享該設定,因此根據 OpenAI 的文件,一旦添加伺服器,所有三個都能存取。了解此條目在出現問題時很有用。
以下是手動編寫的範例,路徑為佔位符,並添加了一行可選設定。在 TOML 格式中,Windows 路徑應使用單引號,或將每個反斜線重複一次。這裡有兩個重要的可選設定。startup_timeout_sec 是 Codex 等待伺服器啟動的時間,預設為 10 秒。
default_tools_approval_mode 決定 Codex 在執行此伺服器的工具前是否會詢問:auto(自動)、prompt(提示)、writes(寫入)或 approve(批准)。
```toml
[ mcp_servers . flockbay-stage ]
command = '<node>'
args = [ '<coordinator>' , '--external-stage-mcp' ]
startup_timeout_sec = 20
[ mcp_servers . flockbay-stage . env ]
FLOCKBAY_LOCAL_STAGE_CAPABILITY_AUTHORITY_DESCRIPTOR = '<descriptor>'
```
步驟 2:在遊戲資料夾中啟動 Codex 並檢查 /mcp。在遊戲資料夾(通常是 Documents\Flockbay 和遊戲名稱)中開啟終端機,然後輸入 codex。在 Codex 內部,/mcp 會列出它已啟動的伺服器;flockbay-stage 應該會出現在其中。/mcp verbose 會添加每個伺服器的診斷資訊。
Codex 在執行任何工作之前會讀取 AGENTS.md。Flockbay 的指令透過工具和技能傳達給它,因此 AGENTS.md 用於您的個人偏好:您追求的風格、不應更改的內容,以及您喜歡如何報告更改。Codex 會根據資料夾建議其權限。
對於在 Git 管理下的資料夾,它建議「自動」(Auto),這表示它會在資料夾內進行編輯,並在觸及資料夾外部或網路之前詢問;對於沒有 Git 的資料夾,它建議唯讀。在您的第一次會話之前,請在遊戲資料夾中執行 git init。這會為 Codex 提供正確的預設權限,並為您提供一個歷史記錄,以便在糟糕的下午後撤銷更改。
步驟 3:給予 Codex 可檢查的提示詞。Codex 在處理有明確終點的任務時表現最佳。「讓遊戲變得有趣」沒有終點。「添加一個旋轉的硬幣,當玩家觸碰它時會發出聲音並消失。然後玩遊戲,讓玩家走進硬幣,並告訴我它是否離開了場景」則有一個終點,Codex 可以自行達成。
首先從閱讀任務開始,讓它先了解專案:詢問主場景中有什麼、玩家如何移動以及控制方式是什麼。然後每個提示詞處理一個機制,每個機制都帶有數字或事件供檢查。Codex 傾向於在行動前顯示其計畫;請閱讀它,因為這是捕捉誤解最便宜的地方。
Codex 透過開啟的 Godot 編輯器修改遊戲。節點、屬性、腳本、資源和訊號都在那裡更改,每次更改都是 Godot 復原歷史中的一個單一步驟,並且場景在更改後會被儲存。一個錯誤的步驟只需在編輯器中按一次 Ctrl+Z 即可復原。它會驗證更改。
對於它編寫的腳本,它會得到 Godot 自己的解析錯誤,並顯示行號,並且可以進行無頭模式執行以查看其啟動。然後它會在應用程式的遊戲畫面中玩遊戲並讀取標準輸出,每個錯誤都帶有其檔案、行號和呼叫堆疊。它會像玩家一樣嘗試遊戲。
Codex 可以按住一個鍵半秒,點擊、移動滑鼠或觸發一個輸入動作,然後從正在運行的場景中讀取一個值,例如硬幣節點是否仍然存在,並捕捉遊戲視埠或編輯器的 3D 或 2D 視埠。所有這些都不會移動您自己的滑鼠,如果您在它玩遊戲時觸摸任何鍵,它會停止並將遊戲控制權交還給您。
世界不是手寫的幾何圖形。地形、水、天空、天氣、玩家和每個放置的物件都來自 Codex 按名稱和設定要求的系統:3D 遊戲中有六個,2D 遊戲中有四個,2D 遊戲沒有水或天氣。對於道具,它可以在 Flockbay 的模型、紋理和聲音庫中搜尋。
它可以在當天的免費使用額度下製作新的音效和循環,或者如果您添加了 ElevenLabs 金鑰,也可以使用您的金鑰,並使用您自己的 Tripo 金鑰製作新的 3D 模型。
Codex 在呼叫更改遊戲的工具之前可能會詢問,這取決於您的權限和伺服器的批准設定。在這裡批准是便宜的,因為每次編輯器更改都是一次 Ctrl+Z。它的步驟也會顯示在 Flockbay 應用程式中,在名為「您的代理」(Your agent) 的聊天中。
另一種方式:在 Flockbay 內部登入 ChatGPT。您根本不需要運行 Codex 就可以在您的 ChatGPT 方案上進行構建。在 Flockbay 中,開啟「連接器」(Connectors) 並在 ChatGPT 列上按下「使用 ChatGPT 登入」(Sign in with ChatGPT)。
您的瀏覽器會開啟 OpenAI 的登入頁面,然後將您帶回。從那時起,您就可以在 Godot 編輯器旁邊的聊天中與 Flockbay 自己的 AI 聊天,它會在您的 ChatGPT 訂閱上運行。
在模型選單中,ChatGPT 列會使用您的 ChatGPT 帳戶選擇的模型。它適用於任何 ChatGPT 方案,包括免費方案。OpenAI 設定了每個方案可以使用多少;其 Codex 定價頁面將免費方案描述為用於快速編碼任務。如果 OpenAI 拒絕某個帳戶,Flockbay 會在卡片上顯示並在訊息失敗時說明拒絕原因。
與連接 Codex 的區別在於誰在驅動。在這裡,Flockbay 的 AI 會按照應用程式的意圖工作:它一次提出一輪問題,首先寫一份簡短的構建摘要,並在您批准後才開始構建,使用與 Codex 相同的工具。您只需待在一個視窗中,無需終端機。連接 Codex 後,您驅動 Codex,使用您自己的習慣和設定,而 Flockbay 提供工具。
透過 ChatGPT 登入生成的藝術來自您自己的 Tripo 或 ElevenLabs 金鑰;如果沒有這些金鑰,它會從庫中構建或使用 Godot 的形狀。
使用 Flockbay 進行 Codex 疑難排解。Codex 說 flockbay-stage 伺服器啟動失敗或超時。Codex 預設給予伺服器 10 秒的啟動時間。在 config.toml 的 [mcp_servers.flockbay-stage] 下添加 startup_timeout_sec = 20。
如果仍然失敗,請檢查該條目中的三個路徑是否與 Flockbay 對話框中的行一致(如果應用程式本身無法啟動,會顯示紅色),然後再次貼上當前行。
伺服器不在 /mcp 中。在終端機中運行 codex mcp list。如果未列出,請再次貼上該行;它是全域的,因此資料夾無關緊要。Codex 看到 flockbay-stage 但只有一個工具,即狀態檢查。這表示應用程式已關閉、沒有開啟遊戲,或者在「連接器」(Connectors) 中「連接您的代理 (MCP)」已關閉。
修復其中任何一個問題,其餘工具將自動加入會話。如果仍然缺失?退出 Codex 並重新啟動。
Codex 不會編輯任何內容。資料夾以唯讀模式啟動。使用 /permissions 切換到「自動」(Auto),或者在遊戲資料夾中運行 git init,以便 Codex 下次選擇「自動」。Codex 報告編輯器已關閉,或者它必須等待。場景和腳本更改透過 Flockbay 應用程式託管的 Godot 編輯器進行,因此請先在應用程式中開啟遊戲。
拒絕「播放」(Play) 是故意的:如果您在 Codex 上次運行遊戲後自行使用了世界工具,應用程式會將「播放」交給您。而且,當 Flockbay 自己的 AI 正在該遊戲中運行時,Codex 會被要求暫停,直到它結束。ChatGPT 登入失敗。
任何 ChatGPT 方案都可以在這裡構建,包括免費方案。當 OpenAI 拒絕某個帳戶時,會顯示一張標題為「您的 ChatGPT 帳戶無法在此構建」的卡片,並且失敗的訊息會說明拒絕原因。
使用 Codex 製作遊戲的費用。將 Codex 連接到 Flockbay 是免費的,透過 ChatGPT 登入進行構建也是免費的。