DAL · 从 Node.js 到 Codex

给新手的 Codex 安装与激活教程

这里分成两类:如果你用 Codex CLI,直接跑一键命令; 如果你用微软商店下载的 Codex App,只需要运行激活器并输入 API Key

你只需要准备自己的 API Key。如果你手里还没有,请先问管理员要。

开始前,先确认这 2 件事

  • 你能打开命令行,或者知道怎么打开 cmd / PowerShell / 终端。
  • 你已经拿到了自己的 API Key
Codex CLI 一条命令自动装好 Node.jsCodex 和激活器
Codex App 微软商店装好 App 后,只跑激活器就行
配置自动写入 激活器会自动写入 config.tomlauth.json
默认模型 默认使用 gpt-5.5xhigh 推理强度和 fast 服务层级

先选你在用哪一种

A. Codex CLI 适合命令行用户。没装 Node.js 也没关系,直接走一键安装。

查看 CLI 教程

B. Codex App 适合图形界面用户。先去微软官方商店安装 Codex App,再运行激活器。

查看 App 教程

Codex App 用户

如果你使用的是微软官方商店下载的 Codex App,这条线更简单。装好 App 后,不用再装 Codex CLI

1. 在微软官方商店搜索并安装 Codex App

2. 运行激活器
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://cpa.dongailin.cn/downloads/activate-codex.ps1 | iex"

3. 按提示输入你的 API Key
如果你还没有 API Key,请先问管理员要

4. 打开 Codex App 开始使用

1CLI 用户复制并运行这一条命令

在 Windows PowerShell 里直接运行下面这条命令。它会自动允许当前用户运行本地脚本、检查并安装 Node.js、安装 Codex,然后启动激活器。

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://cpa.dongailin.cn/downloads/install-codex.ps1 | iex"
正常情况下,你不需要先单独装 Node.js,也不需要手动运行 Set-ExecutionPolicy,这条命令会自动处理。

2输入你的 API Key

脚本跑起来以后,终端会提示你输入 API Key。把你的 key 粘贴进去,回车即可。没有的话,先问管理员要。

Paste your API Key (ask admin if you don't have one): xxxxxxxxxxxxxxxxxxxx

这里不需要你自己手动打开配置文件,脚本会自动处理。

3等待自动配置完成

脚本会自动检查并写入这两个文件。你不需要自己创建,也不需要自己复制内容。

一键命令会自动检查并写入这两个文件,默认配置为 gpt-5.5xhighfast
%USERPROFILE%\.codex\auth.json
%USERPROFILE%\.codex\config.toml

4运行并确认成功

看到安装完成提示后,直接运行 codex。能正常进入交互界面,基本就说明接入成功了。

codex

# 如果想临时切模型
codex -m gpt-5.5

如果当前窗口里暂时找不到 codex,重新打开一次命令行再试。

最容易卡住的 4 个地方

  • 如果一键命令执行失败,先确认整条命令有没有复制完整;脚本会自动执行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force
  • 如果你是 Codex App 用户,不需要先装 Codex CLI,直接跑激活器就行。
  • 如果脚本运行结束后 .codex 里还是没有 auth.jsonconfig.toml,说明自动配置没有成功。
  • 如果粘贴进去的 API Key 不对,启动时会报鉴权错误。
  • 如果模型名报错,可以再看 https://cpa.dongailin.cn/v1/models 当前可用列表。

如果你完全不知道文件在哪

不用慌,先记住一件事:你只需要找到你自己电脑上的 .codex 文件夹。

  • Windows 一般在:%USERPROFILE%\.codex\
  • macOS / Linux 一般在:~/.codex/
  • Windows 里 %USERPROFILE% 就表示“你当前登录用户自己的目录”。
  • 里面最关键的就是这两个文件:config.tomlauth.json
对新手来说,先只做“一键命令 + 输入 API Key + 运行 codex”这条最短路径,其他内容都可以后面再学。

如果一键命令失败,再看备用方案

备用方案就是分开做三件事:先装 Node.js,再装 Codex,最后单独运行激活器。没有 API Key 的话,先问管理员要。

1. Node.js 官网
https://nodejs.org/zh-cn

2. 安装 Codex
npm install -g @openai/codex

3. 允许当前用户运行本地脚本
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force

4. 运行激活器
npm exec --yes --package=https://cpa.dongailin.cn/downloads/dal-codex-activator-1.0.2.tgz -- dal-codex-activate