Windows 安装及使用 Codex 保姆级教程：config.toml 与 API-KEY 配置 TaoToken 全流程

1. Windows 上 Codex 装完却跑不起来问题多半出在这三处Codex 是 OpenAI 推出的命令行编程助手能在终端里直接读代码、改文件、跑命令适合习惯在 Windows 上用 PowerShell 或 CMD 干活的开发者。它本身只是个客户端真正决定你能不能跑通的是三样东西config.toml 骨架写对没有、API-KEY 环境变量有没有生效、请求地址指向哪个通道。很多人卡在“装完了一敲命令就报 401 或连接超时”其实不是软件坏了而是这三处有一处没对齐。这篇就按 Windows 的实际路径来从安装讲到 config.toml 怎么写、环境变量怎么设、TaoToken 的统一 Key 和 API 通道怎么接进去最后用一次最小对话把整条链路验证通。全程命令可直接复制遇到报错我在第 5 节列了常见几种的排查方向。你不需要有 Node 或 Python 的深度经验照着做就行。先说清楚 Codex 在 Windows 上的两种安装来源一种是从系统自带的应用商店装另一种是从官方发布渠道拿安装包。商店版省事但版本更新有时滞后安装包版更贴近最新发布。两者装完后的配置目录是一样的都在当前用户目录下的.codex文件夹里所以后面的配置步骤通用。装完之后别急着敲命令先确认codex --version能输出版本号。如果提示“不是内部或外部命令”说明安装目录没进 PATH重开一个终端或者手动把安装路径加进环境变量即可。这一步过了再往下走配置。2. 接入前先把 TaoToken 的 Key 和通道准备好Codex 默认走的是官方通道国内网络环境下直连经常不稳定所以更实际的做法是让它走一个统一的 API 通道。TaoToken 在这里扮演的就是这个角色你注册后拿到一个统一的 API-KEY再把 Codex 的请求地址指向它的 API 入口Codex 发出的请求就会经由这条通道转发到模型侧。需要准备的东西只有两样一个是 API-KEY一个是 API 基础地址。API-KEY 在控制台的 API Keys 页面生成生成后只显示一次记得当场复制存好。基础地址用https://taotoken.net/api这个形式注意末尾不要多加/v1具体拼法在 config.toml 里我会写清楚因为 Codex 的base_url字段对路径拼接比较敏感多一段少一段都会 404。如果你还没生成 Key可以先去控制台把 Key 建出来控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcodex_windows_configAPI Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcodex_windows_config生成 Key 的时候建议给它起个能认出来的名字比如codex-win这样以后在控制台看用量时能对上号。Key 本身是一串以sk-开头的字符复制时注意别把首尾空格带进去这是后面 401 报错的高频原因之一。3. config.toml 骨架与 API-KEY 环境变量的完整配置Codex 的配置分两层一层是.codex目录下的config.toml负责模型名、provider、请求地址这些结构性参数另一层是系统环境变量负责放 API-KEY 这种敏感信息。把 Key 放环境变量而不是写死在配置文件里是为了避免 Key 跟着配置文件被同步或提交出去。先找到配置目录。在文件资源管理器地址栏输入%USERPROFILE%\.codex回车正常情况下能看到config.toml和auth.json两个文件。如果目录不存在手动建一个.codex文件夹即可注意前面那个点不能少。3.1 config.toml 的可复制骨架用记事本或 VS Code 打开config.toml把内容替换成下面这段。这里的关键是base_url指向 TaoToken 的 API 入口env_key告诉 Codex 去哪个环境变量里读 Keymodel gpt-5.4 model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api/v1 env_key OPENAI_API_KEY wire_api responses几个字段逐个说明。model是你要调用的模型标识按你实际要用的填model_provider是自定义的 provider 名字和下面[model_providers.taotoken]这一段的名字必须一致不一致 Codex 会找不到 provider。base_url是请求根地址TaoToken 的 API 入口是https://taotoken.net/apiCodex 会在后面自动拼/v1/responses这类路径所以这里写成https://taotoken.net/api/v1是匹配的。env_key填OPENAI_API_KEY意思是让 Codex 去读这个环境变量拿 Key。wire_api用responses对应 Codex 的请求协议。3.2 环境变量的设置命令打开 CMD 或 PowerShell用setx写入用户级环境变量。注意setx写的是持久变量写完之后当前这个终端窗口读不到必须新开一个窗口才生效setx OPENAI_API_KEY sk-你的TaoToken密钥 setx OPENAI_BASE_URL https://taotoken.net/api/v1如果你用的是 PowerShell命令写法一样setx在 PowerShell 里也能用。写完之后关掉当前终端重新开一个用下面这条命令确认变量真的写进去了echo %OPENAI_API_KEY%能原样打印出你的 Key 就说明写成功了。如果打印出来是%OPENAI_API_KEY%本身说明变量没写进去检查一下是不是在错误的终端里执行了或者 Key 里带了特殊字符导致setx截断。3.3 auth.json 的处理.codex目录下还有个auth.json里面通常有个OPENAI_API_KEY字段。如果你已经用环境变量管 Key这个文件里的值可以留空或者保持原样Codex 会优先读环境变量。但如果你发现改了环境变量还是报 401可以打开auth.json把里面的 Key 也同步成同一个排除掉它覆盖环境变量的可能。4. 一次最小对话验证整条链路配置写完、环境变量设好、终端重开之后就可以验证了。验证的目标不是让它写多复杂的代码而是确认“Codex 能发出请求、TaoToken 能收到、模型能返回”这条链路是通的。先确认 Codex 能读到配置codex --version然后进一个空目录发起一次最简单的对话请求。不同版本的 Codex 子命令略有差异常见的是用codex直接进入交互模式或者用codex exec执行单条指令。以交互模式为例codex进入交互界面后输入一句最简单的需求比如“用一句话说明这个目录里有什么文件”。如果配置正确你会看到它开始输出思考过程然后返回结果。返回内容里如果带上了模型名和正常的自然语言回答说明请求已经经由 TaoToken 通道成功到达模型侧。如果你更想用非交互方式验证可以用codex exec print hello这条命令会直接把指令发给模型并打印返回。成功时你会看到模型返回的内容失败时会看到明确的错误码比如 401 表示 Key 无效404 表示 base_url 路径不对超时表示网络到 API 入口这一段不通。拿到错误码之后直接对照下一节排查。5. 本篇常见错误排查配置过程中最容易撞上的就下面这几种按报错信息对号入座即可。401 UnauthorizedKey 没读到或者 Key 本身无效。先在终端echo %OPENAI_API_KEY%确认变量有值再确认这个 Key 在 TaoToken 控制台里是启用状态。如果变量有值但还是 401检查auth.json里是不是有个旧的 Key 在覆盖把它同步成同一个。404 Not Foundbase_url路径拼错了。Codex 会在base_url后面自动追加/v1/responses之类的路径所以base_url应该写到/api/v1为止不要再往后加/responses。写成https://taotoken.net/api/v1/responses就会变成双份路径直接 404。连接超时或无法解析主机先确认base_url里的域名拼写正确再确认当前网络能正常访问这个域名。可以在终端用ping taotoken.net看解析是否正常但注意 ping 通不代表 HTTPS 端口通更准的方式是用curl https://taotoken.net/api/v1看返回。provider 找不到model_provider的值和[model_providers.xxx]里的xxx不一致。这两处必须字面完全相同大小写敏感改的时候一起改。改了配置不生效Codex 在启动时读一次配置改完config.toml或环境变量后必须完全退出 Codex 再重开。环境变量尤其要注意setx写完之后当前终端读不到必须新开终端。Key 里带了空格从控制台复制 Key 时首尾容易带上空格或换行setx会把它们一起写进去导致请求头里的 Key 不合法。重新用不带空格的 Key 执行一次setx覆盖即可。6. 跑通之后把 Key 和通道固定下来链路验证通过之后建议把这次用到的 Key 和通道固定成一套长期配置而不是每次临时改。具体做法是在 TaoToken 控制台里给这个 Key 起一个固定的名字比如codex-win以后所有 Windows 上的 Codex 都用它config.toml里的base_url和env_key保持不动只在你需要换模型时改model字段。如果你后面要在 Codex 里跑更长时间的编码任务或者接 Agent 流程可以看一下 Coding Plan 这条线它更适合持续性的编码场景Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcodex_windows_config如果只是想先在网页里试试模型对话、确认模型返回是否符合预期用模型对话页面更直接模型对话https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcodex_windows_config接入过程中如果遇到配置字段对不上的情况接入文档里有各字段的完整说明对着查比反复试错快接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcodex_windows_config最后留一个我实际踩过的坑setx写入的变量在同一个终端里不生效这件事我一开始没意识到改完 Key 直接在当前窗口敲codex一直报 401排查了半小时才发现是终端没重开。你改完环境变量之后第一件事就是关掉当前终端重新开一个能省掉很多无谓的排查。