支持平台：

WindowsmacOS

下载地址：

https://openai.com/zh-Hans-CN/codex

桌面版更适合这几类人：

不想碰太多命令更习惯图形界面想先快速体验一下主要是轻量使用，不一定深度集成到开发流程里

如果你只是想先看看 Codex 到底能不能用，桌面版会更省事。

六、插件版安装

如果你常用 VS Code 或其他 IDE，那插件版也值得装。

安装方式很简单：

打开 IDE 插件市场搜索 Codex点击安装登录 ChatGPT 账号，或者使用中转站方案接入

这种方式的好处是：

写代码时不用来回切窗口直接在编辑器里交互更适合日常开发流

如果你本来就习惯 AI 插件协作写代码，那这一套几乎没有学习成本。

3 种登录 / 接入方式详解

下面进入重点。

装完之后，怎么真正用起来？

七、方式 1：GPT 账号直接登录

这是最适合新手的方案。

打开终端，输入：

Bash

codex

然后你就可以直接选择 GPT 账号登录。

如果你本身已经是 Plus 用户，这一步通常是最顺的。

不用额外折腾配置，也不用先研究各种 API 参数。

适合人群：

已有 ChatGPT Plus / Team / Pro只想尽快用起来不想先折腾配置文件

如果你只是想先体验 Codex，到这里通常就够了。

八、方式 2：CC Switch 中转站

如果你不想完全依赖官方登录，也可以走 CC Switch 中转站 的方案。

文中给的流程是这样的：

8.1 先准备中转站

比如示例里提到的付费中转站：

https://unity2.ai/register?ref=CdWzuhIw

8.2 打开 CC Switch

进入 Codex 图标选项卡，然后点击右上角 加号 新建供应商。

8.4 终端测试

配置完成后，打开终端输入：

BASH codex

进去之后可以先随便打个招呼，看看能不能正常响应。

如果能正常返回内容，说明接入成功。

九、方式 3：自定义配置文件 中转站

这个方案更适合喜欢自己控全局的人。

核心就是编辑 Codex 的全局配置文件：

BASH

~/.codex/config.toml

文中的示例配置如下：

TOML model_provider = "unity2.ai"

model = "gpt-5.4"

model_reasoning_effort = "high"

disable_response_storage = true

personality = "pragmatic"

model_providers.unity2.ai]

name = "unity2.ai"

base_url = "https://unity2.ai/v1"

wire_api = "responses"

requires_openai_auth = true

env_key = "my_key"

9.1 这几个字段怎么理解？

简单解释一下：

model_provider：你当前使用的供应商名称model：指定模型，例如 gpt-5.4，也可以换成别的可用模型model_reasoning_effort：推理强度disable_response_storage = true：关闭响应存储personality = "pragmatic"：输出风格偏务实

而下面这段：

TOML

[model_providers.unity2.ai]

就是在定义这个供应商的详细配置，包括：

base_url接口类型是否需要认证使用哪个环境变量读取密钥

其中最关键的两个点：

base_url一般要带 /v1env_key要和你后面设置的环境变量名保持一致

十、API Key 怎么设置？

配置完 config.toml 后，还要把密钥准备好。

文中给了两种方式。

10.1 方式一：终端里设置环境变量

临时生效：

BASH

export my_key="sk-你的API密钥"

永久生效：

BASH

echo 'export my_key="sk-你的API密钥"' >> ~/.zshrc

source ~/.zshrc

如果你是 Windows PowerShell，则可以这样写：

POWERSHELL

$env:my_key="sk-你的API密钥"

10.2 方式二：写到认证文件里

你也可以直接编辑：

BASH ~/.codex/auth.JSON

内容类似这样：

JSON { "my_key": "sk-你的API密钥" }

这两种方案怎么选？

想简单测试：用环境变量想长期固定使用：写到配置文件里更省事

十一、插件版怎么测试是否正常？

插件装完、登录或配置完成后，建议你做一个最小测试：

打开 IDE呼出 Codex 插件输入一个简单请求看是否能正常响应

如果插件能返回结果，说明整条链路已经通了。

十二、几个容易踩坑的点，提前说清楚

这部分建议你收藏一下，真的很容易出问题。

1，Node 版本太低

很多安装失败、命令跑不起来，根本原因不是 Codex 本身，而是 Node 版本太老。

2，npm 镜像没配好

如果你网络环境一般，装包慢、超时、失败都很常见。 先换镜像，再装，会省很多事。

3，base_url 少了 /v1**

这是典型小坑。 配置中转站时，如果地址没写完整，很容易请求失败。

4，env_key 和环境变量名对不上

比如你配置里写的是：

TOML env_key = "my_key"

那你环境变量就得真叫 my_key，不能写成别的。

5，Windows、macOS、Linux 命令别混用

文里同时给了 Bash 和 PowerShell 写法。

你照自己系统选，不要一股脑全复制过去。

十三、最后总结一下

如果你最近正好遇到这些问题：

Claude Code 官方账号不稳定 中转站不好用 想找一个新的 AI 编程入口 已经有 ChatGPT 付费会员

那 Codex 确实值得你试一下。

它不是那种“装一堆东西还不一定能跑”的路线， 只要你把环境、登录方式、配置逻辑捋顺，整体上手并不难。

这篇你完全可以按下面顺序来操作：

先确认自己有没有 ChatGPT 付费资格 安装 Node.js 安装 Codex CLI 优先试直接登录 如果有需要，再折腾 CC Switch 或配置文件 最后在终端 / 插件里做一次最小测试