← 返回首页

macOS / Linux Codex 安装指南

系统要求：macOS 10.15+ 系统，或 Linux 系统。从环境准备到安装验证的完整步骤。

安装前环境准备
1
此步骤在桌面下载 Git
访问 https://git-scm.com/downloads/win ，安装时全都下一步，不要修改路径。
2
此步骤在桌面下载 Node.js
访问 https://nodejs.org/zh-cn/download ，安装时全都下一步，不要修改路径。
安装步骤
★
安装 Codex 官方原版包
npm install -g @openai/codex
# 或者
brew install codex
2
创建目录
rm -rf ~/.codex
mkdir ~/.codex
3
登录网站
访问 https://niuflu.com/console ，在令牌管理处，添加令牌并复制密钥出来。
4
创建 auth.json 文件
删除 ~/.codex 路径下已存在的 auth.json 文件（若有），然后新建一个 auth.json，内容为：
{
  "OPENAI_API_KEY": "你的 API_KEY"
}
5
创建 config.toml 文件
删除 ~/.codex 路径下已存在的 config.toml 文件（若有），然后新建一个 config.toml，内容直接复制下方配置：
model_provider = "NiuFlu"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.NiuFlu]
name = "NiuFlu"
base_url = "https://niuflu.com/v1"
wire_api = "responses"
6
验证安装
重启终端后运行：
codex -V
开始使用
进入项目文件夹后执行 codex 即可启动，完整支持 VSCode 官方插件。
cd 你的项目文件夹
codex