Codex 使用方法——从安装到不使用订阅通过 API 密钥运行

Codex 是 OpenAI 的编码代理。基本用法是安装在终端中运行的 Codex CLI（npm install -g @openai/codex），然后在要处理的代码仓库中启动 codex，并用日语提出请求。开始使用有两种方式：使用 ChatGPT 计划（Plus、Pro、Business 等）登录并在其使用额度内使用，或使用 API 密钥运行并仅按使用的 token 付费。日语教程几乎只介绍前者，因此本页面将依次介绍后者——无需订阅即可运行 Codex CLI 的设置、如何按任务选择模型，以及每项任务的实际费用。

Codex 不是一个把代码粘贴到聊天界面中的工具，而是在代码仓库中读取和修改文件、运行测试和命令的代理。启动后，可以通过 /permissions 决定哪些操作无需确认即可交给它。

使用 Codex 的两种方式

使用 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 中添加一个块

首先创建账户，从 $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 调用 Claude 模型的方法）请参阅 Codex CLI 集成文档（英文）；相关说明请参阅 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，如果向 OpenAI 直接支付相同 token 数量，按当前促销价格为 $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 价格 中计算。

还有两点需要了解。根据 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 对比。

常见问题