这篇教程记录一下如何在 Windows 10/11 下安装 OpenAI Codex CLI，并通过 CC Switch 管理 Codex、Claude Code、Gemini CLI 等 AI 编程工具的供应商配置。适合想在本地终端里使用 Codex，又希望用图形化方式切换 API 配置的用户。
提示：Codex 是 OpenAI 的本地编程代理工具；CC Switch 是第三方配置管理工具，不是 OpenAI 官方产品。涉及 API Key 时请注意安全，不要把密钥发给陌生人或写进公开仓库。
开始前建议准备好以下内容：
Windows 10 或 Windows 11
PowerShell 或 Windows Terminal
Node.js LTS 版本，建议 Node.js 18 或更高
OpenAI ChatGPT 账号，或 OpenAI API Key
如果要使用第三方中转服务，需要对应服务商提供的 Base URL 和 API Key
Codex CLI 和 CC Switch 管理的部分命令行工具依赖 Node.js 环境。先打开 Node.js 官网下载 LTS 版本安装包。
Node.js 官网：
https://nodejs.org/
安装完成后，打开 PowerShell，输入下面命令检查是否安装成功：
node --version
npm --version
如果能看到版本号，就说明 Node.js 和 npm 已经安装完成。
Codex 官方目前提供了 Windows PowerShell 一键安装命令。打开 PowerShell，运行：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
如果你更习惯 npm，也可以使用 npm 全局安装：
npm install -g @openai/codex
安装完成后输入：
codex --version
如果能看到版本号，说明 Codex CLI 已经安装成功。
继续在 PowerShell 中输入：
codex
首次运行时，Codex 会引导你登录。推荐选择使用 ChatGPT 账号登录，这样可以直接使用你当前 ChatGPT 方案内包含的 Codex 权益。
如果你是 API 用户，也可以使用 API Key 方式配置，不过新手更推荐先用 ChatGPT 登录方式跑通。
CC Switch 是一个跨平台桌面工具，可以用图形化界面管理 Claude Code、Codex、Gemini CLI、OpenCode 等工具的供应商配置。Windows 用户推荐下载 MSI 安装包。
下载地址：
https://github.com/farion1231/cc-switch/releases
Windows 下通常选择类似下面名称的文件：
CC-Switch-v版本号-Windows.msi
下载后双击安装即可。如果 Windows SmartScreen 提示未知应用，确认你是从 GitHub Releases 官方项目页下载后，再选择继续运行。
打开 CC Switch 后，按下面步骤配置 Codex：
左侧切换到 Codex 标签页。
点击 Add Provider 或添加供应商。
选择 Custom 自定义配置。
填写供应商名称、Base URL、API Key、默认模型。
保存后点击 Activate 激活。
如果你使用的是官方 OpenAI 账号登录 Codex，通常不需要通过 CC Switch 改配置，直接运行
codex 即可。如果你使用第三方 OpenAI 兼容接口，则可以按服务商给你的信息填写。
配置项
填写内容
Provider Name
自定义名称，例如 my-provider
Base URL
服务商提供的 OpenAI 兼容接口地址
API Key
你的 API Key
Default Model
服务商支持的模型名称
保存并激活后，CC Switch 会把配置写入 Codex 的配置目录。Windows 下通常对应：
C:\Users\你的用户名\.codex\
回到 PowerShell，进入一个项目目录，例如：
cd D:\my-project
codex
进入 Codex 后，可以输入一个简单任务测试：
帮我分析这个项目的目录结构，并说明入口文件在哪里。
如果 Codex 能正常读取项目并回答，说明安装和配置已经完成。
一般是 PATH 没生效。先关闭 PowerShell，重新打开再试。如果还是不行，检查 npm 全局目录是否加入了系统 PATH。
npm config get prefix
优先检查 Base URL、API Key、模型名称是否填写正确。很多第三方接口对路径比较敏感，Base URL 末尾是否带斜杠也可能影响识别。
这通常是 API Key 错误、过期、复制时多了空格，或者当前接口不支持你填写的模型。重新复制密钥，并确认服务商后台额度正常。
CC Switch 属于第三方桌面工具，部分版本可能被 SmartScreen 提示。只建议从项目 GitHub Releases 下载，不要从不明网盘或陌生群文件安装。
如果只是想正常使用 Codex，最简单的方式是：安装 Codex CLI，然后直接用 ChatGPT 账号登录。
如果你经常在不同 API 服务商之间切换，或者同时使用 Claude Code、Codex、Gemini CLI，那么 CC Switch 会更方便，因为它能用图形界面管理多个配置，不用手动改配置文件。
文章评论