一个计算机技术爱好者与学习者

0%

编程辅助工具 Codex 入门篇

置顶 | 发表于 分类于 ， ， ，

1. Codex 简介

Codex 是一个辅助编程的命令行工具，借助GPT系列模型提高编码的速度和质量。
Codex的安装配置方法和Claude Code很像（几乎一模一样），本文会对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 必须指向环境变量。

  1. 配置key环境变量
    1
    2
    3
    4
    echo 'export NEW_OPENAI_API_KEY="xxx"' >> ~/.zshrc
    source ~/.zshrc
    #echo 'export NEW_OPENAI_API_KEY="xxx"' >> ~/.bash_profile
    #source ~/.bash_profile

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基础用法

参考文档：