Skip to main content

​
快速開始

ReCodex 有兩種用法,共用同一個帳號和同一份額度,按你的習慣選一個即可:
  • 桌面端(推薦):裝一個應用,打開就能用,帳號和額度直接顯示在 Codex 介面裡。
  • 命令列:習慣終端的話,recodex 提供登入、查額度、切網關、自檢等命令。
兩種方式都需要你的機器上已經裝好官方 Codex 桌面客戶端 —— ReCodex 是在它之上工作的,不是替代品。官方下載頁在部分地區打不開,recodex.dev/download 的第 1 步就是它: Windows 和 macOS 都能點一下直接下載(我們鏡像的官方原包,附 sha256)。

​
方式一:桌面端(推薦)

1

下載安裝包

到 recodex.dev/download 下載對應系統的安裝包:
  • Windows:ReCodex-<版本>-windows-x64-setup.exe
  • macOS(Apple Silicon):ReCodex-<版本>-macos-arm64.dmg
頁面會自動把你目前系統的那個放在最前面。
2

安裝並打開

Windows 安裝到 %LOCALAPPDATA%\Programs\ReCodex,會建立桌面和開始功能表捷徑。 打開後它會自動找到你已安裝的 Codex 客戶端並接管介面。macOS 上把 ReCodex 拖進「應用程式」即可。首次開啟如果提示無法驗證開發者, 在 Finder 裡右鍵點它選「打開」,或執行:
我們目前還沒有 Apple 開發者帳號做公證,所以瀏覽器下載的包會帶隔離屬性。
3

登入 ReCodex

點右下角的 Rx 按鈕打開面板,在「帳號」頁點登入 ReCodex。 面板會顯示一個授權碼,點「打開授權頁」在瀏覽器裡確認即可。
4

重新啟動一次

登入成功後側邊欄會立刻換成你的帳號。但官方 Codex 行程是在你登入之前啟動的, 讀不到新寫入的設定,所以要重新啟動一次 —— 面板上直接點立即重新啟動生效就行。
登入完成後,你會在官方介面左下角的帳號選單裡看到自己的信箱、方案和 7 天用量。

​
方式二:命令列

​
1. 安裝

腳本會按平台選二進位、校驗 sha256、裝到 PATH 上。校驗不通過會直接中止,不會裝上去。 驗證:

​
2. 登入

終端會顯示授權碼與驗證地址,並嘗試打開瀏覽器。在瀏覽器裡批准目前裝置即可。

​
3. 自檢

它會逐項檢查:Codex 客戶端是否裝好、託管設定是否就位、是否已登入、憑據是否可見、網關是否可達、訂閱是否有效且 Codex 真的可用。全部通過才算設定正確。
Windows 上 recodex login 寫入的環境變數,目前終端讀不到 —— 需要新開一個終端視窗。 如果你在 IDE 擴充或桌面客戶端裡用,也要重新啟動它們。

​
常見的第一個問題

每個帳號最多同時授權 3 台裝置。到 裝置管理 撤銷一台不用的即可 —— 撤銷之後不用重新登入,客戶端的輪詢會自己走通。
先確認官方 Codex 桌面客戶端已經裝好。命令列下可以用 recodex install check 檢查 —— 它也能辨識從應用商店(MSIX)安裝的版本。
額度是從伺服器取的快照。手動點一次「重新整理額度」會立刻更新; 平時資料超過 5 分鐘沒更新時,客戶端也會在背景自動補一次。

​
下一步

運作原理

了解登入、託管設定和網關是怎麼串起來的。

命令參考

全部命令列指令、參數與環境變數。