Codex 接入

Codex 是 OpenAI 官方的编程 Agent。它既有桌面端，也有 CLI。这里重点写 CLI，因为这是最适合接中转站和自定义 Base URL 的方式。

这篇文章会带你完成什么

1. 安装 Codex CLI
2. 找到本地 .codex 配置目录
3. 配置 Base URL 和 API Key
4. 完成第一次交互式使用

Codex 官方安装方式

如果你还没准备 Node 环境，先看 Node.js 开发环境准备。

官方 CLI 安装命令：

npm install -g @openai/codex

验证：

codex --help

如果命令能正常输出帮助信息，说明 CLI 已经安装好了。

你需要准备的内容

1. Base URL：https://tokenflash.cn/v1
2. API Key：你的 TokenFlash 密钥，格式一般以 sk- 开头

第一步：先创建 API Key

1. 打开 TokenFlash API 密钥页面
2. 创建一把新密钥
3. 记下这两个信息：
   • Base URL
   • API Key

第二步：先运行一次 Codex

这一步很重要。你需要先执行一次：

codex

这样它才会在你的用户目录下生成 .codex 配置目录。

常见位置：

• Linux / macOS：~/.codex
• Windows：C:\Users\你的用户名\.codex

如果你找不到这个目录，说明你还没真正执行过一次 codex。

第三步：编辑 Codex 配置

根据 OpenAI 官方文档，Codex 的用户级配置文件在：

• ~/.codex/config.toml

如果你只想先跑通，可以先用一份最小配置。

建议配置

model_provider = "OpenAI"
model = "gpt-5.6-sol"
review_model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://tokenflash.cn/v1"
wire_api = "responses"
requires_openai_auth = true

这份配置适合“先跑通再说”的用户。

更稳妥的写法

如果你想更接近官方文档里的 provider 配置方式，也可以写成：

model = "gpt-5.6-sol"
model_provider = "tokenflash"

[model_providers.tokenflash]
name = "TokenFlash"
base_url = "https://tokenflash.cn/v1"
env_key = "TOKENFLASH_API_KEY"
wire_api = "responses"

然后在环境变量里放密钥：

export TOKENFLASH_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

如果你当前版本的 Codex 对自定义 provider 支持不稳定，再回退到上面那份兼容思路即可。

第四步：配置 API Key

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

如果你不想把密钥写在文件里，也可以只保留环境变量写法。

第五步：重新启动 Codex

codex

重新进入后，如果能正常工作，就说明已经通过 TokenFlash 接好了。

第一次正式使用：一步一步来

1. 进入项目目录

cd your-project

2. 启动 Codex

codex

3. 先做一个低风险任务

请先帮我解释这个项目的目录结构

4. 再做一个轻量修改

请帮我给首页增加一句欢迎语

日常使用教程

cd your-project
codex

帮我解释这个仓库的核心结构

为这个项目补充一个登录失败重试提示，并告诉我改了哪些文件

常见问题

找不到 .codex/config.toml 怎么办？

先执行一次：

codex

退出后再去用户目录找。

为什么我建议先用最小配置？

因为 Codex 的配置能力很多，非技术用户一开始最容易被一大堆字段吓到。先跑通，再慢慢加规则。

常用能力

1. codex：进入交互模式
2. codex "你的问题"：单次执行
3. 使用截图或设计稿作为输入
4. 在大型任务里用多轮对话持续推进

Windows 使用建议

OpenAI 官方文档对 Windows 的建议是：

1. 可以原生跑 Windows
2. 也可以在 WSL2 里跑
3. 如果你更熟悉 Linux 工具链，WSL2 会更稳

可选：桌面版

如果你想试桌面版，也可以看官方入口：

• https://chatgpt.com/zh-Hans-CN/codex