Codex · 保姆版

Codex 是 OpenAI 的 AI 编码助手，形态和 Claude Code 一样——住在你电脑里、读你的文件、替你干活。 它的配置本来有点啰嗦，所以我们用一个叫 cc-switch 的可视化小程序帮你"点几下就配好"，不用碰任何配置文件。

不想要"保姆版"？

会用终端的看技术页 Codex CLI 部署 和 CC-Switch。本页是手把手版。

已经配过、但 Codex 报 401 / 连不上？别重配，先跑体检工具

直接跳到本页最后的 🩺 一键体检修复工具。它会逐项查出到底哪里坏了并当场修好。

最常见的原因不是你的 Key 有问题，而是电脑里残留着 ChatGPT 的登录态（auth.json）—— Codex 会优先拿它去请求，压根没用你配的 Key，网关当然不认。这种情况你把 Key 反复复制粘贴多少遍都没用。

cc-switch 是什么

一个桌面小程序：打开它会自动认出你装了哪些 AI 工具，你只要填一次地址和 Key、点"启用"，它就自动把配置写好。一个程序还能同时管 Codex 和 Claude。

开始之前

• 一台 Windows 64 位 或 Mac 电脑、能上网（不用梯子）、一个 why01 账号。

第 ① 步：拿到你的钥匙（API Key）

1. 打开 https://s1.why01.top，注册并登录。
2. 左侧 【令牌】→【添加令牌】，名字随便起。 ⚠️ 【分组】必选，Codex 请选 Codex-A（注意：配 Claude 时才选 Claude-A）。
3. 保存 → 【复制】，存好 sk-xxxxxx...。

详细版：创建专属 Key。

第 ② 步：装 cc-switch

cc-switch 是个免费开源的小程序。下载它有三种途径，推荐用第一种（我们自己的镜像，最干净、不报警告）：

① 我们的镜像（推荐 · 无需梯子 · 不报警告）

平台	下载
🪟 Windows（绝大多数电脑选这个）	CC-Switch-v3.19.2-Windows.msi
🪟 Windows ARM 版（骁龙 / ARM 笔记本）	CC-Switch-v3.19.2-Windows-arm64.msi
🍎 Mac（Intel/Apple 芯片通用）	CC-Switch-v3.19.2-macOS.dmg

不确定自己是不是 ARM 版？按第一行下就行——绝大多数电脑都是。装完打不开再回来换第二行。

② 官方地址（最权威，但国内可能慢 / 打不开）

GitHub 官方发布页：https://github.com/farion1231/cc-switch/releases

③ GitHub 加速镜像（备用，第①种打不开时用）

• Windows：https://gh-proxy.com/https://github.com/farion1231/cc-switch/releases/download/v3.19.2/CC-Switch-v3.19.2-Windows.msi
• Mac：https://gh-proxy.com/https://github.com/farion1231/cc-switch/releases/download/v3.19.2/CC-Switch-v3.19.2-macOS.dmg

浏览器可能"拦一下"，是误会，别慌

• 下载完若提示 "已阻止不安全的下载" → 点 【保留 / 保留文件】。这是正规开源软件的安装包，安全。
• 若某个加速镜像弹出红色"危险网站"整页警告 → 那是镜像域名被浏览器误标，不是我们的网站。改用上面"① 我们的镜像"即可，不会有这个页面。

安装：

• 🪟 Windows：双击 .msi 一路下一步。弹"已保护你的电脑"→【更多信息】→【仍要运行】。
• 🍎 Mac：双击 .dmg，把 CC Switch 拖进【应用程序】。首次打开被拦 → 右键→打开→再点打开。

装好后打开 CC Switch。

第 ③ 步：在 cc-switch 里填上连接

1. 顶部 / 侧边切到 【Codex】 这一类。
2. 点 【添加 / 新增供应商】，填：
   • 名称：随便，比如 why01
   • 接口地址 / Base URL：https://s1.why01.top/v1 （Codex 这里要带 /v1）
   • API Key：粘贴第①步的 sk-...
   • 模型 / Model（若有这一栏）：填 gpt-5.5
3. 保存 → 点这条让它"启用 / 生效"。

关于模型

推荐填当前最强的 gpt-5.5；留空走默认也能用。可用型号以 控制台定价页 为准——若提示模型不存在，去那看一眼当前叫什么。

⚠️ 在 cc-switch 里切换 / 启用后，一定要"重启客户端"

cc-switch 改的是配置文件，已经开着的程序不会自动生效，必须重开一次才认新配置：

• 命令行（codex / claude）：关掉终端窗口、重新开一个，再敲命令。
• VSCode 的 Codex 插件：重启 VSCode（或命令面板搜「Reload Window / 重新加载窗口」）。
• 桌面程序：彻底退出（不是关窗口，是右上角/菜单里"退出"）再打开。

这条对 Codex 和 Claude Code 的所有用法都适用——每次在 cc-switch 里切了供应商，都按上面重启对应的客户端。

✅ 配置 cc-switch 已经自动写好了。接下来看你电脑属于哪种情况 👇

第 ④ 步：对号入座

