Codex CLI 如何配置中转站的 OPENAI 模型
本文将以proaiapi.tech这个OpenAI 中转站为例子提供了Windows、Mac和Linux三大操作系统下安装配置Codex的完整教程。Windows 版本教程系统要求Windows 10 或 Windows 11Node.js 22npm 10网络连接安装步骤前置步骤安装 Git Bash请访问 Git - Downloads 下载对应您电脑系统的版本之后一直点击“下一步”即可完成安装。安装 Node.js访问 Node.js 官网 下载并安装最新 LTS 版本。安装 codex打开命令提示符 (CMD) 或 PowerShell运行bashnpm install -g openai/codex验证安装打开命令提示符 (CMD) 或 PowerShell运行bashcodex --version配置 API1. 获取 Auth Token访问proaiapi.tech站点页面进行以下操作点击 控制台 → API令牌 页面点击 添加令牌令牌分组请选择codex专属务必选择此分组否则无法使用令牌名称随意额度建议设置为 无限额度其他选项保持默认2. 配置文件重要提示请将下方的sk-xxx替换为您在 ProAIApi 生成的实际 API 密钥重要提示请将下方的sk-xxx替换为您在 ProAIApi 生成的实际 API 密钥重要提示请将下方的sk-xxx替换为您在 ProAIApi 生成的实际 API 密钥进入当前用户的用户目录下的.codex文件夹中例如C:\Users\testuser\.codex。注意如果看不到该目录说明您没有打开 Windows 的“显示隐藏的项目”请先在文件资源管理器中开启。如果没有.codex文件夹请手动创建该文件夹然后在其中创建config.toml以及auth.json两个文件。填写配置(需要将sk-xxx替换成您自己创建的真实 SK)。a.auth.json中的配置json{OPENAI_API_KEY: sk-xxx}b.config.toml中的配置直接粘贴下面的内容即可tomlmodel_provider api111 model gpt-5.5 model_reasoning_effort high disable_response_storage true preferred_auth_method apikey [model_providers.api111] name api111 base_url https://proaiapi.tech/v1 wire_api responsesmodel_reasoning_effort可选值为 high, medium, low分别代表模型思考的努力程度高、中、低。启动 codex重启终端重启终端重启终端然后进入到您的工程目录bashcd your-project-folder运行以下命令启动bashcodexMac 版本教程系统要求macOS 12 或更高版本Node.js 22npm 10网络连接安装步骤安装 Node.js方式一直接访问 Node.js 官网 下载并安装最新 LTS 版本。方式二使用 Homebrew推荐bash# 如果尚未安装 Homebrew请先运行此命令 /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh) # 安装 Node.js brew install node安装 codex打开终端 (Terminal)运行可能需要加sudobashsudo npm install -g openai/codex验证安装打开终端 (Terminal)运行bashcodex --version配置 API1. 获取 Auth Token访问proaiapi.tech站点页面进行以下操作点击 控制台 → API令牌 页面点击 添加令牌令牌分组请选择codex专属务必选择此分组否则无法使用令牌名称随意额度建议设置为 无限额度其他选项保持默认2. 配置文件重要提示请将下方的sk-xxx替换为您在 proaiapi.tech 生成的实际 API 密钥重要提示请将下方的sk-xxx替换为您在 proaiapi.tech 生成的实际 API 密钥重要提示请将下方的sk-xxx替换为您在 proaiapi.tech 生成的实际 API 密钥创建目录和文件bashmkdir -p ~/.codex touch ~/.codex/auth.json touch ~/.codex/config.toml编辑auth.json文件bashvi ~/.codex/auth.json按i进入插入模式粘贴以下内容将sk-xxx替换为您的密钥然后按ESC键输入:wq并回车保存退出。json{OPENAI_API_KEY: sk-xxx}编辑config.toml文件bashvi ~/.codex/config.toml按i进入插入模式粘贴以下内容然后按ESC键输入:wq并回车保存退出。tomlmodel_provider api111 model gpt-5.5 model_reasoning_effort high disable_response_storage true preferred_auth_method apikey [model_providers.api111] name api111 base_url https://proaiapi.tech/v1 wire_api responses启动 codex重启终端重启终端重启终端然后进入到您的工程目录bashcd your-project-folder运行以下命令启动bashcodexLinux 版本教程系统要求主流 Linux 发行版 (Ubuntu 20.04, Debian 10, CentOS 7, etc.)Node.js 22npm 10网络连接安装步骤安装 Node.jsUbuntu/Debianbashsudo apt update curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejsCentOS/RHEL/Fedorabash# 使用 dnf (Fedora) 或 yum (CentOS/RHEL) sudo dnf install nodejs npm # 或 sudo yum install nodejs npmArch Linuxbashsudo pacman -S nodejs npm安装 codex打开终端 (Terminal)运行bashsudo npm install -g openai/codex验证安装打开终端 (Terminal)运行bashcodex --version配置 API1. 获取 Auth Token访问proaiapi.tech站点页面进行以下操作点击 控制台 → API令牌 页面点击 添加令牌令牌分组请选择codex专属务必选择此分组否则无法使用令牌名称随意额度建议设置为 无限额度其他选项保持默认2. 配置文件重要提示请将下方的sk-xxx替换为您在 proaiapi.tech 生成的实际 API 密钥重要提示请将下方的sk-xxx替换为您在 proaiapi.tech 生成的实际 API 密钥重要提示请将下方的sk-xxx替换为您在 proaiapi.tech 生成的实际 API 密钥创建目录和文件bashmkdir -p ~/.codex touch ~/.codex/auth.json touch ~/.codex/config.toml编辑auth.json文件bashvi ~/.codex/auth.json按i进入插入模式粘贴以下内容将sk-xxx替换为您的密钥然后按ESC键输入:wq并回车保存退出。json{OPENAI_API_KEY: sk-xxx}编辑config.toml文件bashvi ~/.codex/config.toml按i进入插入模式粘贴以下内容然后按ESC键输入:wq并回车保存退出。tomlmodel_provider api111 model gpt-5.5 model_reasoning_effort high disable_response_storage true preferred_auth_method apikey [model_providers.api111] name api111 base_url https://proaiapi.tech/v1 wire_api responses启动 codex重启终端重启终端重启终端然后进入到您的工程目录bashcd your-project-folder运行以下命令启动bashcodexVSCode 插件 codex以上配置完成后在 VSCode 扩展商店中搜索并安装codex即可。安装完成后会出现在侧边栏。找到并点击Settings以打开 VSCode 系 IDE 的settings.json文件。在settings.json文件末尾添加以下配置⚠️注意这里的 apikey 字段 无需更改 即将以下内容原封不动粘贴即可jsonchatgpt.apiBase:https://proaiapi.tech/v1, chatgpt.config:{ preferred_auth_method:apikey }常见问题出现错误请按照如下步骤排查确认 API Key 创建是否正确额度选择无限额度不要限制模型分组选择codex渠道。更多 codex 配置及使用详情请参考 codex 官方教程。清除代码bashsudo npm uninstall -g openai/codex; sudo rm -rf ~/.codex ~/.npm/_npx ~/.npm/_cacache; hash -r清完后验证一下bashwhich codex如果没有输出说明 Codex 已经清掉了。