Windows Codex API 最简接入指南

适用于 Windows 原生 Codex Desktop 和 Codex CLI。你只需要一枚管理员发放的 API Key。本指南适合新安装，或愿意用固定配置替换现有 Provider 的用户；如需保留已有自定义设置，请先备份原文件。

API Key 会明文保存在这台电脑的 config.toml 中。不要分享、上传或截图泄露该文件。

1. 打开配置文件

完全退出 Codex，打开 PowerShell，粘贴并运行：

powershell

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
notepad "$env:USERPROFILE\.codex\config.toml"

如果记事本询问是否创建新文件，选择“是”。

2. 粘贴固定配置

清空记事本中的原内容，再完整粘贴下面的固定配置。只将 PASTE_API_KEY_HERE 替换为你的 API Key：

toml

model = "gpt-6-astra"
model_reasoning_effort = "high"
model_provider = "codex-stack"

[model_providers.codex-stack]
name = "Codex Stack"
base_url = "https://api.meowtis.net/v1"
experimental_bearer_token = "PASTE_API_KEY_HERE"
wire_api = "responses"
supports_websockets = false

保存文件，关闭记事本。

3. 开始使用

重新打开 Codex Desktop，或在 PowerShell 中运行：

powershell

codex

能正常发送消息并收到回答，即表示已通过 Astra 接入完成。

如果旧版 Codex 的下拉菜单没有显示 Astra，仍会按这份配置默认调用 Astra；菜单显示由客户端内置模型目录控制，不能通过本站 API Key 或单个配置字段改变。更新 Codex 后再查看菜单即可。

可选：开启超过 272K 的上下文

需要处理很长的对话或材料时，可为支持长上下文的模型（例如 gpt-5.6-sol 或 gpt-6-astra）提高客户端预算。先退出 Codex 并备份配置文件，然后在 config.toml 的顶层添加或修改下面两行，放在第一个 [... ] 配置块之前，不要放进 [model_providers.codex-stack] 内，也不要重复已有字段：

toml

model_context_window = 1000000
model_auto_compact_token_limit = 900000

第一行将客户端上下文预算设为 1,000,000 Token；第二行在约 900,000 Token 时触发历史自动压缩。它们不会提高模型本身的上限，也不是每次请求必须使用的 Token 数。模型需支持该长度；不要将此配置用于 Spark 等较小窗口模型。若想使用 Sol，将已有顶层 model 改为 "gpt-5.6-sol"，其余接入配置保持原样。

保存后重新打开 Codex Desktop 或 CLI，并新建任务。Windows 原生和 WSL 的配置彼此独立，请修改实际运行环境使用的那份文件。恢复默认预算时，删除这两个自定义字段（若原来已有值，则恢复备份中的值），重开 Codex 并新建任务。字段说明见 OpenAI 配置参考。

费用提醒：开启配置本身不收费；单次请求的实际输入超过 272,000 Token 才触发长上下文加价，恰好 272,000 不触发。 对上述 Astra／5.6 模型，整次请求的普通输入、缓存读取和缓存写入单价乘 2，输出单价乘 1.5，并非只对超出部分加价。门槛按包含缓存的输入总量判断，不按整段对话累计用量判断。以 Sol Standard 为例，输入／输出每百万 Token 从 $4／$20 变为 $8／$30；后续请求若仍携带超过门槛的历史，也会继续按长上下文价格计算。详见价格说明。

只在出错时看

401 Unauthorized：API Key 填写错误、已过期或已被删除；重新核对 Key，不要留下占位文字或前后空格。
402 Payment Required：账户可用费用已经用完；登录账户门户查看剩余费用，或联系管理员。
403 Forbidden：该 API Key 当前没有调用权限；联系管理员核对。
429 Too Many Requests：当前并发已满，等待已有调用结束后重试。
仍然进入原有 Provider：确认修改的路径是 %USERPROFILE%\.codex\config.toml，然后完全退出并重开 Codex。
连接超时：如果开启了 Clash 等代理，先将 api.meowtis.net 设为直连后重试。