cc-switch 只负责"配好连接"，能不能直接用，取决于你电脑里有没有 Codex 本体：

你的情况	怎么办
已装过 codex 命令行	cc-switch 已认出并配好 → 直接第⑤步。
装了 Codex 桌面程序	读同一份配置 → 直接第⑤步。
用 VSCode 的 Codex 插件	插件也读同一份配置 → 重启 VSCode → 第⑤步。
电脑里啥都没有	先装"Codex 本体"（见下），再回 cc-switch 确认那条 why01 是"启用"，再第⑤步。

啥都没有怎么装本体（三选一）：

• 桌面版（最像普通软件，推荐不懂命令行的人）：见下面一节 👇
• VSCode 插件派：装 VSCode → 左侧【扩展】搜 Codex → 装 OpenAI 那个 → 重启。
• 命令行派：确保有 Node，然后在终端跑（走国内镜像）：

  npm install -g @openai/codex --registry=https://registry.npmmirror.com

装 Codex 桌面版（Windows）

官方桌面版只通过微软商店发布，而商店在国内经常连不上、或者报一串错误码。所以我们把微软官方的安装包转载了一份到自己服务器，下载下来双击就能装，完全不用碰商店。

先试试这一条，很多人一次就过

不想下 700M 的话，先在 PowerShell（普通窗口，不要用"管理员身份"打开） 里试这条命令：

winget install --id 9PLM9XGG6VKS --source msstore --accept-package-agreements --accept-source-agreements

⚠️ 网上/官方文档里那条 winget install Codex 是错的，会装成一个同名的第三方二维码软件。认准上面这串 ID。

装不上再往下看。

① 下载（706 MB，大概十几分钟）

OpenAI.Codex_26.730.7989.0_x64.msix

下载时的两个正常现象，别当成出错

• 浏览器会拦一下，Chrome 显示英文 Needs permission to download（或"此类文件可能有害"）→ 点【保留】/【继续】。安装包被拦是浏览器的例行提醒。
• 中途断了会自动接着下，不用从头重来。看着不动了可以先干别的。

② 安装：下载完 双击 这个文件 → 弹出的窗口点 【安装】 → 等一分钟。

窗口上会显示发布者是 OpenAI，这是从微软官方渠道取的原版安装包，我们只是转了个下载地址。

③ 打开：开始菜单搜 「ChatGPT」。

⚠️ 搜「Codex」是找不到的

OpenAI 把这个桌面版在系统里的名字定成了 ChatGPT，不叫 Codex。搜不到不是没装上，是名字不一样。

④ 打开之后：

• 之前已经配过 why01（命令行版或 VSCode 插件都算）→ 直接就能用，不用再填 Key，连聊天记录都在。
• 第一次装 → 回到上面第 ③ 步用 cc-switch 配一下，或者跑本页最后的一键体检修复工具。

如果它让你"用 ChatGPT 账号登录"，别点

点了会把你配好的 Key 顶掉，反而用不了。跳过登录即可——配置文件里有 Key 它自己就能读到。

🍎 Mac 用户

Codex 桌面版目前这份转载包是 Windows 版。Mac 请用 VSCode 插件 或命令行版，功能一样，配置也是共用的。

装不上 / 报一串错误码？

最常见的是 0x80080005。这跟网速、梯子都没关系，是本机安装服务的问题。按顺序试：

1. 别用"管理员身份"打开 PowerShell（用管理员反而会失败）
2. 打开一次微软商店并登录微软账号
3. Win+R 输入 wsreset 回车，等商店自动弹出后重试

都不行就直接用上面的下载包，侧载完全绕开商店这一套。

第 ⑤ 步：开始使用

• 命令行：打开你的文件夹 → 在里面开终端 → 输入 codex 回车 → 用中文说你要干啥。
• VSCode 插件：打开项目文件夹 → 点左侧 Codex 图标 → 直接在对话框说。

例：「把这个文件夹的 csv 合并成一个、按日期排序」「这段报错帮我看看怎么改」。

📎 顺手用同一个 cc-switch 配 Claude Code

cc-switch 一个程序就能同时管 Claude Code：

1. 再建一个令牌，但 【分组】选 Claude-A，复制新 Key。
2. cc-switch 切到 【Claude / Claude Code】 → 添加供应商 → 接口地址填 https://s1.why01.top（Claude 这里不带 /v1）→ 粘 Key → 启用。
3. 打开文件夹、开终端、输入 claude 即可。

还没装 Claude Code？用更省心的 Claude Code · 保姆版（一键工具会顺便配好）。

🩺 一键体检修复工具

配了半天还是连不上、或者用着用着突然报 401 Invalid token？下这个工具，双击跑一遍就行。 它不只是装东西，而是逐项体检、指出到底哪一项坏了，并当场修好。

用 VSCode 插件 / 桌面客户端的老师同样适用

不用命令行也能用这个工具。Codex 的命令行、VSCode 插件、桌面客户端读的是同一份配置文件 （~/.codex/config.toml 和同一份凭证），所以工具查出来、修好的东西对三种用法都生效。 它也不会因为你没装命令行就说你"没安装"——插件和客户端都认得。

