小蓝中转站使用文档

macOS 接入 Codex ​

前置条件

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

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

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

第 1 步：安装 Codex ​

打开终端，选一种方式安装：

方式一：npm（推荐）

bash
sudo npm install -g @openai/codex@latest

密码不会显示任何字符，直接输完按回车。

方式二：Homebrew

bash
brew install --cask codex

安装完成后验证：

bash
codex --version

应该输出版本号。如果提示命令不存在，关闭终端重新打开再试。

第 2 步：创建配置文件 ​

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

创建目录和文件：

bash
mkdir -p ~/.codex
nano ~/.codex/config.toml

nano 是终端里的文本编辑器。粘贴以下内容（把 从模型广场复制的模型名 替换成你的实际模型名）：

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"

保存：按 Control + O，然后按回车。退出：按 Control + X。

每一行的含义：

配置项含义注意
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 环境变量 ​

把 sk-你的专属Key 替换成你的真实 Key：

bash
echo 'export 小蓝中转站_API_KEY="sk-你的专属Key"' >> ~/.zshrc
source ~/.zshrc

用 Bash？

把 ~/.zshrc 换成 ~/.bashrc。不确定用的是哪个？执行 echo $SHELL 看输出。

验证：

bash
echo $小蓝中转站_API_KEY

应该输出你的 Key。如果为空，重新执行上面的命令或关闭终端重开。

第 4 步：测试 ​

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

bash
mkdir -p ~/xiaolan-codex-test
cd ~/xiaolan-codex-test
codex

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

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

bash
cd 你的项目目录
codex

常见问题 ​

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

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

小蓝中转站使用文档

© 2026 小蓝中转站