装 Codex，接国内模型
Claude Code 那门课你装好了 Claude Code。Codex 类似，也是命令行工具 + 你配置模型后端。这一节把它装好，并接上 DeepSeek 等国内大模型。
text-tools 的「开机动作」。后面的模块我们都要靠这个环境去建工作区、写代码。本节装好，后面每一节都能直接上手。环境要求
- Node.js（Codex CLI 依赖）
- 一个国内大模型的 API Key
- 国内网络（直连即可，无需翻墙）
用命令确认 Node：
node --version
看到
v18或更高版本号就 OK。如果提示「node 不是内部或外部命令」或 command not found，说明还没装 Node.js，先去 nodejs.org 装一个 LTS 版本。
安装 Codex CLI
npm install -g @openai/codex
codex --version # 验证安装
看到版本号，就装好了。npm 太慢就切国内镜像源：
npm config set registry https://registry.npmmirror.com
npm install -g @openai/codex
Windows 用户如果 npm 装完但 codex 命令找不到，通常是全局 bin 目录没进 PATH，重开一个终端再试，或用 npx codex 代替。
配置国内模型作为后端
Codex 通过配置指定「用哪家模型」。你可以把模型 Provider 指向国内大模型的兼容端点，并指定模型 ID 和 Key：
codex config set model_provider "your-provider"
codex config set model_id "deepseek-chat"
codex config set api_key_env "DEEPSEEK_API_KEY"
export DEEPSEEK_API_KEY="sk-xxxxxx"
Windows（PowerShell）设置环境变量：
setx DEEPSEEK_API_KEY "sk-xxxxxx"
设置完重开一个新终端再测，环境变量才会生效。
codex config --help 为准。先小额度测试连通性，再正式使用。一个可直接照抄的「先测通」最小命令：
codex "用一句话介绍你自己"
这条命令是你排错的好帮手：能返回，说明环境 + 模型 + Key 整条链路都通。
验证是否接上了
配置好后，跑一个最简单的小任务验证：
codex "用一句话介绍你自己"
能正常返回，说明国内模型已经接上了。想更接近真实场景，可以试一条「动手型」的：
codex "创建一个 hello.txt，内容是 hello from codex，然后打印它的内容"
如果它真的把文件建出来并读给你看，说明不只能「回话」，还能「动手」——这才是我们后面要用的状态。
落地练习：跑通你的「开机自检」
不用急着写功能，先确保你能顺利「开机」。这套自检我们在 text-tools 全程都会复用：
- 确认 Node：
node --version - 确认 Codex：
codex --version - 跑通连通性：
codex "用一句话介绍你自己" - 再试一条动手命令：
codex "创建 hello.txt，写入 hello from codex，再打印内容"
怎么判断做对了？——前两条有版本号、后两条有正常返回，并且
hello.txt真的被创建出来了（你可以在沙箱工作区里看到，或让它把内容打给你）。
卡住了怎么办？ node --version 没输出，先去装 Node。codex 找不到，检查全局安装和 PATH。codex "..." 一直 401 或没反应，回到配置步骤核对 model_id、api_key_env 和 Key。全程报超时，先确认没走境外代理。
常见坑：Key 配了，但环境变量没生效
最常见的假「配置成功」：你在终端里 export DEEPSEEK_API_KEY=... 或 setx 设置好了，也打印确认了，但一跑 Codex 还是 401。
原因多半是——环境变量只在当前终端进程里生效，Codex 读不到。解决办法：设置完重开一个新终端窗口，再跑 Codex；或者把 Key 写进系统/用户级环境变量并重启终端。永远用「跑通一条命令」来验证，而不是「我打印过这个变量了」。
常见安装/配置问题
| 现象 | 排查 |
|---|---|
codex 命令找不到 |
全局安装失败，重装确认 codex --version 有输出 |
| 任务没反应 / 401 | 模型配置或 Key 不对，检查 model_id、api_key_env |
| 一直超时 | 网关不可达或 Key 没额度，先小额度测 |
| 网络卡顿 | 确认没走境外代理，全程国内直连 |
小结
- 装 Codex：
npm install -g @openai/codex - 配置模型：
codex config set+ 设 API Key - 验证：
codex "一句话自我介绍" - 常见问题：命令找不到 / 401 / 超时，逐项排查
- 关键提醒：环境变量设完要重开终端，用「跑通命令」验证
下一节，进入 Codex 的核心——云端沙箱。