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 个步骤计算。每步包含 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。

常见问题