Codex安装和配置完整指南

Codex是OpenAI出品的Rust编写的CLI工具，支持Codex Cloud云端版、CLI本地终端、App桌面应用、VSCode扩展四种形态。以下配置让Codex自循环更新。

安装

# 安装
npm install -g @openai/codex

# 交互模式
codex

# 非交互模式
codex exec

# 升级
npm i -g @openai/codex@latest

官网：https://developers.openai.com/codex
GitHub：https://github.com/openai/codex

配置目录结构

~/.codex/
├── config.toml          # 主配置文件
├── auth.json            # 认证信息
├── instructions.md      # 全局系统提示词
├── version.json         # 版本信息
└── token                # ChatGPT登录Token

核心配置 (config.toml)

# 模型与文档
project_doc_fallback_filenames = ["CLAUDE.md"]
model = "gpt-5.4"
review_model = "gpt-5.3-codex"
model_context_window = 1000000
model_auto_compact_token_limit = 350000
tool_output_token_limit = 40000

# 推理与输出
model_reasoning_effort = "xhigh"       # minimal/low/medium/high/xhigh
model_reasoning_summary = "detailed"   # auto/concise/detailed/none
plan_mode_reasoning_effort = "high"
model_verbosity = "high"               # low/medium/high

# 执行偏好
approval_policy = "on-request"         # untrusted/on-request/never
sandbox_mode = "danger-full-access"    # read-only/workspace-write/danger-full-access
web_search = "disabled"

# 功能开关
[features]
shell_tool = true
shell_snapshot = false
undo = true

AGENTS.md 配置

在项目根目录创建AGENTS.md，作为Codex的项目级上下文入口：

# 项目概述
这个项目是一个...

# 技术栈
- Next.js
- TypeScript
- Prisma

# 编码规范
- TypeScript strict mode
- 函数式组件优先

# 常用命令
- npm run dev：启动
- npm test：测试

当目录缺少AGENTS.md时，Codex会降级读取CLAUDE.md。

CLI命令速查

命令	说明
codex	交互模式
codex exec	非交互模式
codex review	代码审查
codex plan	生成计划
codex init	初始化项目配置
codex --version	查看版本

MCP服务器配置

在config.toml中配置MCP服务器：

[mcp_servers]
[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]

[mcp_servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]

Skills管理

Skills保存在 ~/.codex/skills/ 目录：

~/.codex/skills/
  ├── code-review.md
  ├── test-generator.md
  └── deployment-check.md

Skill格式示例：

# Skill: code-review
## Description
审查代码质量、安全性和性能

## Input
- files: 需要审查的文件路径列表

## Steps
1. 检查代码规范
2. 检查安全性
3. 检查性能
4. 输出审查报告

备份与迁移

配置目录 ~/.codex/ 可以整体打包备份，迁移到新机器时直接解压到对应位置即可。

---

关键词：Codex, 配置, config.toml, AGENTS.md, MCP, Skills, CLI, npm