PingToken — Piattaforma Globale di Accesso ai Modelli IA

安装 Codex

安装或更新 Node.js（v18.0 或更高版本）。
在终端中执行以下命令安装 Codex：

npm install -g @openai/codex

执行以下命令验证安装：

codex --version

配置接入凭证

接入需要编辑配置文件 ~/.codex/config.toml 并配置环境变量 OPENAI_API_KEY。

PingToken 接入配置

将 OPENAI_API_KEY 环境变量设置为您的 pingtoken API Key。

Windows 专用配置

对于 Windows 系统，可在配置文件中添加以下专用配置：

[windows]
model = "deepseek-v4-flash"
model_provider = "pingtoken"
sandbox = "elevated"

Responses API（推荐）

适用于支持 OpenAI Responses API 的模型，可使用最新版 Codex。

model_provider = "pingtoken"
model = "MODEL_ID"
[model_providers.pingtoken]
name = "pingtoken"
base_url = "https://pingtoken.cn/api/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

Chat/Completions API

适用于仅支持 Chat/Completions API 的模型，需安装旧版本 Codex：

npm install -g @openai/codex@0.80.0

model_provider = "pingtoken"
model = "MODEL_ID"
[model_providers.pingtoken]
name = "pingtoken"
base_url = "https://pingtoken.cn/api/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

配置环境变量

macOS

在终端中执行以下命令，查看默认 Shell 类型：

echo $SHELL

根据 Shell 类型设置环境变量：

Zsh

# 将 YOUR_API_KEY 替换为您的 PingToken API Key
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc

Bash

# 将 YOUR_API_KEY 替换为您的 PingToken API Key
echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile

执行以下命令使环境变量生效：

# Zsh
source ~/.zshrc

# Bash
source ~/.bash_profile

Windows

CMD

REM 将 YOUR_API_KEY 替换为您的 PingToken API Key
setx OPENAI_API_KEY "YOUR_API_KEY"

打开一个新的 CMD 窗口，运行以下命令检查环境变量是否生效：

echo %OPENAI_API_KEY%

PowerShell

# 将 YOUR_API_KEY 替换为您的 PingToken API Key
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)

打开一个新的 PowerShell 窗口，运行以下命令检查环境变量是否生效：

echo $env:OPENAI_API_KEY

验证配置

配置完成后，新建终端窗口，执行以下命令启动 Codex：

codex

如果正常进入对话界面，说明配置成功。

常见问题

报错 wire_api = chat is no longer supported 怎么办？

原因：Codex 新版本使用 Responses API，不支持 wire_api = "chat" 配置。

解决方案：将 wire_api 改为 responses，并确认 base_url 配置正确。

报错 unexpected status 401 Unauthorized 怎么办？

原因：API Key 错误、订阅过期或 API Key 复制不完整。

解决方案：

确认使用的是正确的 PingToken API Key。
检查账户订阅状态。
重新复制 API Key，确保完整且无空格。

报错 unexpected status 404 Not Found 怎么办？

原因：配置文件中的 base_url 或 wire_api 填写错误。

解决方案：确认 base_url 设置为 https://pingtoken.cn/api/v1。

Codex 连接超时怎么办？

常见原因及解决方案：

检查 base_url 配置：
确保使用可访问的公网地址，例如：
```
base_url = "https://pingtoken.cn/api/v1"
```
不推荐使用 http://43.138.167.74:5001/api/v1，因为可能受防火墙限制。
检查网络连接：
确保可以访问 pingtoken 服务。
切换 wire_api：
如果 Responses API 超时，可以尝试使用 Chat/Completions API（需要 Codex 0.80.0）：
```
wire_api = "chat"
```
验证 API Key：
确保环境变量 OPENAI_API_KEY 已正确设置，且 API Key 有效。
检查模型是否存在：
确保配置的模型 ID（如 deepseek-v4-flash）在 PingToken 平台中可用且已激活。

完整配置示例

[windows]
model = "deepseek-v4-flash"
model_provider = "pingtoken"
sandbox = "elevated"

[model_providers.pingtoken]
name = "pingtoken"
base_url = "https://pingtoken.cn/api/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

接入 Codex