Codex 安装与配置

Codex 安装与配置教程

本页介绍如何安装 Codex，并将其配置为使用跨界AI 服务

环境准备

[!NOTE] 通过 npm 安装需要 Node.js 18 或更高版本，请先完成环境配置

安装

macOS 方法一：官方安装脚本（推荐）

curl -fsSL https://chatgpt.com/codex/install.sh | sh

方法二：Homebrew

brew install --cask codex

方法三：NPM（国内镜像）

npm i -g @openai/codex --registry=https://registry.npmmirror.com

Windows 方法一：官方安装脚本（推荐） 在 PowerShell 中运行：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

方法二：NPM（国内镜像）

npm i -g @openai/codex --registry=https://registry.npmmirror.com

[!TIP] 如果你习惯在 WSL 中开发，也可以在 WSL 终端里按 Linux 方式安装，此时配置文件位于 WSL 内的 ~/.codex/

Linux 方法一：官方安装脚本（推荐）

curl -fsSL https://chatgpt.com/codex/install.sh | sh

方法二：NPM（国内镜像）

npm i -g @openai/codex --registry=https://registry.npmmirror.com

[!NOTE] 官方安装脚本从 chatgpt.com 下载。网络无法访问时，改用 NPM 国内镜像安装，NPM 方式需要先准备 Node.js 环境

安装完成后，打开一个新的终端窗口，运行以下命令确认安装成功

codex --version

配置

配置文件位于：

macOS/Linux：~/.codex/
Windows：C:\Users\你的用户名\.codex\

1. 创建 config.toml

model_provider = "OpenAI"
model = "your-model-id" # 从模型广场复制实际模型 ID
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_verbosity = "high"
network_access = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.kuajieaigc.com/v1"
wire_api = "responses"
requires_openai_auth = true

[!NOTE] Windows 用户可在 config.toml 开头额外添加 windows_wsl_setup_acknowledged = true，跳过首次启动时的 Windows 引导提示

2. 创建 auth.json

{
  "OPENAI_API_KEY": "your-api-key-here"
}

[!WARNING] 将 your-api-key-here 替换为你的 API Key

[!TIP] 想用图形界面？ChatGPT 桌面应用的 Codex 模式和命令行共用这份配置，参考 ChatGPT 桌面应用安装与配置

使用

在终端运行 codex，看到对话界面并能正常回复即表示配置完成

codex

遇到问题

Codex 常见问题 查看 Codex 配置相关的常见问题

开始使用

API 与代码

Codex

Claude

Gemini

客户端

帮助

环境准备

安装

配置

使用

遇到问题

​环境准备

​安装

​配置

​使用

​遇到问题

环境准备

安装

配置

使用

遇到问题