Codex 使用方法 — 從安裝到不用訂閱、使用 API 金鑰執行

Codex 是 OpenAI 的程式設計代理程式。基本使用方式是安裝在終端機中執行的 Codex CLI（npm install -g @openai/codex），在想要作業的儲存庫中啟動 codex，再以日文提出要求。開始使用有兩種方式：使用 ChatGPT 方案（Plus、Pro、Business 等）登入並在額度內使用，或使用 API 金鑰執行並按使用的 token 量付費。由於日文解說文章幾乎只介紹前者，本頁將依序說明後者——不訂閱也能執行 Codex CLI 的設定、如何依工作選擇模型，以及每項工作的實際費用。

Codex 不是把程式碼貼到聊天畫面的工具，而是在儲存庫中讀取和修改檔案、執行測試與指令的代理程式。啟動後，可以透過 /permissions 決定要在多大程度上免確認交由它處理。

使用 Codex 的 2 種方式

使用 API 金鑰時，費用會與 OpenAI 方案的使用額度分開計算。雖然也可以直接使用 OpenAI API 金鑰，但本頁介紹的是指向 Responses API 相容端點的方法。從 GPT-6 Astra 到 GPT-5.6 Terra 都可使用同一把金鑰切換；例如 GPT-5.6 Sol 相較於 OpenAI 的定價 $5.00 / $30.00（OpenAI 目前以促銷價格 $4.00 / $20.00 提供，依價格頁面所示至少持續至 2026年11月21日），每 1M token 為 $2.00 / $12.00（費率直接從目錄載入）。

安裝 — npm 或 Homebrew

# npm（Node.js が入っていれば macOS / Linux / Windows 共通）
npm install -g @openai/codex

# Homebrew（macOS）
brew install --cask codex

兩者都是 OpenAI 官方 README 列出的方法。Windows 也可使用 npm 指令安裝。安裝完成後，在想要作業的儲存庫目錄中輸入 codex 即可啟動。若使用 ChatGPT 登入，至此就完成了，之後不需要其他設定。

使用 API 金鑰執行 — 在 config.toml 中加入 1 個區塊

首先建立帳戶，從 $10 起儲值，然後在API 金鑰頁面建立金鑰。金鑰只會顯示一次，請立即記錄。接著在 Codex 設定檔中撰寫一個供應商區塊。

# ~/.codex/config.toml（無ければ作る）
model          = "gpt-5-6-sol"
model_provider = "kunavo"

[model_providers.kunavo]
name     = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key  = "KUNAVO_API_KEY"   # キーそのものではなく「環境変数の名前」
wire_api = "responses"        # 唯一の有効値。省略しても同じ

這裡最容易出錯的是 env_key。要填寫的是存放金鑰的環境變數名稱，而不是金鑰本身。由於金鑰不會寫入設定檔，因此 config.toml 可以直接提交或貼到問題中，無需擔心安全性。

# env_key で指定した名前の変数にキーを入れる（キーは sk-kn- で始まる）
export KUNAVO_API_KEY="sk-kn-..."

# 毎回 export しないよう、使っているシェルの設定ファイルに追記しておく
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

如果使用 Windows PowerShell，請執行 setx KUNAVO_API_KEY sk-kn-...，然後重新開啟新的終端機。設定檔位置是 %USERPROFILE%\.codex\config.toml。在啟動 Codex 前，先用一次請求確認金鑰和端點是否正確，之後會更容易排除問題。

# Codex を疑う前に、キーとエンドポイントだけを 1 回で確かめる
curl https://api.kunavo.com/v1/responses \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5-6-sol", "input": "OK とだけ返して"}'

如果回傳 JSON，表示金鑰和端點都正常；若仍有問題，則在 config.toml 這一側。設定項目的詳細資訊請參閱Codex CLI 整合文件（英文）；包含如何從 Codex 呼叫 Claude 模型的說明，請參閱Codex CLI API 金鑰設定指南（英文）。

第一項工作

# 1. 作業したいリポジトリに入って起動する
cd ~/work/my-app
codex

# 2. AGENTS.md の雛形を作らせる（テストの実行方法や決めごとを書くファイル）
> /init

