Codex · 保姆版

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

不想要"保姆版"？

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

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 64位	CC-Switch-v3.16.2-Windows.msi
🍎 Mac（Intel/Apple 芯片通用）	CC-Switch-v3.16.2-macOS.dmg

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

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

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

• Windows：https://gh-proxy.com/https://github.com/farion1231/cc-switch/releases/download/v3.16.2/CC-Switch-v3.16.2-Windows.msi
• Mac：https://gh-proxy.com/https://github.com/farion1231/cc-switch/releases/download/v3.16.2/CC-Switch-v3.16.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 → 左侧【扩展】搜 Codex → 装 OpenAI 那个 → 重启。
• 命令行派：确保有 Node，然后在终端跑（走国内镜像）：

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

第 ⑤ 步：开始使用

• 命令行：打开你的文件夹 → 在里面开终端 → 输入 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 · 保姆版（一键工具会顺便配好）。

常见问题

情况	怎么办
cc-switch 里没有 Codex 分类	说明本体还没装，见第④步"啥都没有"。装好后重开 cc-switch 让它重新探测。
启用后 codex 报错 / 连不上	多半是分组没选 Codex-A 或地址漏了 /v1。把报错截图发客服。
输入 codex 提示"不是命令"	终端关掉重开一个再试。
提示余额不足	回 充值。
Mac 双击说"身份不明的开发者"	右键→打开→再点打开（只第一次）。

给爱折腾的人（可选）

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

---

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