目录
一、环境准备与基础安装
1. 系统兼容性检查
2. 前置依赖安装
3. 安装方式选择
二、API密钥配置与认证
1. 获取API密钥
2. 配置文件设置
3. 临时配置方式
三、沙盒环境配置与安全策略
1. 沙盒模式选择
2. 安全最佳实践
四、高级功能配置
1. 模型上下文协议(MCP)配置
2. 模型版本切换
3. 自定义网关配置
五、常见问题排查
1. 安装失败
2. API调用失败
3. 处理速度慢
4. 配置文件不生效
六、生产环境部署建议
一、环境准备与基础安装
1. 系统兼容性检查
macOS/Linux：官方提供稳定支持，推荐使用原生环境
Windows：官方标注为实验性支持，建议优先使用WSL(Windows Subsystem for Linux)环境，或直接使用Codex Desktop App/VS Code扩展
2. 前置依赖安装
所有系统需提前安装：
Node.js 22+及npm 10+（建议使用LTS版本）
Git版本控制系统
稳定的网络连接（国内用户建议配置镜像源）
3. 安装方式选择
方式一：桌面客户端（推荐新手）
访问官方GitHub仓库下载对应系统安装包
按照向导完成安装，首次启动需配置API Key
中文界面设置：File > Settings > General > Language选择Chinese (China)
方式二：CLI命令行工具（推荐开发者）
配置国内镜像源（解决网络问题）：
npm config set registry https://registry.npmmirror.com
全局安装Codex CLI：
npm install -g @openai/codex
验证安装成功：
codex –version
若提示
