Codex / GPT 安装配置教程

零基础上手（Mac / Windows）。哪怕你从没用过“终端”，照着复制粘贴也能把 OpenAI 的 Codex 跑起来，接入 dolinx 用上 GPT。

Codex 有三种用法，配置方法相同：
① 命令行（CLI）：在终端里运行 codex；
② 在 IDE 里用：在 VS Code / Cursor / Windsurf 里装 Codex 扩展，或直接用内置终端跑 codex；
③ Codex 桌面客户端：OpenAI 官方桌面 App，读取同一个 config.toml。
⚡推荐

一键脚本，30 秒完成接入

先做下面第 ② 步拿到 API Key，再把密钥替换进下面这行命令执行。脚本会自动装好 Node 和 Codex、写好 config.toml、auth.json 与环境变量，替代 ① ③ ④ 三步；已装会自动跳过，重复运行安全。 

# mac
curl -fsSL https://dolinx.com/install.sh | bash -s -- --codex-key sk-你的Codex密钥
装完后如果 codex 跳到 ChatGPT 登录页，执行 codex logout 后重新运行一次脚本。脚本详情见 接入文档 STEP 0；想手动理解每一步，就按下面的教程继续。

终端是什么

“终端”（也叫命令行、Terminal、PowerShell）是一个能输入文字命令操作电脑的小窗口。安装和启动 Codex 就是在里面粘贴几行命令、按回车。你不需要懂编程，会复制、粘贴、回车就够了。

复制粘贴小提示：Mac 用 Command + V，Windows 用 Ctrl + V 或鼠标右键粘贴，然后按回车执行。

怎么打开终端

Mac：按 ⌘ + 空格 打开 Spotlight，输入“终端”（或 Terminal）回车。
Windows：点开始菜单，输入 PowerShell，点击 Windows PowerShell 打开。

① 安装 Codex

Codex 是 OpenAI 官方命令行工具，用 npm 安装最通用（Windows 也一样）。前提是先装 Node.js（一路下一步即可）。装好后在终端运行：

npm install -g @openai/codex

Mac 也可以用 Homebrew：brew install codex。装好后输入 codex --version 显示版本号即成功（若提示找不到命令，关掉终端重开一个再试）。

② 获取 API Key

API Key 是一串密码，Codex 用它证明“是你在用”。步骤：

  1. 打开 dolinx 控制台 注册 / 登录。
  2. 进入控制台「API密钥」页面，点「创建密钥」。
  3. 复制以 sk- 开头的密钥。
这串 sk- 密钥相当于密码，别发给别人，也别贴到公开仓库、截图或群聊里。

③ 编辑配置文件 config.toml

Codex 用一个叫 config.toml 的文件记住“该连哪里”。位置：Mac / Linux 是 ~/.codex/config.toml，Windows 是 %USERPROFILE%\.codex\config.toml。没有就新建一个，把下面这段粘进去保存（两个系统内容相同）：

model = "gpt-5.5"
model_provider = "dolinx"

[model_providers.dolinx]
name = "dolinx"
base_url = "https://api.dolinx.com/v1"
wire_api = "responses"
requires_openai_auth = true

其中 requires_openai_auth 表示 Codex 会从 ~/.codex/auth.json 文件里读你的密钥，下一步创建它。

（项目级覆盖也支持：在项目根目录建 .codex/config.toml，只对当前项目生效。）

不知道怎么编辑这个文件？
Mac：先运行 mkdir -p ~/.codex && touch ~/.codex/config.toml，再运行 open -e ~/.codex/config.toml。
Windows：先运行 mkdir $env:USERPROFILE\.codex -ErrorAction SilentlyContinue，再运行 notepad $env:USERPROFILE\.codex\config.toml，弹出“是否新建”时点是。

④ 写入 API Key（auth.json）

注意：这一步是在终端里做的，不是继续写进 config.toml。上一步如果打开了记事本 / 编辑器，请先保存并关闭，再回到终端执行下面的命令。
Key 写在 ~/.codex/auth.json 文件里，一次写好即可：命令行、IDE 扩展、桌面 App 都读这个文件，不依赖环境变量，也不用重启终端。

Mac / Linux（把 sk-*** 换成你的密钥）：

echo '{ "OPENAI_API_KEY": "sk-***" }' > ~/.codex/auth.json

Windows（PowerShell）：

'{ "OPENAI_API_KEY": "sk-***" }' | Set-Content $env:USERPROFILE\.codex\auth.json

不习惯命令行的话，也可以用记事本 / 编辑器直接在 .codex 文件夹里新建 auth.json，内容就是上面引号里那一行 JSON。

⑤ 开始使用（三种用法）

下面三种用法任选其一——它们共用上面同一套 config.toml（包括 Codex 桌面客户端）。

用法一：命令行（CLI）

