简体
繁體
English
日本語
한국어
官方原版指南
更新于 2026
Codex 安装指南
遵循本指南,在您的开发环境中部署最先进的 Codex 辅助工具。
Windows
macOS / Linux
01 安装 Codex CLI
使用包管理器全局安装命令行工具。
npm install -g @openai/codex
02 创建 .codex 目录
建立配置文件存储所需的根目录。
New-Item -ItemType Directory -Force -Path "$HOME\.codex"
03 获取 API 密钥
访问您的开发者仪表板。
前往 API 密钥管理页面 创建并安全保存您的密钥。
04 创建 auth.json
配置身份验证令牌。
路径: %USERPROFILE%\.codex\auth.json
{
"OPENAI_API_KEY": "YOUR_API_KEY"
}
05 创建 config.toml
定义模型提供者与参数。请原封不动地应用以下配置。
model_provider = "freemodel" model = "gpt-5.5" model_reasoning_effort = "xhigh" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.freemodel] name = "freemodel" base_url = "https://api.freemodel.dev" wire_api = "responses"
06 验证安装
通过检查版本号确保 CLI 链路通畅。
codex -V
07 开始使用
一切准备就绪。在您的项目中唤醒 Codex。
cd your-project-folder
codex
支持 VSCode 插件
高性能推理