# 3. あとは日本語で頼む。ファイル名を添えるほど速く、安く終わる
> src/utils/date.test.ts が落ちている。原因を調べて直し、テストが通るのを確認して

/init 建立的 AGENTS.md 是用來記錄「即使閱讀程式碼也無法得知的規則」的檔案，例如測試執行方式、使用的函式庫和不可碰觸的路徑，之後的工作階段會自動載入。產生的內容只是草稿，請手動修正。

提出要求的訣竅與 Claude Code 相同：附上檔名和路徑，並且不要一次提出過大的要求。由於用於探索的 token 減少，結果會更快速、更準確，帳單也會降低。可透過 /permissions 調整確認對話框的頻率。Claude Code 的運用方式整理在Claude Code 的使用方式。

依工作選擇模型 — 每項工作的實際費用

使用 API 金鑰執行的最大優點是可以依工作的繁重程度選擇模型。model 只是端點上的模型名稱，因此切換不需要新增金鑰或設定。

# config.toml の既定（gpt-5-6-sol）はそのまま、この起動だけモデルを変える
codex -m gpt-6-astra     # 原因の見えないバグ、設計をまたぐ変更
codex -m gpt-5-6-terra   # 定型の修正、一括置換、ログの要約などの軽い作業

「一項工作」是以修復一個失敗測試需 20 個步驟來計算。每個步驟包含輸入 25,000 token（系統提示、對話記錄和讀取的檔案）及輸出 1,200 token（一次編輯或說明），因此每項工作為輸入 500,000、輸出 24,000 token。若為 GPT-5.6 Sol，則為 $1.29，相同 token 數量直接支付給 OpenAI 時，按目前促銷價格為 $2.48（按定價則為 $3.22）。模型越便宜，因返工而增加往返次數的情況可能越多；若無法一次完成，提升一個等級是較實際的用法。

此計算未考慮快取。Codex 每個步驟都會重新傳送對話記錄，因此命中快取的輸入會以輸入單價的 0.10 倍計費（若為 GPT-5.6 Sol，每 1M token 為 $0.20），新寫入快取的部分則以輸入單價的 1.25 倍計費。此外，GPT-5.6 系列和 GPT-6 Astra 在單一請求的提示超過 272K token 時，該請求整體會按輸入 2 倍、輸出 1.5 倍計費。不要在單一工作階段塞入太多工作，按工作重新啟動較安全。推理模型的思考 token 會作為輸出計費，因此工作越困難，輸出也會增加。實際費用請在回應的 usage 和使用記錄中確認。模型規格請參閱GPT-5.6 Sol 模型頁面，所有模型的單價請參閱價格表。

常見錯誤

老實說 — ChatGPT 方案較划算的情況

如果每天花數小時與 Codex 互動作業，固定月費方案通常較便宜。按用量計費會直接與 token 數量成正比，因此使用量越大且越穩定的人，固定月費的優勢越明顯。分界點是「月費 ÷ 每項工作的單價」，方案的損益平衡點已在Codex 價格中計算。

另外還有 2 點需要注意。根據 OpenAI 文件，依賴 ChatGPT 工作區或雲端的功能，在使用 API 金鑰時可能受到限制或無法使用。此外，Kunavo 的路徑使用共享容量，沒有專用配額，也沒有合約上的 SLA。如果需要保證的額度或 SLA，直接與 OpenAI 簽約會更合適。

相反地，API 金鑰適合使用日與非使用日差異很大、想依工作選擇模型、希望在團隊中為每把金鑰分別管理上限和使用記錄，以及只想在方案額度用完的日子繼續作業的人。兩種方式可以並存。刪除 config.toml 的 model_provider 行即可返回 ChatGPT 登入；如果想在每次啟動時切換，則可使用 Codex 的 --profile。

付款方式包括信用卡（含 JCB）、Apple Pay、Google Pay 等，餘額沒有有效期限。不支援超商付款和 PayPay。失敗的請求不會收費。如果不確定該使用 Codex 還是 Claude Code，請參閱 Codex 與 Claude Code 的比較。

常見問題