③④ 两个文件保存好后直接运行即可，不需要重启终端。
cd ~/your-project
codex
# 或一句话直接开干：
codex "帮我重构这个模块并补上测试"

进入对话后常用：/model 切换模型、/approvals 调整审批方式、codex resume 继续上次会话。

用法二：在 IDE 里使用（VS Code / Cursor / Windsurf）

在编辑器里用 Codex 有两种方式，任选其一。

方式 A：装 Codex 官方扩展。它和命令行共用同一个 ~/.codex/config.toml，所以你按上面 ③④ 配好后，扩展里也会直接生效。

  1. 按 ⌘/Ctrl + Shift + X 打开扩展商店，搜索 Codex（发布者 OpenAI）安装。
  2. 也可以在终端运行 code --install-extension openai.chatgpt 手动安装。
  3. 它和命令行共用同一个 ~/.codex/config.toml，所以配好后扩展里直接生效。
  4. 不想装扩展也行——直接在 IDE 的内置终端运行 codex，和命令行一样。
Cursor / Windsurf 也可以装同一个扩展。配置都在文件里（config.toml + auth.json），扩展启动时直接读取；若 IDE 在你配置之前就开着，完全退出再重开一次即可。

用法三：在 Codex 桌面客户端中使用

如果你想使用 Codex 桌面应用（Mac / Windows 的独立 App），可以从 OpenAI 官方 Codex App 页面 下载；Windows 也可以直接点 OpenAI 官方 Windows 下载链接 安装。

桌面客户端没有单独的“填网关”界面，它和 CLI / 扩展共用同一个 ~/.codex/config.toml。所以只要做完 ③④，打开桌面客户端它就会自动读到 dolinx，无需在 App 里再配。

  1. 下载安装并打开 Codex 桌面应用。
  2. 确认 ~/.codex/config.toml 里写了 model_provider = "dolinx"，且 ~/.codex/auth.json 里已写入你的 sk- 密钥。
  3. 选一个项目文件夹，开始对话即可。
桌面客户端注意点：
密钥在 auth.json 文件里，从 Dock / 开始菜单启动也能读到，不存在环境变量继承问题。
用自定义 provider 时，App 里的模型下拉框可能显示不全，实际模型以 config.toml 里的 model = 为准。
如果一直 401，多半是之前 ChatGPT 登录的残留：先运行 codex logout（此操作会清空 auth.json），再按第④步重新写入 auth.json，然后重开 App。

遇到问题怎么办

现象怎么解决
codex: command not found没重开终端，或 Node.js 没装好。重开终端；必要时重装 Node.js。
提示 401 / 未授权密钥没设对。打开 ~/.codex/auth.json 检查 Key 是否正确、是否以 sk- 开头、复制时有没有多空格，保存后重新运行 codex。
找不到 provider / 模型检查 config.toml 是否保存成功、缩进与字段拼写是否和上面一致。
一直转圈 / 超时确认 base_url 是 https://api.dolinx.com/v1（注意结尾 /v1）。
改了配置没生效config.toml / auth.json 保存后重新运行 codex；桌面 App 需要完全退出再重开。
桌面应用一直 401多半是之前 ChatGPT 登录的残留。先运行 codex logout（会清空 auth.json），再按第④步重新写入 auth.json 后重开。

FAQ · 还有其他Codex相关问题？

config.toml 到底放哪个目录？+

Mac / Linux 放在 ~/.codex/config.toml，Windows 放在 %USERPROFILE%\.codex\config.toml。没有 .codex 文件夹就新建一个，文件名必须是 config.toml。（项目级覆盖也支持：在项目根目录建 .codex/config.toml，只对当前项目生效。）

base_url 后面到底要不要带 /v1？+

Codex 走 OpenAI 兼容接口，base_url 要写 https://api.dolinx.com/v1。少了 /v1，常见表现是一直转圈、超时或找不到接口。

为什么 Codex 一直跳 ChatGPT 登录页，不读我的 Key？+

通常是之前用 ChatGPT OAuth 登录过，Codex 优先走旧登录状态。先运行 codex logout（此操作会清空 auth.json），再重新运行一键安装脚本或按第④步重写 auth.json，然后再启动。

approval mode、slash commands、MCP 还能用吗？+

能用。approval mode、slash commands、MCP、文件 patch 等主要是 Codex 客户端本地能力，dolinx 只负责把模型请求转到兼容接口，不会把这些功能关掉。

Codex、Claude Code、Cline、Cherry Studio 能不能用同一个 Key？+

可以。同一把 sk- Key 可以给多个支持自定义 Base URL 的客户端使用。Codex、Cline、Cherry Studio 这类 OpenAI 兼容工具通常填 https://api.dolinx.com/v1；Claude Code 按教程里的 Anthropic 配置填写。

相关教程