Codex安装和配置完整指南 Codex是OpenAI出品的Rust编写的CLI工具,支持Codex Cloud云端版、CLI本地终端、App桌面应用、VSCode扩展四种形态。以下配置让Codex自循环更新。
安装 bash# 安装
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) 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 = trueAGENTS.md 配置 在项目根目录创建AGENTS.md,作为Codex的项目级上下文入口:
markdown# 项目概述
这个项目是一个...
# 技术栈
- 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服务器:
toml[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.mdSkill格式示例:
markdown# Skill: code-review
## Description
审查代码质量、安全性和性能
## Input
- files: 需要审查的文件路径列表
## Steps
1. 检查代码规范
2. 检查安全性
3. 检查性能
4. 输出审查报告备份与迁移 配置目录 ~/.codex/ 可以整体打包备份,迁移到新机器时直接解压到对应位置即可。
关键词:Codex, 配置, config.toml, AGENTS.md, MCP, Skills, CLI, npm