简体
繁體
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 插件 高性能推理