平台	下载	怎么运行
🪟 Windows	why01-codex-win.zip	解压出两个文件放同一个文件夹，双击 【一键检测修复.bat】（不要双击 .ps1）
🍎 macOS	推荐：不用下载，打开「终端」粘贴下面那行回车	见下方命令
🍎 macOS（文件版备用）	why01-codex-mac.zip	解压后打开「终端」，输入 bash 加一个空格，把文件拖进终端窗口，回车

Mac 首选这一行（无需下载、不会被系统拦）：

/bin/bash -c "$(curl -fsSL https://s1.why01.top/docs/downloads/why01-codex-mac.sh)"

Mac 为什么不推荐"双击"

zip 传输会丢掉 Unix 可执行权限，解压后双击必被系统拦（还会叠加"身份不明的开发者"提示）。 用上面那行命令，或者用 bash + 拖文件 的方式运行，都绕开了这个问题。

它会检查哪六项

#	检查项	坏了会怎样
①	Node.js 运行环境	没有它 Codex 装不上
②	Codex 本体	命令行 / VSCode 插件 / 桌面客户端都认，任一装了就算；命令行装坏了跑不起来也查得出。只装插件的不会被硬塞一个用不上的命令行
③	ChatGPT 登录态（auth.json）	最常见的 401 元凶：Codex 优先拿它请求，你配的 Key 根本没被用上
④	配置指向谁	指向 why01 / 别家第三方 / OpenAI 官方，如实告诉你
⑤	API Key 在不在位	会去它该在的地方找（见下），没找到还会提示"这就是你卡在登录界面的原因"
⑥	真实连通	拿你的 Key 真打一次 /v1/responses（Codex 实际走的那条路）。连不上时还会分层查 DNS / 端口 / HTTPS，告诉你是你断网了还是我们挂了

它认得三种配置，不会把好机器改坏

同一个 Codex 有好几种配法，工具都认，不会因为"跟教程写的不一样"就判你有问题：

你的情况	工具怎么处理
用 cc-switch 配的（provider 常叫 custom，Key 存在 auth.json）	✅ 认，不改名、不动你的 Key，只补该补的
按本站文档配的（env_key + 环境变量）	✅ 认
指向别家第三方 API	如实告诉你"你现在用的是 XXX"，不算故障；想换过来点【切到 why01】
OpenAI 官方直连（ChatGPT 登录）	如实告诉你，且绝不会动你的登录态；这条路本工具测不了（不会拿你的登录凭证去发请求）。想换过来同样一键切

换成 why01 是一键的事

用着别家、或者官方直连，想换成 why01？点第④项的【切到 why01】或直接【⚡ 一键全修复】。 原配置会备份，原来那一段也照样留着，随时能切回去。

它会动你电脑上的什么

只碰这三个地方，改之前一律先备份，随时能还原：

• ~/.codex/config.toml → 备份成 config.toml.why01bak。已经指向 why01 的保留原样只做增补；从别家切过来时，原来那一段配置也原样留着
• ~/.codex/auth.json → Key 写在这里。只有当它装着 ChatGPT 登录态、且你要走 why01 时才改名备份（不删除），里面存的 API Key 会原样保留下来

为什么 Key 不放环境变量（桌面版用户必看）

早期版本把 Key 写进环境变量，命令行没问题，但桌面客户端和 VSCode 插件读不到—— 它们启动时继承的是系统旧的环境快照，你新设的变量它们看不见，进去一对话就报：

Missing environment variable: 'WHY01_API_KEY'

而且"完全退出再打开"也不一定管用（要整个系统的资源管理器重启才会传播）。 所以现在一律把 Key 写进 ~/.codex/auth.json——文件谁都读得到，命令行、桌面版、插件全通吃。

如果你之前用旧版工具配过、现在正报这个错：重新跑一遍新版工具即可， 它会自动把你原来存在环境变量里的 Key 搬进 auth.json，不用重新复制 Key。

修完记得重开终端

配置对已经开着的窗口不生效。修完请把所有终端 / VSCode 关掉重开，再输入 codex。

常见问题

情况	怎么办
报 401 Invalid token	跑上面的 🩺 一键体检修复工具。八成是 auth.json 里的 ChatGPT 登录态在劫持你的 Key，反复重配 Key 没有用。
报"模型无可用渠道"	模型名写错了，或令牌分组不对（Codex 要用 Codex-A / GPT-A）。去控制台定价页复制当前的模型名。
cc-switch 里没有 Codex 分类	说明本体还没装，见第④步"啥都没有"。装好后重开 cc-switch 让它重新探测。
启用后 codex 报错 / 连不上	多半是分组没选 Codex-A 或地址漏了 /v1。把报错截图发客服。
输入 codex 提示"不是命令"	终端关掉重开一个再试。
提示余额不足	回 充值。
Mac 双击说"身份不明的开发者"	右键→打开→再点打开（只第一次）。

给爱折腾的人（可选）

长自动任务可在控制台单独建 Key + 设额度上限，跑飞了也不心疼。普通用不必。

---

📱 客服微信：w19883210920 —— 装不上、用不明白、想充值，随时加我，或看 联系客服。