两种方式，任选其一

Codex 接入

Codex 的桌面 App、VSCode 插件、命令行都读同一份配置，所以配置一次，三个都能用。

先选一种方式

用 CC Switch 配置

推荐新手首选

图形界面填三个值就行——不用开终端、不用设环境变量、不用手写 TOML。在 CC Switch 里把应用选成 Codex，然后填 Base URL https://issueacard.top/v1（要带 /v1）、你的 sk- 密钥、模型 gpt-5.6-sol。

去看 CC Switch 教程（含下载安装）→

手动配置

进阶

自己设环境变量、手写 config.toml。适合想完全掌控配置、或 CC Switch 装不上的情况。就在本页，从下面第 1 步开始。

两种方式都需要先装好 Codex 本体（下面第 1 步）。

先把这三个值准备好

Base URL：https://issueacard.top/v1（要带 /v1）　·　API 密钥：你的 sk- 开头密钥（在 API 密钥页创建）　·　模型名：gpt-5.6-sol

第 1 步：下载并安装 Codex

从官方地址下载安装，装好后先打开一次，确认能正常启动：

官方安装说明（含各平台）: https://developers.openai.com/codex/
官方发布下载页: github.com/openai/codex/releases/latest
VSCode 插件: https://developers.openai.com/codex/ide/

已经装过 Codex 的可以直接跳到第 2 步。官方账号登录与否都不影响，本站是作为另一个服务商加进去的。

下面是「方式二：手动配置」的步骤

如果你选的是方式一 CC Switch，装好 Codex 本体后就可以直接去那一页了，第 2、3 步都不用做。

第 2 步：把密钥保存为环境变量

Codex 不支持把密钥直接写在配置文件里，需要先存成环境变量。把 sk-你的密钥 换成你自己的密钥，复制整行执行：

Windows（在 PowerShell 里执行）：

setx ISSUEACARD_API_KEY "sk-你的密钥"

macOS / Linux（在终端里执行）：

echo 'export ISSUEACARD_API_KEY="sk-你的密钥"' >> ~/.zshrc

执行完先别急着用，第 4 步会让它生效。

第 3 步：填写配置文件

用记事本打开 Codex 的配置文件（文件或文件夹不存在就自己新建一个）：

Windows：

notepad "$env:USERPROFILE\.codex\config.toml"

macOS / Linux：

open -e ~/.codex/config.toml

把下面内容粘贴进去，保存：

model = "gpt-5.6-sol"
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"

如果文件里原本已有内容

不要清空重写。先复制一份备份，再把上面内容合并进去，并确保 model 和 model_provider 各自只出现一次。

第 4 步：重启并测试

完全退出 Codex App（不是关窗口，要彻底退出）再重新打开——环境变量需要重启后才生效。命令行用户则关掉终端重开。

然后发一句话测试：

你好，请用一句话说明你正在使用的模型

能正常回复就说明接好了。之后在可用模型页可以换成别的模型名。

遇到问题看这里

提示没有 API Key

环境变量还没生效。彻底退出 App 重开，还不行就重启电脑；并确认变量名和配置里的 env_key 完全一致（都是 ISSUEACARD_API_KEY）。

提示 404 / 接口不存在

Base URL 少写了 /v1。这里必须是 https://issueacard.top/v1。

提示模型不可用

模型名写错了。回可用模型页原样复制，最稳的是 gpt-5.6-sol。

提示配置文件格式错误

TOML 语法问题。检查是不是重复写了同一项，以及所有引号都是英文双引号。

还搞不定就找人工客服，带上报错截图，全程免费协助。

进阶：想保留官方登录，只在需要时用本站

不想把本站设成默认的话，改成新增一个 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.6-sol"
model_reasoning_effort = "high"

命令行启动时加上 profile 即可：

codex --profile issueacard

用 npm 装命令行版：npm i -g @openai/codex，装完用 codex --version 检查。