在 Codex 客户端里使用本站 API
如果你使用的是 OpenAI Codex CLI 或 Codex 桌面客户端，可以把本站配置成一个自定义 OpenAI 兼容服务商。推荐新手先用 CC Switch 配置；熟悉文件配置的用户，也可以直接修改 ~/.codex/config.toml。
Claude Code 页面里通常填写 https://issueacard.top；Codex 的自定义 OpenAI provider 通常填写 https://issueacard.top/v1。如果少了 /v1，Codex 可能会请求到错误路径。
你需要准备什么
本站 API 密钥
进入左侧 API 密钥 页面，创建并复制一个 sk- 开头的密钥。
Codex 客户端
如果还没安装 Codex CLI，可以先安装官方客户端。安装后在终端运行 codex 启动。
可用模型名
新手建议先用 gpt-5.5。如果更想使用偏代码的模型，可以选择 gpt-5.3-codex 或 gpt-5.3-codex-spark。
安装 Codex CLI
如果电脑上还没有 Codex CLI，可以用 npm 安装：
npm i -g @openai/codex安装完成后检查版本：
codex --versionWindows 用户可以直接在 PowerShell 里运行；如果你使用 WSL2，也可以在 Linux 子系统里单独安装一份。
方式一：用 CC Switch 配置 Codex
新版 CC Switch 如果提供 Codex、OpenAI Compatible、Custom OpenAI Endpoint 或类似选项，可以直接用图形界面配置 Codex。推荐这样填：
- 配置名称
Issue A Card Codex- 客户端 / 工具
- Codex / OpenAI Compatible
- Base URL
https://issueacard.top/v1- API Key
- 你的
sk-开头 API 密钥 - 默认模型
gpt-5.5
打开 CC Switch
进入 Provider、Profile 或客户端配置页面，选择新增配置。
选择 Codex 或 OpenAI 兼容
如果列表里有 Codex，直接选 Codex；如果没有，就选 OpenAI Compatible 或自定义 OpenAI 服务商。
填写本站信息
Base URL 必须填 https://issueacard.top/v1，API Key 填你的 sk- 密钥，模型先填 gpt-5.5。
保存并应用到 Codex
保存后选择启用、切换或写入 Codex 配置。然后重新打开终端或重启 Codex 客户端。
先升级 CC Switch 到最新版。如果仍然没有 Codex 相关选项，就用下面的“手动修改配置文件”方式，效果是一样的。
方式二：手动修改 Codex 配置文件
Codex 的用户级配置文件通常在下面位置：
| 系统 | 配置文件位置 |
|---|---|
| macOS / Linux / WSL2 | ~/.codex/config.toml |
| Windows PowerShell | $env:USERPROFILE\.codex\config.toml |
如果你已经有自己的 Codex 配置，不要直接清空文件。先复制一份备份，再把下面配置合并进去。
macOS / Linux / WSL2 配置
先把密钥保存到环境变量。把示例里的 sk-你的密钥 换成你自己的密钥：
export ISSUEACARD_API_KEY="sk-你的密钥"如果希望每次打开终端都生效，可以把上面这一行加入 ~/.zshrc、~/.bashrc 或你正在使用的 shell 配置文件。
然后编辑 ~/.codex/config.toml，加入或调整为下面内容：
model = "gpt-5.5"
model_provider = "issueacard"
model_reasoning_effort = "high"
[model_providers.issueacard]
name = "Issue A Card"
base_url = "https://issueacard.top/v1"
env_key = "ISSUEACARD_API_KEY"
wire_api = "responses"Windows PowerShell 配置
先保存 API Key。执行后建议关闭并重新打开 PowerShell：
setx ISSUEACARD_API_KEY "sk-你的密钥"然后打开 Codex 配置文件：
notepad "$env:USERPROFILE\.codex\config.toml"把下面配置合并进去：
model = "gpt-5.5"
model_provider = "issueacard"
model_reasoning_effort = "high"
[model_providers.issueacard]
name = "Issue A Card"
base_url = "https://issueacard.top/v1"
env_key = "ISSUEACARD_API_KEY"
wire_api = "responses"多配置写法：保留官方登录，同时增加本站
如果你不想把本站设置成全局默认，可以只新增一个 profile。需要使用本站时，通过 profile 启动：
[model_providers.issueacard]
name = "Issue A Card"
base_url = "https://issueacard.top/v1"
env_key = "ISSUEACARD_API_KEY"
wire_api = "responses"
[profiles.issueacard]
model_provider = "issueacard"
model = "gpt-5.5"
model_reasoning_effort = "high"启动时使用：
codex --profile issueacard启动和测试
mkdir codex-test
cd codex-test
codex进入 Codex 后，先发一句简单测试：
你好，请用一句话说明你当前使用的模型配置。常见问题
提示没有 API Key
检查环境变量名是不是 ISSUEACARD_API_KEY，并确认终端已经重新打开。Codex 配置里的 env_key 必须和环境变量名一致。
提示 404 或接口不存在
优先检查 Base URL。Codex 这里要用 https://issueacard.top/v1，不要只填根地址。
提示模型不可用
回到 可用模型 页面复制模型名。最稳妥的测试模型是 gpt-5.5。
配置文件报 TOML 错误
通常是重复写了同一个顶层键，或者少了引号。只保留一个 model_provider，并确保字符串都用英文双引号包住。
如果只是想快速使用，优先走 CC Switch；如果需要精确控制模型、profile、环境变量，再手动改 config.toml。两种方式本质上都是让 Codex 指向本站的 OpenAI 兼容接口。