国内没有魔法如何畅用 Codex 代码工具

这是一份面向新手的 Codex CLI 离线安装与使用说明，涵盖 Windows、macOS 安装路径、配置脚本、常见问题，以及如何准备稳定可用的 API Key。

Codex CLI 离线安装使用说明

这是一份给新手准备的 Codex CLI 离线安装指南。重点解决三个问题：没有魔法怎么安装、不同平台怎么选、配置好后怎么直接开始使用。

这份文档适合谁看

想尝试 Vibe Coding，但还没有稳定网络环境

第一次接触 Codex CLI，不想被安装过程劝退

需要给同事或朋友分发一套可离线使用的安装包

使用前准备

目标电脑需要先安装：

Node.js

npm

可先在终端检查：

node -v
npm -v

如果能正常显示版本号，说明前置环境已经具备。

目录说明

windows-x64/npm-offline

macos-arm64/npm-offline

macos-x64/npm-offline

安装包下载地址： https://pan.quark.cn/s/ba9ebd0bb18f 每个平台目录都已经整理成可独立使用，里面通常包含：

通用主包 codex-npm-0.121.0-alpha.6.tgz

当前平台对应的离线包

安装脚本

配置脚本

简短平台说明

先判断自己属于哪个平台

Windows

普通 Windows 电脑一般直接使用：

windows-x64/npm-offline

macOS

Mac 分两种：

Apple Silicon：M1、M2、M3、M4，使用 macos-arm64

Intel Mac：老款 Intel 处理器 Mac，使用 macos-x64

如果不确定，在 Mac 终端执行：

uname -m

结果对应关系：

arm64：使用 macos-arm64

x86_64：使用 macos-x64

Windows x64 安装步骤

Windows 建议优先使用安装脚本；如果你更习惯自己控制安装过程，也可以走手动安装。

第一步：进入离线安装目录

cd "你的路径\\codex-npm-offline\\windows-x64\\npm-offline"

第二步：运行安装脚本

.\install-codex-windows-x64.cmd

第三步：如果需要，也可以手动安装

npm install -g .\codex-npm-0.121.0-alpha.6.tgz @openai/codex-win32-x64@file:.\codex-npm-win32-x64-0.121.0-alpha.6.tgz

第四步：确认安装成功

codex --version

能输出版本号，就说明安装成功。

运行配置脚本

安装完成后，双击运行配置脚本：

.\run-codex-setup.cmd

脚本会提示你输入两项内容：

base URL

API key

配置脚本会自动写入：

~/.codex/config.toml

~/.codex/auth.json

如果原来已有文件，脚本会在覆盖前创建备份。

配置完成后启动 Codex：

codex

如果希望直接进入更自由的执行模式，也可以运行：

codex --yolo

macOS Apple Silicon 安装步骤

适用于 M1、M2、M3、M4。

cd "/你的路径/codex-npm-offline/macos-arm64/npm-offline"
bash ./install-codex-macos-arm64.sh

如果想手动安装：

npm install -g ./codex-npm-0.121.0-alpha.6.tgz @openai/codex-darwin-arm64@file:./codex-npm-darwin-arm64-0.121.0-alpha.6.tgz

安装完成后检查：

codex --version

然后运行配置脚本：

bash ./setup-codex-macos.sh

最后启动：

codex

macOS Intel 安装步骤

cd "/你的路径/codex-npm-offline/macos-x64/npm-offline"
bash ./install-codex-macos-x64.sh

如果想手动安装：

npm install -g ./codex-npm-0.121.0-alpha.6.tgz @openai/codex-darwin-x64@file:./codex-npm-darwin-x64-0.121.0-alpha.6.tgz

安装完成后检查：

codex --version

然后运行配置脚本：