DAL · GPT-5.6 Sol

Codex 安装与激活教程

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

先选你用哪一种 看手动安装备用方案 用户后台：查看用量与下次重置
你只需要准备自己的 API Key。如果你手里还没有，请先问管理员要。

开始前，先确认这 2 件事

  • 你能打开命令行，或者知道怎么打开 cmd / PowerShell / 终端。
  • 你已经拿到了自己的 API Key。
Codex CLI 一条命令自动装好 Node.js、Codex、激活器和 CPA 生图 Skill
Codex App 微软商店装好 App 后，只跑激活器就行
配置自动写入 激活器会自动写入 config.toml 和 auth.json
CLI 图片生成 在 Codex 会话里使用 $cpa-imagegen，明确由 CPA 处理图片请求

先选你在用哪一种

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

查看 CLI 教程

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

查看 App 教程

Codex App 用户

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

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

2. 在 PowerShell 中运行激活器
irm https://cpa.dongailin.cn/downloads/activate-codex.ps1 | iex

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

4. 打开 Codex App 开始使用

Codex 用量助手

自动识别 CPA / 官方账号，在托盘或悬浮卡片查看已用、剩余和重置时间，无需修改 Codex。

下载 Windows 版 · 0.1.3 169 KB · Win10 / 11

解压运行 Install.cmd → 填写 CPA 地址和 Key → 点击托盘查看。默认开机自启，右键可设置常驻显示。首次安装需联网。

官方统计需管理员开通，金额为 CPA 价格估算。升级重新运行安装；卸载运行 Uninstall.cmd。

仍需 App 内摘要入口？旧版注入扩展（不推荐新用户）

1选择 CLI 安装方式

安装器每次都会从官方 npm 源获取最新稳定版 Codex CLI，并在完成后显示实际版本。2026-09-08 核对版本：0.153.4（官方更新记录）。

推荐安装（兼容性更好）

一键安装使用配置模板 1.0.12，同时安装全局协作规则。已有 AGENTS.md 会先备份，再更新 DAL 规则区块，保留个人内容。

打开 Windows PowerShell，完整复制并运行下面这条命令。它会先把安装器保存到 Windows 临时目录，再使用当前正在运行的 PowerShell 本地执行，因此同时兼容 PowerShell 7 和旧版 Windows PowerShell：

$dalInstaller = "$env:TEMP\dal-install-codex.ps1"; curl.exe -fL --retry 2 --connect-timeout 15 "https://cpa.dongailin.cn/downloads/install-codex.ps1" -o "$dalInstaller"; if ($LASTEXITCODE -ne 0) { throw "安装脚本下载失败" }; $dalPowerShell = (Get-Process -Id $PID).Path; & $dalPowerShell -NoProfile -ExecutionPolicy Bypass -File "$dalInstaller"
正常情况下，你不需要先单独安装 Node.js。安装器会自动处理 Node.js、Codex、CPA 配置和 $cpa-imagegen Skill。
其他安装方式（快速命令 / 浏览器手动下载）

快速命令

已经看到 PS> 提示符，并且当前系统允许在线脚本直接执行时，可以使用这条短命令：

irm https://cpa.dongailin.cn/downloads/install-codex.ps1 | iex
不要在这条命令前再添加 powershell。如果系统策略阻止在线执行，改用上面的推荐安装或浏览器手动下载即可。

浏览器手动下载

如果 PowerShell 无法联网下载，可先用浏览器保存安装脚本，检查后再使用当前 PowerShell 运行。

下载 Codex 安装脚本

已安装用户：只更新 CLI

先结束正在运行的 CLI 会话，再在 PowerShell 中运行下面的命令。它会更新一键安装使用的 Codex CLI，保留已有 API Key、模型配置和 Skill，无需重新激活。

$dalInstaller = "$env:TEMP\dal-install-codex.ps1"; curl.exe -fL --retry 2 --connect-timeout 15 "https://cpa.dongailin.cn/downloads/install-codex.ps1" -o "$dalInstaller"; if ($LASTEXITCODE -ne 0) { throw "安装脚本下载失败" }; $dalPowerShell = (Get-Process -Id $PID).Path; & $dalPowerShell -NoProfile -ExecutionPolicy Bypass -File "$dalInstaller" -UpdateOnly

更新完成后新开终端，运行 codex --version 确认版本。Codex App 用户请通过微软商店更新 App。

2输入你的 API Key

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

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

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

3等待自动配置完成

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

一键命令会自动检查并写入这两个文件：
%USERPROFILE%\.codex\auth.json
%USERPROFILE%\.codex\config.toml
CLI 用户还会安装 %USERPROFILE%\.codex\skills\cpa-imagegen\

4运行并确认成功

看到安装完成提示后，直接运行 codex。默认使用 gpt-5.6-sol；轻量任务可临时切到更省成本的 gpt-5.6-terra。

codex

# 低成本命令行任务可临时使用 Terra
codex -m gpt-5.6-terra

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

5在 CLI 中生成图片

重新打开一个 Codex 会话，直接输入 $cpa-imagegen 和完整图片描述。图片内容与修改要求以你的提示词为准，生成文件会保存到当前工作区并返回路径；需要查看或评价时再载入图片。

$cpa-imagegen 原创温馨卡通插画：圆润可爱的水豚与友善的灰狼坐在河畔草地上分享西瓜，暖色夕阳，无文字、无水印。
Codex 的托管生图工具不会向自定义 Provider 开放。一键安装会提供独立的 CPA Skill $cpa-imagegen，复用现有客户端 API Key，不需要另配 OPENAI_API_KEY。

最容易卡住的几个地方

  • 如果一键命令执行失败，先确认整条命令有没有复制完整。
  • 如果你是 Codex App 用户，不需要先装 Codex CLI，直接跑激活器就行。
  • 如果脚本运行结束后 .codex 里还是没有 auth.json 和 config.toml，说明自动配置没有成功。
  • 如果粘贴进去的 API Key 不对，启动时会报鉴权错误。
  • 如果模型名报错，可以再看 https://cpa.dongailin.cn/v1/models 当前可用列表。
  • 如果提示无法加载 codex.ps1 或系统禁止运行脚本，请重新运行最新一键安装。安装器会让 PowerShell 自动使用 codex.cmd，无需放宽系统执行策略。
  • 如果 $cpa-imagegen 没有出现在 Skill 列表中，请重新运行一键命令并新开 Codex 会话。

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

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

  • Windows 一般在：%USERPROFILE%\.codex\
  • macOS / Linux 一般在：~/.codex/
  • Windows 里 %USERPROFILE% 就表示“你当前登录用户自己的目录”。
  • 里面最关键的就是这两个文件：config.toml 和 auth.json
第一次使用时，建议先完成“一键命令 + 输入 API Key + 运行 codex”这条最短路径，其他内容可以后续按需了解。

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

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

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

2. 安装 Codex
npm install -g @openai/codex@latest --registry=https://registry.npmjs.org
codex --version

3. 运行激活器（同时安装 CPA cpa-imagegen Skill）
npm exec --yes --package=https://cpa.dongailin.cn/downloads/dal-codex-activator-1.0.12.tgz -- dal-codex-activate

DAL Codex Access · cpa.dongailin.cn