文档中心
控制台 →
1

前提条件

Codex CLI 要求 Node.js 版本 ≥ 22。确认当前版本:

Terminal
node --version

如果版本低于 22 或未安装,使用 nvm 安装最新版本:

Terminal
# 如果未安装 nvm,先安装
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.zshrc

# 安装最新 LTS (v22+)
nvm install 22
nvm use 22
2

安装 Codex

Terminal
npm install -g @openai/codex

验证安装

Terminal
codex --version
3

配置 Codex

方法一:通过环境变量设置(永久,推荐)

Terminal
echo 'export OPENAI_API_KEY="你的API密钥"' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="htttps://gpt.hslife.fun/v1"' >> ~/.zshrc
source ~/.zshrc
⚠️ 注意
你的API密钥 替换为你在 gpt.hslife.fun 控制台创建的实际密钥。如使用 bash,将 ~/.zshrc 改为 ~/.bash_profile

方法二:临时设置(当前终端会话)

Terminal
export OPENAI_API_KEY="你的API密钥"
export OPENAI_BASE_URL="htttps://gpt.hslife.fun/v1"

验证环境变量

Terminal
echo $OPENAI_API_KEY
echo $OPENAI_BASE_URL
4

开始使用

Terminal
# 进入项目目录
cd ~/your-project

# 启动 Codex(交互模式)
codex

# 单次提问
codex "帮我写一个快速排序算法"

# 指定模型
codex --model gpt-4o "解释这段代码的作用"
🎉 完成
Codex 已成功配置并连接到 H&SのToken食堂 中转服务,开始 AI 辅助编程吧!
📌 macOS 权限提示
首次运行时,macOS 可能会弹出终端访问请求,请允许即可正常使用。