Codex 是一个辅助编程的命令行工具，借助GPT系列模型提高编码的速度和质量。
Codex的安装配置方法和Claude Code很像（几乎一模一样），本文会对Codex的基础配置和用法进行说明，方便大家入手使用。

相关文档：

• Codex官网
• github - openai/codex

2. 安装Codex

2.1. 安装node.js 18+

1. 安装nvm

   1	curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

2. 安装node.js 20

   1 2 3

   nvm install v20.19.4 nvm use v20.19.4 nvm alias default v20.19.4

2.2. 安装Codex

1

npm install -g @openai/codex

2.3. 初始化Codex

1

codex

出现提示：

1
2
3
4
5
6
7
8
9
10
11
12

  Welcome to Codex, OpenAI's command-line coding agent

  Sign in with ChatGPT to use Codex as part of your paid plan
  or connect an API key for usage-based billing

> 1. Sign in with ChatGPT
     Usage included with Plus, Pro, and Team plans

  2. Provide your own API key
     Pay for what you use

  Press Enter to continue

这里不用再继续配置，直接 ctrl+C 退出。

3. 安装配置OpenAI API代理

Codex依赖OpenAI API，但是因为国内无法访问OpenAI，所以我们需要一些访问OpenAI API的替代方案。
推荐使用NewAPI，它是OneAPI停止更新后的更强继承者。

4. 配置Codex

1. 创建codex配置文件

   1	vim ~/.codex/config.toml

假设使用的Claude API代理是NewAPI，那么填入如下内容：

1
2
3
4
5
6
7
8
9

model = "gpt-5"
model_provider = "new-api"
model_reasoning_effort = "medium"

[model_providers.new-api]
name = "New Api OpenAI"
base_url = "https://newapi.voidking.com/v1"
env_key = "NEW_OPENAI_API_KEY"
wire_api = "chat"

特别注意的是不能将 api_key 作为字符串直接传递给 env_key。 env_key 必须指向环境变量。

2. 配置key环境变量

   1 2 3 4

   echo 'export NEW_OPENAI_API_KEY="xxx"' >> ~/.zshrc source ~/.zshrc

5. 命令行使用Codex

1
2

cd your-project
codex

6. VSCode/Cursor使用Codex

1. 安装插件 Codex – OpenAI’s coding agent
   插件安装完成，VSCode右上角会出现OpenAI图标

2. 点击VSCode右上角会OpenAI图标，启动Codex
   首次启动会比较慢（半分钟左右），请耐心等待。

3. 输入需求，辅助编程

7. Codex基础用法

参考文档：

• Codex CLI 快速入门指南
• Codex & Codex CLI 国内使用教程，手把手教你如何支付、安装 Codex！
• 再见 Claude Code！玩转 CodeX CLI 的 16 个实用小技巧，效率拉满！！