国内开发者如何一键配置 OpenAI Codex CLIWindows/macOS/Linux 全流程适合想在终端里使用 Codex CLI、但卡在 API Key / Base URL / 环境变量配置的开发者。很多人安装 OpenAI Codex CLI 后第一步不是卡在模型能力而是卡在配置API Key 应该填哪里Base URL 为什么一定要带/v1Windows 用setx之后为什么还不生效wire_api chat is no longer supported怎么办能不能用 OpenAI-compatible API 接 Codex CLI这篇直接给一个可用方案用脚本把 Codex CLI 配到 Crazyrouter 的 OpenAI-compatible endpoint。GitHub 仓库https://github.com/xujfcn/crazyrouter-codex-cli1. Codex CLI 是什么Codex CLI 是一个可以在终端里辅助你读代码、解释项目、修改文件、执行开发任务的 AI coding 工具。它适合在项目目录里快速理解代码结构让 AI 帮你改小功能生成测试排查报错做代码审查前的初步分析。如果你已经习惯命令行开发Codex CLI 会比网页聊天更贴近开发流。2. 为什么很多人配置失败常见坑主要有 5 个。坑 1Base URL 少了/v1错误https://cn.crazyrouter.com正确https://cn.crazyrouter.com/v1OpenAI-compatible SDK 通常需要/v1。坑 2API Key 和 Base URL 不是同一个平台如果你使用 Crazyrouter 的 Base URL就要使用 Crazyrouter 控制台里的 API Key。坑 3Windows 环境变量设置后没重开终端PowerShell 里用setx后需要关闭当前终端重新打开。坑 4Codex 新版本不支持旧 wire_api如果你看到wire_api chat is no longer supported把配置改成wire_api responses坑 5把 UTM 参数加到了 API endpoint网页链接可以加 UTM但 API endpoint 不行。错误exportOPENAI_BASE_URLhttps://cn.crazyrouter.com/v1?utm_sourcecsdn正确exportOPENAI_BASE_URLhttps://cn.crazyrouter.com/v13. 一键安装方式Windows用普通用户身份打开 PowerShell运行iwr-UseB https://raw.githubusercontent.com/xujfcn/crazyrouter-codex-cli/main/install-crazyrouter-codex.ps1|iex或者下载后双击install-crazyrouter-codex.batmacOS / Linuxcurl-fsSLhttps://raw.githubusercontent.com/xujfcn/crazyrouter-codex-cli/main/install-crazyrouter-codex.sh|bash脚本会自动询问你的 Crazyrouter API Key写入环境变量配置 Codex CLI 使用https://cn.crazyrouter.com/v1备份已有 Codex 配置使用新版 Codex 推荐的wire_api responses。4. 手动配置方式如果你不想跑脚本也可以手动配置。4.1 安装 Codex CLInpminstall-gopenai/codex建议 Node.js 22。如果你用 nvmnvminstall22nvm use224.2 设置环境变量macOS / LinuxexportOPENAI_API_KEYsk-your-crazyrouter-keyexportOPENAI_BASE_URLhttps://cn.crazyrouter.com/v1Windows PowerShellsetx OPENAI_API_KEYsk-your-crazyrouter-keysetx OPENAI_BASE_URLhttps://cn.crazyrouter.com/v1Windows 设置后重开终端。4.3 启动 Codexcodex或者指定模型codex--modelgpt-5.55. config.toml 配置方式部分 Codex CLI 版本支持配置文件。路径Windows%USERPROFILE%\.codex\config.tomlmacOS / Linux~/.codex/config.toml示例model gpt-5.5 model_provider crazyrouter [model_providers.crazyrouter] name Crazyrouter base_url https://cn.crazyrouter.com/v1 env_key OPENAI_API_KEY wire_api responses [model_providers.crazyrouter.query_params]重点是这几行base_url https://cn.crazyrouter.com/v1 env_key OPENAI_API_KEY wire_api responses6. 常用模型示例codex# 使用默认模型codex--modelgpt-5.5# 推荐默认模型codex--modelgpt-4o-mini# 低成本模型codex--modelclaude-sonnet-4-6# Claude 路线取决于账户/模型可用性模型可用性会随账户、供应商线路、模型状态变化。建议先看模型列表https://crazyrouter.com/models?utm_sourcecsdnutm_mediumarticleutm_campaigndev_community7. 常见错误排查7.1 Codex 找不到命令npmlist-gopenai/codex如果没装npminstall-gopenai/codex7.2 API Key 不生效macOS / Linuxecho$OPENAI_API_KEYecho$OPENAI_BASE_URLWindows PowerShellecho$env:OPENAI_API_KEYecho$env:OPENAI_BASE_URL确认API Key 是 Crazyrouter 控制台里的 keyBase URL 包含/v1终端已经重启账户余额充足。7.3 500 / 502 / 524 错误这类错误通常和线路波动、上游模型、超时、长上下文有关。建议重试一次换一个相近模型缩短 prompt检查 Base URL如果持续出现把模型名、错误码、请求时间发给支持。参考https://crazyrouter.com/blog/how-to-fix-ai-api-500-502-524-errors?utm_sourcecsdnutm_mediumarticleutm_campaigndev_community8. 相关链接GitHub 脚本https://github.com/xujfcn/crazyrouter-codex-cliCrazyrouterhttps://crazyrouter.com?utm_sourcecsdnutm_mediumarticleutm_campaigndev_community模型列表https://crazyrouter.com/models?utm_sourcecsdnutm_mediumarticleutm_campaigndev_communityBase URL 详解https://crazyrouter.com/blog/openai-compatible-api-base-url-explained?utm_sourcecsdnutm_mediumarticleutm_campaigndev_community总结Codex CLI 配置 OpenAI-compatible API核心就是三件事API Key 用对Base URL 带/v1Codex config 里使用wire_api responses。如果你想省事直接用这个仓库的一键脚本https://github.com/xujfcn/crazyrouter-codex-cli
国内开发者如何一键配置 OpenAI Codex CLI？Windows/macOS/Linux 全流程
发布时间：2026/6/5 1:37:23
国内开发者如何一键配置 OpenAI Codex CLIWindows/macOS/Linux 全流程适合想在终端里使用 Codex CLI、但卡在 API Key / Base URL / 环境变量配置的开发者。很多人安装 OpenAI Codex CLI 后第一步不是卡在模型能力而是卡在配置API Key 应该填哪里Base URL 为什么一定要带/v1Windows 用setx之后为什么还不生效wire_api chat is no longer supported怎么办能不能用 OpenAI-compatible API 接 Codex CLI这篇直接给一个可用方案用脚本把 Codex CLI 配到 Crazyrouter 的 OpenAI-compatible endpoint。GitHub 仓库https://github.com/xujfcn/crazyrouter-codex-cli1. Codex CLI 是什么Codex CLI 是一个可以在终端里辅助你读代码、解释项目、修改文件、执行开发任务的 AI coding 工具。它适合在项目目录里快速理解代码结构让 AI 帮你改小功能生成测试排查报错做代码审查前的初步分析。如果你已经习惯命令行开发Codex CLI 会比网页聊天更贴近开发流。2. 为什么很多人配置失败常见坑主要有 5 个。坑 1Base URL 少了/v1错误https://cn.crazyrouter.com正确https://cn.crazyrouter.com/v1OpenAI-compatible SDK 通常需要/v1。坑 2API Key 和 Base URL 不是同一个平台如果你使用 Crazyrouter 的 Base URL就要使用 Crazyrouter 控制台里的 API Key。坑 3Windows 环境变量设置后没重开终端PowerShell 里用setx后需要关闭当前终端重新打开。坑 4Codex 新版本不支持旧 wire_api如果你看到wire_api chat is no longer supported把配置改成wire_api responses坑 5把 UTM 参数加到了 API endpoint网页链接可以加 UTM但 API endpoint 不行。错误exportOPENAI_BASE_URLhttps://cn.crazyrouter.com/v1?utm_sourcecsdn正确exportOPENAI_BASE_URLhttps://cn.crazyrouter.com/v13. 一键安装方式Windows用普通用户身份打开 PowerShell运行iwr-UseB https://raw.githubusercontent.com/xujfcn/crazyrouter-codex-cli/main/install-crazyrouter-codex.ps1|iex或者下载后双击install-crazyrouter-codex.batmacOS / Linuxcurl-fsSLhttps://raw.githubusercontent.com/xujfcn/crazyrouter-codex-cli/main/install-crazyrouter-codex.sh|bash脚本会自动询问你的 Crazyrouter API Key写入环境变量配置 Codex CLI 使用https://cn.crazyrouter.com/v1备份已有 Codex 配置使用新版 Codex 推荐的wire_api responses。4. 手动配置方式如果你不想跑脚本也可以手动配置。4.1 安装 Codex CLInpminstall-gopenai/codex建议 Node.js 22。如果你用 nvmnvminstall22nvm use224.2 设置环境变量macOS / LinuxexportOPENAI_API_KEYsk-your-crazyrouter-keyexportOPENAI_BASE_URLhttps://cn.crazyrouter.com/v1Windows PowerShellsetx OPENAI_API_KEYsk-your-crazyrouter-keysetx OPENAI_BASE_URLhttps://cn.crazyrouter.com/v1Windows 设置后重开终端。4.3 启动 Codexcodex或者指定模型codex--modelgpt-5.55. config.toml 配置方式部分 Codex CLI 版本支持配置文件。路径Windows%USERPROFILE%\.codex\config.tomlmacOS / Linux~/.codex/config.toml示例model gpt-5.5 model_provider crazyrouter [model_providers.crazyrouter] name Crazyrouter base_url https://cn.crazyrouter.com/v1 env_key OPENAI_API_KEY wire_api responses [model_providers.crazyrouter.query_params]重点是这几行base_url https://cn.crazyrouter.com/v1 env_key OPENAI_API_KEY wire_api responses6. 常用模型示例codex# 使用默认模型codex--modelgpt-5.5# 推荐默认模型codex--modelgpt-4o-mini# 低成本模型codex--modelclaude-sonnet-4-6# Claude 路线取决于账户/模型可用性模型可用性会随账户、供应商线路、模型状态变化。建议先看模型列表https://crazyrouter.com/models?utm_sourcecsdnutm_mediumarticleutm_campaigndev_community7. 常见错误排查7.1 Codex 找不到命令npmlist-gopenai/codex如果没装npminstall-gopenai/codex7.2 API Key 不生效macOS / Linuxecho$OPENAI_API_KEYecho$OPENAI_BASE_URLWindows PowerShellecho$env:OPENAI_API_KEYecho$env:OPENAI_BASE_URL确认API Key 是 Crazyrouter 控制台里的 keyBase URL 包含/v1终端已经重启账户余额充足。7.3 500 / 502 / 524 错误这类错误通常和线路波动、上游模型、超时、长上下文有关。建议重试一次换一个相近模型缩短 prompt检查 Base URL如果持续出现把模型名、错误码、请求时间发给支持。参考https://crazyrouter.com/blog/how-to-fix-ai-api-500-502-524-errors?utm_sourcecsdnutm_mediumarticleutm_campaigndev_community8. 相关链接GitHub 脚本https://github.com/xujfcn/crazyrouter-codex-cliCrazyrouterhttps://crazyrouter.com?utm_sourcecsdnutm_mediumarticleutm_campaigndev_community模型列表https://crazyrouter.com/models?utm_sourcecsdnutm_mediumarticleutm_campaigndev_communityBase URL 详解https://crazyrouter.com/blog/openai-compatible-api-base-url-explained?utm_sourcecsdnutm_mediumarticleutm_campaigndev_community总结Codex CLI 配置 OpenAI-compatible API核心就是三件事API Key 用对Base URL 带/v1Codex config 里使用wire_api responses。如果你想省事直接用这个仓库的一键脚本https://github.com/xujfcn/crazyrouter-codex-cli
