Codex从零安装与初始化配置指南

完整涵盖nvm管理NodeJS、Codex安装、config.toml和auth.json配置、AGENTS.md模板、Windows/Linux自动化脚本。

1. nvm安装NodeJS

Windows

# 安装nvm-windows
# 从GitHub Releases下载nvm-setup.zip

# 安装指定Node版本
nvm install 24.14.0
nvm use 24.14.0
node --version

# 配置全局路径
npm config set prefix "D:\tool\nodejs\node_global"
npm config set cache "D:\tool\nodejs\node_cache"

Linux

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

2. 安装Codex

# 国内使用镜像源
npm install -g @openai/codex --registry=https://registry.npmmirror.com

# 验证
codex -V

3. 配置文件

auth.json

{
  "OPENAI_API_KEY": "your-api-key"
}

config.toml

model_provider = "my-provider"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = false

[model_providers.my-provider]
name = "my-provider"
base_url = "https://your-domain/v1"
wire_api = "responses"
requires_openai_auth = true

4. AGENTS.md配置

全局AGENTS.md（~/.codex/AGENTS.md）

# 智能体开发指南

## 角色定位
你是一位资深的软件工程师/系统架构师

## 编码规范
- TypeScript strict mode
- 函数式组件优先
- 所有新功能要有测试

## 代码质量
- 每次改动后运行测试
- 遵循DRY和YAGNI原则
- 关键决策留注释

## 工作流
- 复杂任务先plan再执行
- 小步提交，频繁验证
- 完成时输出总结

项目级AGENTS.md

# 项目概述
[项目名称和定位]

## 技术栈
- [框架/语言/数据库]

## 架构说明
- 核心模块
- 目录结构
- 数据流

## 常用命令
- npm run dev
- npm test
- npm run build

5. 启动

cd your-project
codex

---

关键词：Codex, 安装, 配置, nvm, AGENTS.md, NodeJS, 脚本