安装客户端

Codex 安装指南

普通用户先安装 Codex App；习惯终端或使用 Linux 时安装 Codex CLI。需要管理小贺 API 等自定义接口时，再安装 CC Switch。本文把三者分开讲，并提供当前最新版下载入口。

阅读约 8 分钟更新于 2026-08-17第 2 章

01.

先分清要安装的三个东西

两篇参考文章把 Codex App、Codex CLI 和 CC Switch 放在一条流程里讲，容易让新手以为它们是同一个软件。实际安装前先按你的使用方式选择，没必要三个都装。

普通用户优先

Codex App

Windows 和 macOS 的图形界面客户端，适合从项目、文件和可视界面开始使用。

Codex CLI

在 PowerShell、Terminal 或 Linux Shell 中运行，适合命令行和自动化工作流。

按需安装

自定义 API 用户

CC Switch

它只负责管理和切换 API 配置，不是 Codex，也不提供模型能力。

可选

只使用 ChatGPT 账号时，安装 Codex 后直接登录即可；需要使用小贺 API、管理 Base URL 或切换多个供应商时，再安装 CC Switch。

02.

安装 Codex App

OPENAI 官方入口

下载最新版 Codex App

适用于 Windows 和 macOS。下载后先核对发布者为 OpenAI，再完成安装。

打开官方安装页

1
Windows
从官方 Codex 页面选择 Windows 安装入口，运行安装包。不要在 Microsoft Store 里随便安装名称相似的第三方应用。
2
macOS
从官方页面下载当前 DMG，打开后把 Codex 拖入 Applications，再从“应用程序”启动。
3
第一次打开
按界面选择 ChatGPT 登录；如果准备使用 API，则先完成 App 安装，再继续第 4、5 节。

03.

终端用户安装 Codex CLI

版本核对：2026-08-11官方 npm 包 0.147.0安装命令使用 latest 或官方脚本，后续会自动获取当时最新版

Linux 用户、习惯终端的用户，或者需要脚本化工作流时再安装 CLI。四种方式只选一种，避免 PATH 中同时出现多个 Codex。

Windows · PowerShell

官方 PowerShell 安装脚本

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

macOS / Linux · Terminal

官方 Shell 安装脚本

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows / macOS / Linux

使用 npm 安装最新版

npm install -g @openai/codex@latest

macOS

使用 Homebrew 安装

brew install --cask codex

CLI 安装后检查

确认版本并启动

codex --version
codex

Windows 提示无法加载 npm.ps1：把 npm 改成 npm.cmd，运行 npm.cmd install -g @openai/codex@latest，不用永久放开 PowerShell 执行策略。

04.

安装最新版 CC Switch

最新 Releasev3.19.2发布于 2026-08-06，核对于 2026-08-11

两篇参考文章使用的 v3.15.0 已经过期。下面是当前最新版的官方 GitHub Release 资源；不知道架构时，普通 Intel / AMD Windows 电脑选择 Windows x64。

Windows x64CC-Switch-v3.19.2-Windows.msiIntel / AMD 电脑，约 12.5 MB下载安装 Windows ARM64CC-Switch-v3.19.2-Windows-arm64.msiSnapdragon 等 ARM 电脑，约 11.8 MB下载安装 macOSCC-Switch-v3.19.2-macOS.dmg当前 macOS 安装镜像，约 25.9 MB下载安装 Linux x86_64CC-Switch-v3.19.2-Linux-x86_64.AppImage通用 AppImage，约 87.6 MB下载安装

始终查看最新版本查看 v3.19.2 发布说明

05.

用 CC Switch 配置小贺 API

先在小贺 API 控制台创建自己的 API Key。控制台如果提供“导入 CCS”入口，优先一键导入；没有入口或导入失败时，再按下面字段手动新建 Codex Provider。

小贺 API 控制台创建 Key、查看当前接入说明和可用模型不要把完整 API Key 发到公开文章、截图或聊天记录里。

打开控制台

1
创建 API Key
登录小贺 API，在控制台创建专用 Key。复制时不要带前后空格，也不要与其他项目共用长期 Key。
2
优先导入 CCS
如果控制台显示 Codex / CC Switch 的导入按钮，点击后允许浏览器唤起 CC Switch，并核对导入的 Provider。
3
手动配置备用
在 CC Switch 选择 Codex，新建 Provider，填入 API Key 与下方 Base URL；模型字段以控制台当前说明为准。
4
切换并重启
把新 Provider 切换为当前 Codex 配置，完全退出正在运行的 Codex App 或 CLI 会话，再重新打开。

CC Switch · Base URL

小贺 API OpenAI 兼容地址

https://api.xiao-he.top/v1

本站已用未携带凭证的请求确认 /v1/models 会返回“需要 API Key”，说明该 API 边界在线；这不代表你的 Key、余额或模型权限已经通过，仍要在自己的账户里完成一次真实验证。

06.

登录、中文界面、权限与第一次验证

路线 A

使用 ChatGPT 账号

启动 Codex 后选择 Sign in with ChatGPT，在浏览器完成登录，再回到 App 或终端。

路线 B

使用 API 配置

先在 CC Switch 激活目标 Provider，再完全重启 Codex。不要一边登录官方账号、一边判断自定义 API 是否生效。

切换中文：国内用户请先开启代理工具并切换到全局模式，再进入 Settings → General → Language 选择简体中文并重启；部分情况下，开启代理后 App 会自动切换为中文。

安装 Skills 前先开权限：首次使用时，先进入 Settings → General（设置 → 常规），在“权限”区域开启“完整访问权限”；然后回到对话框，从权限菜单切换为“完全访问”。否则下载文件、写入 Skill 目录或联网获取安装源时可能失败。完全访问会放开本地沙箱限制，只对确认过来源的 Skill 临时开启，安装完成后可切回默认权限。

发给 Codex

安装常用 Skills 测试

请使用 $skill-installer 帮我安装一组适合日常工作的常用 Skills。先列出候选 Skill 的名称、用途、来源和需要的权限，优先选择官方精选或可信来源，并覆盖网页操作、文档、PDF、表格、演示文稿和图片处理；等我确认后再安装。安装完成后逐个检查是否能被 Codex 识别，并给出调用示例；不要安装来源不明或功能重复的 Skill。

App 能打开，或 CLI 能输出 codex --version
当前登录方式或 CC Switch Provider 与计划使用的路线一致
设置中已开启“完整访问权限”，当前对话已切换为“完全访问”
Codex 会先列出候选 Skills、用途与来源，确认后再安装并逐个验证

401 / 未提供 API Key

检查 Key 是否完整、是否放在当前 Provider，以及 CC Switch 是否真的切换到了该配置。

404 / 模型不存在

不要照抄旧文章里的模型名。回到小贺 API 控制台核对当前可用模型和 Provider 字段。

切换后没有变化

保存和切换配置后，完全退出 Codex 再打开；只关闭一个任务窗口可能不会重新读取配置。

Windows · PowerShell

CLI 找不到命令时检查路径

Get-Command codex -All

macOS / Linux

CLI 找不到命令时检查路径

type -a codex

核对来源：OpenAI Codex 官方安装页、OpenAI Skills 文档、OpenAI 权限文档、官方 npm 包 @openai/codex 0.147.0、CC Switch Latest Release，以及用户提供的两篇实操文章。版本与下载链接核对于 2026-08-11；Skills 与权限说明核对于 2026-08-15。