Skip to main content
Codex 是 OpenAI 的程式設計 Agent，有三種形態：終端裡的 Codex CLI、VS Code 裡的 Codex 擴充套件，以及 Codex App。三者共用 ~/.codex 目錄，配置一次即可全部生效。

​
一條命令安裝

把 sk-xxx 換成你的 Key，開啟終端，貼上並回車。指令碼會驗證 Key，列出該 Key 可呼叫的全部模型供你選擇（回車 = 推薦：Astra 套餐 gpt-astra，GPT 套餐 gpt-5.6-sol，Claude 套餐 claude-opus-5），安裝 Codex CLI 並寫入配置。
指令碼先詢問語言（1 = 越南語，2 = 英語；用 --lang en 或 --lang vi 跳過）。不傳 --key 時指令碼會提示輸入。強制指定模型：加 --model gpt-astra 或 --model gpt-5.6-sol。
執行前可先閱讀原始碼：codex.sh、codex.ps1。指令碼只在你的電腦上執行，Key 只傳送到 gpt.teamsoclo.site 用於驗證。

​
指令碼做了什麼

  1. 驗證 Key 並按套餐選擇模型；Key 無效則停止，不改動你的電腦。
  2. 備份已有的 config.toml 為 config.toml.bak.<時間>。
  3. 寫入 ~/.codex/config.toml：模型 gpt-5.6-sol、TeamSocLo 閘道器、Responses API。
  4. 把 Key 存入環境變數 TEAMSOCLO_API_KEY（寫入 ~/.zshrc / ~/.bashrc，Windows 為使用者變數）。Key 不在配置檔案裡，分享 config.toml 也不會洩露。
  5. 用 npm install -g @openai/codex 安裝或升級 Codex CLI。
隨時可重複執行以更換 Key 或套餐，舊配置總會先備份。
不想用終端機？TeamSocLo Key Tool 是 Windows 和 macOS 的 App，貼上一次金鑰即可設定 Codex、Claude Code 等 20 多個工具。

​
安裝之後

1

新開終端，執行 codex

舊終端尚未載入新的環境變數，必須新開一個標籤。隨便問一句驗證。
2

VS Code：安裝擴充套件，完全退出後重開

VS Code → Extensions → 搜尋 Codex（OpenAI’s coding agent）→ Install。然後完全退出 VS Code：macOS Cmd + Q，Windows 關閉所有視窗。Reload Window 不夠，擴充套件只在程序啟動時讀配置。
3

Codex App

執行命令後重新開啟 App。macOS 已透過 launchctl 為圖形程式設定變數；Windows 的 setx 對之後啟動的程式生效。
無需登入 OpenAI。requires_openai_auth = false 讓 Codex 直接使用環境變數中的閘道器 Key。

​
手動配置

若想自己編輯，~/.codex/config.toml（Windows：%USERPROFILE%\.codex\config.toml）內容必須為：
並且環境變數 TEAMSOCLO_API_KEY 中存有你的 Key。
保持 wire_api = "responses"。Codex 使用 Responses API，改成 chat 會失效。
快速開啟配置目錄：

​
切換模型

GPT Astra 套餐使用 gpt-astra。修改 config.toml 第一行並重啟 Codex：
GPT Key 呼叫 gpt-astra 會提示無可用渠道，反之亦然。模型跟隨所購套餐，見 模型與套餐。

​
解除安裝

想保留 Codex 但恢復原配置，把 config.toml.bak.<時間> 複製回 config.toml 即可。

​
不工作時檢查

  • 安裝後是否新開了終端或完全退出了 VS Code。
  • echo $TEAMSOCLO_API_KEY（Windows 的 cmd 中用 echo %TEAMSOCLO_API_KEY%）能輸出完整 Key。
  • base_url 以 /v1 結尾，wire_api 為 responses。
  • Key 未過期且有額度：在此檢查。
  • 仍有問題見 常見問題，其中有 Codex 專章。