小蓝中转站使用文档

Windows 接入 Codex ​

前置条件

开始之前，确保你已经完成：

  1. ✅ 环境准备（PowerShell 策略 + Git + Node.js）
  2. ✅ 小蓝中转站 账号已注册并充值
  3. ✅ 已创建 API 密钥（以 sk- 开头的字符串）
  4. ✅ 已从模型广场复制模型名

还没做？先回 Windows 快速接入 的第一阶段。

第 1 步：安装 Codex ​

打开 PowerShell（建议以管理员身份运行）：

powershell
npm install -g @openai/codex@latest

安装完成后，关闭 PowerShell，重新打开一个新窗口，验证：

powershell
codex --version

应该输出版本号。如果提示命令不存在，检查 Node.js 是否安装成功（node -v），以及 npm 全局 bin 目录是否在 PATH 中。

第 2 步：创建配置文件 ​

Codex 的配置放在用户目录下的 .codex/config.toml 文件里。

先创建目录：

powershell
mkdir $env:USERPROFILE\.codex

用记事本创建配置文件：

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

记事本打开后，粘贴以下内容（把 从模型广场复制的模型名 替换成你实际复制的模型名）：

toml
model_provider = "xiaolan"
model = "从模型广场复制的模型名"
model_reasoning_effort = "high"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[model_providers.xiaolan]
name = "小蓝中转站"
base_url = "https://xiaolan.ainb.plus/v1"
wire_api = "responses"
env_key = "小蓝中转站_API_KEY"

保存并关闭记事本。

每一行的含义：

配置项含义注意
model_provider使用哪个服务商写 xiaolan，和下面 [model_providers.xiaolan] 对应
model默认使用的模型从模型广场复制的完整模型名
base_url小蓝中转站 网关地址必须带 /v1（和 Claude Code 不同！）
wire_api接口协议必须是 responses
env_keyKey 从哪个环境变量读取对应下一步设置的 小蓝中转站_API_KEY

Claude Code 和 Codex 的地址不同

  • Claude Code：https://xiaolan.ainb.plus（不加 /v1）
  • Codex：https://xiaolan.ainb.plus/v1（必须加 /v1）

写反了会报 404 错误。

第 3 步：设置 API Key 环境变量 ​

在 PowerShell 里执行（把 sk-你的专属Key 替换成你的真实 Key）：

powershell
[Environment]::SetEnvironmentVariable("小蓝中转站_API_KEY", "sk-你的专属Key", "User")

设置完后，关闭 PowerShell，打开一个新的，验证：

powershell
echo $env:小蓝中转站_API_KEY

应该输出你的 Key。如果输出为空，说明设置没成功。

第 4 步：测试 ​

创建一个测试目录，启动 Codex：

powershell
mkdir $env:USERPROFILE\xiaolan-codex-test
cd $env:USERPROFILE\xiaolan-codex-test
codex

Codex 启动后，输入一句话（比如「创建一个 hello world 的 Python 脚本」）。如果能返回修改计划，说明配置成功。

配置成功后，可以在真实项目目录里使用：

powershell
cd 你的项目目录
codex

常见问题 ​

现象可能原因怎么处理
Key 未生效环境变量没写入或没刷新重新执行第 3 步，关闭终端重开，用 echo $env:小蓝中转站_API_KEY 验证
TOML 配置文件报错格式不对检查 [model_providers.xiaolan] 的方括号、等号和引号是否完整
报 404 错误base_url 没有加 /v1确认配置里写的是 https://xiaolan.ainb.plus/v1
模型不存在模型名写错了回模型广场重新复制完整模型名
codex 命令不存在npm 安装没成功重新执行 npm install -g @openai/codex@latest，关闭终端重开

遇到以上方法无法解决的问题，去 排障手册 按层级排查。

小蓝中转站使用文档

© 2026 小蓝中转站