使用自定義API接入OpenAI CodeX配置教程
我要評(píng)論Codex 是OpenAI 推出的一系列人工智能編碼工具，通過(guò)將任務(wù)委托給強(qiáng)大的云端和本地編碼代理，幫助開(kāi)發(fā)人員提升工作效率。支持原生終端、vscode插件、cursor插件等場(chǎng)景使用。
本教程目的：使用第三方API（中轉(zhuǎn)API）方式接入OpenAI CodeX服務(wù)。
官網(wǎng)網(wǎng)站 openai.com/codex/
系統(tǒng)要求
| 系統(tǒng)要求 | 細(xì)節(jié) |
|---|---|
| 操作系統(tǒng) | macOS 12+、Ubuntu 20.04+/Debian 10+ 或通過(guò) WSL2 的Windows 11 |
| Git（可選，推薦） | 2.23+ 內(nèi)置 PR 助手 |
| 內(nèi)存 | 最低 4 GB（建議 8 GB） |
| Node版本 | 需要Node 22+ |
步驟一：安裝Codex CLI
選擇一種安裝方式即可。
npm（通用）
npm i -g @openai/codex # 或在有時(shí)需要的原生包名： # npm i -g @openai/codex@native codex --version
Homebrew（macos系統(tǒng)推薦）
brew update brew install codex codex --version
如遇 codex 無(wú)法執(zhí)行或 Node 版本過(guò)舊，請(qǐng)升級(jí) Node（常見(jiàn)需要 Node 22+），或改用 Homebrew 安裝。
Codex配置
安裝后，我們開(kāi)始配置codex才能通過(guò)apikey方式接入我們的API。如果你是通過(guò)openai plus會(huì)員來(lái)使用codex，可跳過(guò)后續(xù)教程，codex中直接登錄plus賬號(hào)即可使用。
1.在第三方中轉(zhuǎn)平臺(tái)注冊(cè)并充值
這里我們以一個(gè)第三方中轉(zhuǎn)平臺(tái)作為例子，進(jìn)入網(wǎng)站 api.v3.cm 進(jìn)行注冊(cè)并充值，然后在該網(wǎng)站 “令牌管理”頁(yè)面，復(fù)制apikey，后續(xù)我們將該apikey接入到codex中使用。
2.codex配置文件config.toml
Codex 啟動(dòng)時(shí)會(huì)在~/.codex/ 讀取config.toml文件。若不存在就新建：
mkdir -p ~/.codex nano ~/.codex/config.toml
在config.toml中加入如下配置，根據(jù)需求修改：
model_provider = "vapi" # 設(shè)置API供應(yīng)商
model = "gpt-5" # 填寫(xiě)支持codex的模型即可
model_reasoning_effort = "low" # 思考級(jí)別 low medium（默認(rèn)） high minimal，不需要可以#注釋掉
# 供應(yīng)商設(shè)置
[model_providers.vapi]
name = "VAPI"
base_url = "https://api.v3.cm/v1"
env_key = "V_API_KEY" # 保留這個(gè)值，不需要替換為apikey
wire_api = "chat" # 使用 /v1/chat/completions 協(xié)議
query_params = {}
request_max_retries = 4 # 失敗最大重試次數(shù)
stream_max_retries = 10 # 流中斷后最大重試次數(shù)
# 可選：定義一個(gè) profile，便于命令行快速切換
[profiles.vapi]
model_provider = "vapi"
model = "gpt-5"
approval_policy = "on-request" # 需要時(shí)再詢(xún)問(wèn)是否執(zhí)行
sandbox_mode = "workspace-write" # 允許在當(dāng)前工程寫(xiě)文件，依舊禁網(wǎng)3.添加apikey環(huán)境變量
這步很重要，我們需要將我們?cè)O(shè)置的環(huán)境變量V_API_KEY添加到系統(tǒng)配置中。
key值就是我們從中轉(zhuǎn)網(wǎng)站的 “令牌管理”頁(yè)面復(fù)制的sk-開(kāi)頭的apikey。
Window用戶(hù)設(shè)置apikey環(huán)境變量：
# 永久設(shè)置（推薦） setx V_API_KEY "sk-xxxxxx" # 臨時(shí)設(shè)置，切換窗口后失效 set V_API_KEY=sk-xxxxxx
Mac/Linux用戶(hù)設(shè)置環(huán)境變量：
方法一：永久設(shè)置（推薦)
1.編輯配置文件（或直接手動(dòng)打開(kāi)文件）
# 如果使用 bash nano ~/.bash_profile # 或 nano ~/.bashrc # 如果使用 zsh（Mac默認(rèn)） nano ~/.zshrc
2.在最后新行，添加以下內(nèi)容
export V_API_KEY="sk-xxxxxx"
3.保存并生效
# bash source ~/.bash_profile # zsh source ~/.zshrc
方法二：臨時(shí)設(shè)置
export V_API_KEY="sk-xxxxxx"
驗(yàn)證是否設(shè)置成功
# Windows (CMD) echo %V_API_KEY% # Windows (PowerShell) echo $env:V_API_KEY # Mac/Linux echo $V_API_KEY
如果顯示sk-xxxxxx則說(shuō)明設(shè)置成功！
啟動(dòng)命令
Codex CLI原生命令
# 直接提問(wèn) codex "你好" # 選擇提供商并提問(wèn)(如果有多個(gè)提供商的話(huà)) codex --profile vapi "你好"
vscode中使用Codex插件
如果是在vscode中使用codex插件，我們配置好后需要完全退出vscode重新啟動(dòng)才能生效。
Codex高級(jí)使用技巧指南
CLI 參考
| 命令 | 目的 | 例子 |
|---|---|---|
| codex | 交互式TUI | codex |
| codex "..." | 交互式 TUI 的初始提示 | codex "fix lint errors" |
| codex exec "..." | 非交互式"自動(dòng)化模式" | codex exec "explain utils.ts" |
非交互/CI模式
在管道中以無(wú)頭方式運(yùn)行 Codex。示例 GitHub Action 步驟：
- name: Update changelog via Codex
run: |
npm install -g @openai/codex
export OPENAI_API_KEY="${{ secrets.OPENAI_KEY }}"
codex exec --full-auto "update CHANGELOG for next release"模型上下文協(xié)議（MCP）
通過(guò)在~/.codex/config.toml中定義一個(gè)mcp_servers部分，可以將 Codex CLI 配置為使用 MCP 服務(wù)器。它旨在反映 Claude 和 Cursor 等工具在其各自的 JSON 配置文件中的 mcpServers 定義方式，盡管 Codex 的格式略有不同，因?yàn)樗褂玫氖?TOML 而不是 JSON，例如：
# IMPORTANT: the top-level key is `mcp_servers` rather than `mcpServers`.
[mcp_servers.server-name]
command = "npx"
args = ["-y", "mcp-server"]
env = { "API_KEY" = "value" }參考資料
到此這篇關(guān)于使用自定義API接入OpenAI CodeX配置教程的文章就介紹到這了,更多相關(guān)自定義API接入OpenAI CodeX內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！
相關(guān)文章
本文詳細(xì)介紹了如何wen模型在macOSOSMini環(huán)境下配置Codex調(diào)用自定義AIAPI的方法,包括配置文件編寫(xiě)、環(huán)境變量設(shè)置等以及常見(jiàn)問(wèn)題及解決方案，感興趣的可以了解一下2026-05-29
