在 Codex 中安裝 XCR：重活交出去，Codex 額度更耐用

為什麼要在 Codex 裡用 XCR

Codex 用的是 ChatGPT 方案裡的額度，而涉及多個檔案、還要反覆修測試的功能，正是最快耗光一個時段的那類工作。連上 XCR 之後，Codex 負責對話、規劃和驗收，最重的實作交給 XCR。XCR 的任務用它自己的模型接入完成，費用從 XCR 餘額扣，所以 Codex 的額度能撐得更久。關於限額本身，請看 Codex 用量限制詳解。

開始之前

• 一台裝好並登入了 Codex 的 macOS 或 Linux 電腦。
• Node.js 20 或以上。沒有的話，Codex 可以在安裝過程中幫你裝上，裝之前會先問你。
• 一個有餘額的 XCR 帳戶。在安裝頁用電子郵件登入，然後在「餘額與帳單」儲值 $5 起的額度包。

第 1 步：開啟安裝頁，選擇 Codex

在控制台開啟「安裝到電腦」，選 Codex 標籤。「XCR 會在你的電腦上變更這些項目」下面列出了它為 Codex 做的兩處改動。看完後勾選同意。

第 2 步：複製指令，貼給 Codex

點「複製安裝指令」，把內容貼給 Codex。這段指令會讓 Codex：

1. 用 node --version 檢查是否有 Node.js 20 或以上；沒有就先安裝最新的 LTS 版，安裝前會先告訴你。
2. 在終端機執行一條命令。它從 xcr.ai 下載外掛，先核對 SHA-256 再執行，沒核對通過的東西不會被執行。
3. 用一兩句話告訴你命令的輸出，並提醒你重新啟動 Codex。

Codex 請求執行命令或聯網時，點「允許」。這段指令只能用一次，10 分鐘內有效，過期了重新複製即可。

第 3 步：等到「已連線」，然後重新啟動 Codex

控制台頁面會顯示「正在等 Codex 安裝完成……」，安裝完成後立刻變成「已連線」，並顯示你的電腦名。重新啟動 Codex，讓它載入 XCR。如果不小心關了頁面，點「已安裝？檢查連線」就能找回這台電腦。

Codex 設定裡改了什麼

• ~/.codex/config.toml：加一段 XCR 設定，把 XCR 註冊為 Codex 的 MCP 服務，工具逾時設為 180 秒。
• ~/.codex/AGENTS.md：加一條簡短規則，告訴 Codex 什麼時候把活交給 XCR，以及怎樣驗收結果。

每處改動都放在清楚標記的 XCR 行之間，改動前會先把原檔案備份到你主目錄下 XCR 自己的資料夾裡。Codex 的其他設定一概不動。

確認已經生效

重新啟動後問 Codex：「我的 XCR 餘額是多少？」Codex 會透過 XCR 回答你的剩餘額度和這台電腦今天的花費。然後提一個比小修小改更大的需求，比如「為訂單頁加上 CSV 匯出，支援依日期和狀態篩選」。Codex 會把它交給 XCR，任務會出現在控制台的「任務記錄」裡。

一次交接是什麼樣的

XCR 在專案副本上工作，在離線沙箱裡執行你專案的檢查（型別檢查、程式碼規範檢查、測試）：macOS 直接支援，Linux 裝好 bubblewrap 即可；檢查失敗會在任務預算內自動修復。Codex 收到一份簡短報告：完成了哪些要求、改了哪些檔案、檢查結果和準確費用。檢查通過後，改動直接寫進你的工作區、不自動提交，你可以像審查其他 diff 一樣審查它。Codex 會對照你的需求檢查一遍，並完成需要聯網的步驟，比如安裝套件。想把改動撤回？讓 Codex 撤銷這次 XCR 改動即可。

在 Codex 裡用好 XCR

• 把完整需求一次說清，包括怎麼測試。XCR 照著它實作，Codex 照著它驗收。
• 保持 AGENTS.md 簡潔。Codex 每個任務都會讀它，XCR 的規則只有幾行。
• 某個儲存庫不想用 XCR？在「電腦與專案」裡為這個專案關掉即可。
• 想要一個硬性上限？在「電腦與專案」裡給這台電腦設每日上限。

暫停或解除安裝

用「總覽」頁頂部的開關可以暫停全部；暫停期間 Codex 自己幹活，不會產生費用。要從這台電腦刪除 XCR，對 Codex 說「幫我把 XCR 從這台電腦上解除安裝」，或者在「電腦與專案」裡點「從這台電腦移除」。解除安裝只會拿掉 XCR 加進 config.toml 和 AGENTS.md 的內容，檔案其餘部分保持原樣；備份會保留，直到你自己刪除。第一次用 XCR？先看 XCR 快速上手。