Codex配置教程2026最新版：从安装到Token优化一步到位

「Codex怎么配置？」这个问题在2026年的搜索量是2025年的3倍——因为现在大家知道Codex好用了，但卡在配置这一步。Node.js版本不对、环境变量写错位置、Key复制少了字符、Base URL漏了https。这篇文章就是来解决这些问题的，每一步都有验证命令，配到哪卡住了马上能查出来。

一、Codex是什么、需要什么前置条件

Codex是OpenAI出品的命令行AI编程助手。它运行在终端里，能读文件、写代码、跑Shell命令、操作Git——你只需要用自然语言描述需求。

前置条件就两个：Node.js >= 18 和 一个API Key。Key的获取方式：打开 api.bblabu.cn 注册，在「令牌管理」创建Key。一个Key同时支持GPT-5.5和Claude 4.7。

二、安装Node.js

node --version  # 如果 >= 18 就跳过本节
# 如果没装或版本太低，去 https://nodejs.org 下载 LTS 版本
# 安装后再次确认
node --version
npm --version

三、安装Codex

npm install -g @openai/codex
codex --version  # 验证安装

四、配置API Key和Base URL

最重要的一步。把以下两行加到你的Shell配置文件：

# macOS/Linux: 编辑 ~/.zshrc 或 ~/.bashrc
export OPENAI_API_KEY="sk-你的Key"
export OPENAI_BASE_URL="https://api.bblabu.cn"

# 国内加速线路（可选，延迟更低）
# export OPENAI_BASE_URL="https://api.kkkliao.cn"

# 使配置生效
source ~/.zshrc

验证配置是否正确：

echo $OPENAI_API_KEY  # 应该输出 sk- 开头的Key
echo $OPENAI_BASE_URL  # 应该输出 https://api.bblabu.cn

五、Config.toml高级配置

除了环境变量，Codex还支持通过 config.toml 做更精细的配置：

# ~/.codex/config.toml
model = "gpt-5.5"
model_context_window = 1047576
model_auto_compact_token_limit = 900000

这个配置设置了自动上下文压缩——当对话历史接近90万Token时自动压缩，避免请求体积过大。

六、启动和测试

codex
# 输入测试指令
> 用 Python 写一个快速排序算法，加上注释

如果Codex开始输出代码并成功执行，配置完成。

七、常见错误速查

八、Token消耗和费用

通过API中转站接入Codex，GPT-5.5百万Token约¥0.83，日常编码一个月150万Token花费不到¥2。同样的Token量走官网要¥140+。

在 api.bblabu.cn 控制台可查看每笔调用的Token消耗和费用明细，按令牌追踪，花多少钱一清二楚。

本文链接：https://www.kkkliao.cn/?id=3944 转载需授权！