Codex 使用方法 — 從安裝到不訂閱、使用 API 金鑰，並計算單項工作的實際費用

Codex 是 OpenAI 的程式設計代理。基本使用方式是在終端機安裝執行的 Codex CLI（npm install -g @openai/codex），接著在要工作的儲存庫中執行 codex，再以韓文提出請求。開始使用有兩種方式：登入 ChatGPT 方案（Plus·Pro·Business 等），在用量上限內使用；或透過 API 金鑰執行，只支付所使用的 Token。由於韓國國內的使用教學幾乎都只介紹前一種方式，本文將依序整理後一種方式——無需訂閱執行 Codex CLI 的設定、為每項工作選擇模型的方法，以及單項工作的實際費用。各方案的上限與用完上限後的選項，另整理於Codex 用量上限。

Codex 不是把程式碼貼到聊天視窗中的工具，而是在儲存庫中讀取、修改檔案並執行測試與指令的代理。執行後可透過 /permissions 決定哪些工作能在未確認的情況下交給它。

使用 Codex 的兩種方式

使用 API 金鑰執行時，費用會與 ChatGPT 方案的用量分開計算。您也可以直接使用 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（費率會直接從目錄讀取）。

安裝 Codex — 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 登入，至此即可完成，不需要進行下方設定。

取得與設定 Codex API 金鑰 — 一個 config.toml 區塊

先完成註冊並從 $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 前，先透過一次請求確認金鑰與端點，有助於區分問題所在。

# 코덱스를 의심하기 전에, 키와 엔드포인트만 요청 한 번으로 확인합니다
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 會減少，因此結果更快、更準確，帳單金額也會降低。Claude Code 的使用方式整理在Claude Code 使用方法中。

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

使用 API 金鑰執行的最大優點，是可以根據工作的重量選擇模型。model只是端點的模型名稱，因此切換時不需要新的金鑰或額外設定。

# config.toml의 기본값(gpt-5-6-sol)은 그대로 두고, 이번 실행만 모델을 바꿉니다
codex -m gpt-6-astra     # 원인을 모르는 버그, 여러 모듈에 걸친 변경
codex -m gpt-5-6-terra   # 정형화된 수정, 일괄 치환, 로그 요약 같은 가벼운 작업

「一項工作」是以修復一個失敗測試需要 20 個步驟來計算。1 個步驟包含 25,000 個輸入 token（系統提示 + 對話記錄 + 讀取的檔案）與 1,200 個輸出 token（一次修改或說明），因此一項工作為輸入 500,000 · 輸出 24,000 個 token。使用 GPT-5.6 Sol時，費用為 $1.29，相同的 token 直接交給 OpenAI 時，目前促銷價格為 $2.48（正式價格為 $3.22）。模型越便宜，可能越需要反覆修正，導致往返次數增加；如果一次無法完成，提升一個等級是比較實際的做法。若要以自己的 token 數量直接試算，請使用費用計算器。

此計算未納入快取。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 模型頁面，完整費率請參閱價格表；若要並列比較 Codex 使用的 GPT 模型 token 費率，請參閱GPT API 價格。

常見錯誤

坦白說 — ChatGPT 方案較適合的情況

如果您每天花幾個小時與 Codex 對話並工作，固定費用方案通常更便宜。按量計費會完全依照 token 數量成比例增加，因此用量越大、越穩定，固定費用方案的優勢越明顯。基準是「月費 ÷ 單項工作費用」，方案的損益平衡點已在Codex 價格中計算。

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

相反地，適合使用 API 金鑰的人包括：使用日與不使用日差異很大的人、想為每項工作選擇模型的人、想在團隊中按金鑰分開限制與用量記錄的人，以及只想在方案上限用完的日子繼續工作的人。兩者可以一起使用。刪除 config.toml中的 model_provider行即可恢復使用 ChatGPT 登入；如果想在每次執行時切換，請使用 Codex 的 --profile。

Kunavo 可使用卡片、Apple Pay、Google Pay 等方式儲值；當付款頁面以韓元顯示時，也會提供 Kakao Pay·Naver Pay·PAYCO·Samsung Pay 和韓國國內卡片（包括未開放海外付款的卡片）。不支援 Toss。餘額沒有有效期限，失敗的請求不會收費。如果您正在考慮要選擇 Codex 還是 Claude Code，請參閱 Codex vs Claude Code。

常見問題