本文分享下如何安装和配置Codex CLI,结合便携AI聚合API,可国内直接使用,无需配置代理,支持Windows/Linux/Mac多客户端,支持配置到第三方IDE如VS Code。
一、Codex安装教程
OpenAI的Codex是一个开源的命令行工具(CLI),它是一个轻量级的编码代理,可以在你的终端中读取、修改和运行代码。Codex官方主要支持macOS和Linux,如果想在Windows上使用Codex,强烈推荐使用Windows Subsystem for Linux (WSL),安装好后,就在WSL上进行以下安装步骤。
这里以Ubuntu为例,其他系统类似,都是通过Node来安装的。
1、更新系统包
sudo apt update && sudo apt upgrade -y
2、添加NodeSource仓库(这里用Node.js.22)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
3、安装Node.js和npm
sudo apt install nodejs -y
验证:
node --version # 应显示 v22.x.x npm --version # 应显示 10.x.x 或更高
4、安装Codex CLI
Codex CLI通过npm全局安装,非常简单:
sudo npm install -g @openai/codex@latest
验证:
codex --version # 应显示版本号,如 0.40.0
至此,Codex成功安装。
5、IDE中使用Codex
如果是其他第三方IDE,如VS Code,则需要安装一个Codex的插件,然后配合本地的codex即可使用。
二、Codex配置教程
在Codex中配置便携AI聚合API也非常简单,支持自定义模型,包括最新的gpt-5-codex。
1、配置API Key
这一步主要是将API Key写入环境变量中,如何获取Key可以参考:《便携AI聚合API新建令牌(API key)教程》。
1)临时保存API Key
export OPENAI_API_KEY="sk-你的bianxieai密钥"
2)永久保存API Key
编辑~/.bashrc
或~/.zshrc
文件,添加:
export OPENAI_API_KEY="sk-你的bianxieai密钥"
然后运行source ~/.bashrc
(或对应文件)生效。
2、配置config.toml
config.toml是Codex的配置文件,默认路径在~/.codex/config.toml
,具体的介绍可以参考官网:https://github.com/openai/codex/blob/main/docs/config.md
这里介绍个基础的配置,使用的是便宜的gpt-4o模型,你也可以改成现在最新的针对Codex推出的gpt-5-codex:
model = "gpt-4o" model_provider = "bianxieai" [model_providers.bianxieai] name = "bianxieai" base_url = "https://api.bianxie.ai/v1" env_key = "OPENAI_API_KEY" wire_api = "chat"
3、新建Codex项目
API Key和config.toml配置完毕后,我们就可以开始使用Codex了。
1)导航到你的代码目录
cd /path/to/your/project
2)启动Codex
codex
3)示例命令
- 基本提示:codex “修复这个 bug:在 main.py 的第 42 行添加错误处理”
- 指定模型:codex -m gpt-5-codex “构建一个简单 Web 服务器”
- 模式指定:codex –mode full-auto “部署 ML 模型到 Vercel”
- 退出:输入 /exit 或 Ctrl+C。
这里是一个例子,让Codex写一个冒泡排序,并保存成文件: