唯元智创 Codex 配置指南

适用范围：使用 Codex CLI 或 VS Code/Cursor 中的 Codex 能力接入唯元智创 AI 网关平台。

项目	配置值
更新时间	2026-06-04
推荐调用模式	Responses API
配置目录	~/.codex 或 C:\Users\用户名.codex
唯元智创平台接口	https://api.weimeta.cn/v1
默认模型	gpt-5.2

重要说明本文档不包含真实 token。请从唯元智创平台控制台或管理员处获取 AI 网关 token，并将 {AIGateway_Token} 替换为实际凭据。

一、安装

通过 npm 安装 Codex CLI。安装完成后执行版本检查，能看到版本号即表示安装成功。

npm i -g @openai/codex
codex --version


图 1：安装 Codex CLI 并检查版本

二、启动与访问

Codex 目前推荐通过 Responses API 接入。配置文件一般存放在用户主目录的 .codex 目录下；如果没有 auth.json 和 config.toml，可手动创建。

项目	配置值
macOS / Linux	~/.codex/auth.json；~/.codex/config.toml
Windows	C:\Users\用户名.codex\auth.json；C:\Users\用户名.codex\config.toml

2.1 auth.json 配置方式

{
  "OPENAI_API_KEY": "{AIGateway_Token}"
}

2.2 config.toml 配置方式

model_provider = "weiyuan"
model = "gpt-5.2"

[model_providers.weiyuan]
name = "weiyuan"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://api.weimeta.cn/v1"


图 2：配置 Codex 的唯元智创平台 provider

2.3 一键写入示例

macOS / Linux

mkdir -p ~/.codex
cat > ~/.codex/auth.json <<'JSON'
{
  "OPENAI_API_KEY": "{AIGateway_Token}"
}
JSON

cat > ~/.codex/config.toml <<'TOML'
model_provider = "weiyuan"
model = "gpt-5.2"

[model_providers.weiyuan]
name = "weiyuan"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://api.weimeta.cn/v1"
TOML

chmod 600 ~/.codex/auth.json ~/.codex/config.toml

Windows PowerShell

$CodexDir = Join-Path $HOME ".codex"
New-Item -ItemType Directory -Force -Path $CodexDir | Out-Null

@'
{
  "OPENAI_API_KEY": "{AIGateway_Token}"
}
'@ | Set-Content -Encoding UTF8 (Join-Path $CodexDir "auth.json")

@'
model_provider = "weiyuan"
model = "gpt-5.2"

[model_providers.weiyuan]
name = "weiyuan"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://api.weimeta.cn/v1"
'@ | Set-Content -Encoding UTF8 (Join-Path $CodexDir "config.toml")

三、Codex 使用

1. 打开命令行终端，cd 进入需要 Codex 读取和修改的工作目录。
2. 运行 codex 启动交互式会话。
3. 遇到更新提示时，可按团队要求选择更新或跳过。
4. 根据项目安全要求选择沙盒和命令授权策略。

cd 你的工作目录路径
codex

# 非交互验证
codex exec "Reply with OK only."

验证成功时应返回：

OK


图 3：验证唯元智创 AI 网关平台连通性

四、VS Code / Cursor 使用

如需在 VS Code 或 Cursor 中使用 Codex，可安装 OpenAI 官方扩展，并在编辑器中打开 Codex 面板。扩展会读取本机 Codex 登录或配置状态；如需网关模式，请优先确认 CLI 配置已完成。

code --install-extension openai.chatgpt --force
# Cursor 可在扩展市场搜索 OpenAI / Codex 并安装


图 4：在 VS Code 中打开 Codex 插件入口

五、网关适配性

测试场景	测试方式	验证能力	唯元智创平台
启动连接	配置 API 后启动 Codex	API 认证、基础连通	YES
基础对话	发送“你好”或简单问题	流式响应、SSE 格式	YES
阅读文件	读取某个代码文件	Tool Use 单工具调用	YES
执行命令	执行 shell 命令	Bash 工具调用	YES
复杂任务	读取、分析、修改多步骤任务	多工具连续调用、长上下文	YES
思考内容输出	问题咨询	Responses 推理/思考内容	YES

六、常见问题

6.1 base_url 是否需要带 /v1？

Codex 的 provider base_url 按 OpenAI 兼容接口填写完整地址，唯元智创平台填写 https://api.weimeta.cn/v1

6.2 为什么要设置 wire_api = "responses"？

Codex 新版本主要使用 Responses API 请求形态。设置 wire_api = "responses" 可以让客户端按 Responses 模式组织请求。

6.3 客户不希望 token 写入文件怎么办？

可由客户通过系统环境变量或密钥管理工具注入 OPENAI_API_KEY，再保留 config.toml 中的 provider 配置。