如果你想在终端或 VSCode 扩展里使用 Codex，并通过 Nbility 转发模型请求，可以按下面的方式完成配置。
安装 Codex
任选一种安装方式即可：
pnpm install -g @openai/codex
npm install -g @openai/codex
yarn global add @openai/codex
bunx --global @openai/codex
准备认证信息
开始前请先确认以下内容已经准备好：
- 已拥有可用的 Nbility 账号
- 已在控制台创建令牌
- 令牌仍然有效且余额充足
令牌可以在 /console/token 页面获取。如果你还没完成这一步，建议先阅读 快速开始 或 新手指南。
配置 Codex CLI
先创建 ~/.codex/config.toml，写入类似下面的内容：
model = "gpt-5.3-codex"
model_provider = "nbility"
preferred_auth_method = "apikey"
[model_providers.nbility]
name = "OpenAI using Chat Completions"
base_url = "https://api.nbility.dev/v1"
wire_api = "responses"
query_params = {}
stream_idle_timeout_ms = 300000
然后再创建 ~/.codex/auth.json，把其中的 Key 换成你自己的令牌：
{
"OPENAI_API_KEY": "your_api_key_here"
}
启动方式
进入任意项目目录后，直接执行：
cd my-project
codex
如果能正常进入交互界面，并成功调用模型，就说明 CLI 端已经配置完成。
在 VSCode 中使用
如果你同时安装了 Codex 的 VSCode 扩展，也可以复用同一套 Nbility 接口。
大致流程如下：
- 安装 Codex 扩展
- 打开 VSCode 设置，并切换到 JSON 编辑模式
- 补充扩展所需的 Base URL 和认证配置
可参考如下设置：
{
"chatgpt.apiBase": "https://api.nbility.dev/v1",
"chatgpt.config": {
"preferred_auth_method": "api_key",
"model_provider": "nbility"
}
}
完成后点击扩展入口，选择对应模型即可开始使用。
使用建议
- 给 Codex 单独创建一个令牌，便于统计消耗
- 如果主要使用 GPT 系列，可以先从默认配置开始，不必一次加入过多模型
- CLI 和 VSCode 都依赖同一个接口时，建议先在 CLI 验证成功，再接入编辑器