外观
ChatGPT / Codex 配置
本页覆盖两件事,不要混:
| 产品 | 能否接本站 | 怎么接 |
|---|---|---|
| ChatGPT 官方 App / chatgpt.com | 不能 | 官方客户端没有「自定义 Base URL」。它只连 OpenAI。要用本站模型,请用 Codex CLI、本站控制台,或 通用 OpenAI 客户端 |
| Codex CLI / Codex 桌面(编程代理) | 能 | 用户级 ~/.codex/config.toml + auth.json,wire_api = "responses" |
默认模型推荐 gpt-5.6-sol(以 /v1/models 为准)。令牌分组:ChatGPT-Main 或 ChatGPT-DR。
快速字段
| 项 | 值 |
|---|---|
| base_url | https://api.ashpetals.com/v1(必须含 /v1) |
| wire_api | responses |
| API Key | OPENAI_API_KEY 或 ~/.codex/auth.json |
| 模型示例 | gpt-5.6-sol |
| 协议 | POST /v1/responses |
官方配置参考:https://learn.chatgpt.com/docs/config-file/config-advanced
图形界面(Codex 桌面 / CC Switch)
Codex 桌面若提供「自定义供应商 / Custom provider」:
- 打开设置 → 模型供应商 / Providers。
- 添加自定义供应商(不要占用内置 id:
openai/ollama/lmstudio)。 - Base URL:
https://api.ashpetals.com/v1 - API Key:
sk-你的APIKey - 线路 / wire:Responses
- 默认模型:
gpt-5.6-sol - 完全退出并重开 Codex(热重载经常不生效)。
更省事:用 CC Switch 桌面 顶部选 Codex → 添加供应商 → 上游 Responses(原生) → 启用 → 重开终端。
ChatGPT 网页 / 官方移动 App 没有这一步,不要在里面找 Base URL。
命令行 / 配置文件(Codex CLI)
安装 Codex CLI
按 OpenAI 当前文档安装 codex 命令(npm / 官方安装器均可)。本页只写接本站。
配置文件路径
| 系统 | config.toml | auth.json |
|---|---|---|
| macOS / Linux | ~/.codex/config.toml | ~/.codex/auth.json |
| Windows | %USERPROFILE%\.codex\config.toml | %USERPROFILE%\.codex\auth.json |
必须写用户级目录。 项目内 .codex/config.toml 会忽略 model_provider / model_providers / openai_base_url 等密钥与供应商字段。
config.toml
toml
model_provider = "ashpetals"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
[model_providers.ashpetals]
name = "AshPetals API"
base_url = "https://api.ashpetals.com/v1"
wire_api = "responses"
requires_openai_auth = true已有其它自定义段时,只追加 [model_providers.ashpetals],把顶层 model_provider / model 改过来,不要整文件覆盖。
API 密钥
~/.codex/auth.json:
json
{
"OPENAI_API_KEY": "sk-你的APIKey"
}也可以只设环境变量(当前 shell 生效,适合 CI):
bash
export OPENAI_API_KEY="sk-你的APIKey"
# 不要用 openai_base_url 环境变量替代 model_providers;以 config.toml 为准启动
bash
codex
# 会话中发送:你好改完配置必须 新开终端。旧进程会继续打官方 api.openai.com。
用 CC Switch CLI 导入
bash
cc-switch --app codex provider add
cc-switch --app codex provider switch <id>
# 或只启动一次、不改全局
cc-switch start codex交互添加时:地址 https://api.ashpetals.com/v1,格式 Responses,Key 为 sk-…。详见 CC Switch。
opencodex(本地仪表盘,适合在 Codex 里路由多模型):
bash
npm i -g @bitkyc08/opencodex
ocx start # http://localhost:10100仪表盘添加 https://api.ashpetals.com/v1 + Key。文档:https://opencodex.me
在 Codex 里用本站 Claude(可选)
本站 Claude 走 Anthropic Messages。需要本地路由把 Responses ↔ Messages 互转,见 CC Switch 跨协议。
验证
bash
codex
# 你好bash
curl -sS https://api.ashpetals.com/v1/responses \
-H "Authorization: Bearer sk-你的APIKey" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","input":"ping"}'注意事项
- ChatGPT 官方 App ≠ Codex。前者不能填本站。
base_url必须包含/v1,wire_api使用responses(不要填chat)。- 自定义供应商 id 不要用
openai/ollama/lmstudio。 - 模型必须在令牌分组可访问列表内。
- 切换供应商后务必重启 Codex 进程。
- 不要将
auth.json或真实 API Key 提交到 Git。 - Shell 里残留的
OPENAI_API_KEY/OPENAI_BASE_URL可能覆盖文件,排查时先env | grep OPENAI。