Codex Mac使用指南 --知识铺

Codex Mac 使用指南

(一) 安装 Node.js 环境

Codex 需要 Node.js 环境才能运行（版本要求 ≥18）。

macOS 安装方法

方法一：使用 Homebrew（推荐）

如果你已经安装了 Homebrew，使用它安装 Node.js 会更方便：

bash

# 更新 Homebrew
brew update
# 安装 Node.js
brew install node

方法二：官网下载

访问 https://nodejs.org/
下载适合 macOS 的 LTS 版本
打开下载的 .pkg 文件
按照安装程序指引完成安装

macOS 注意事项

如果遇到权限问题，可能需要使用 sudo
首次运行可能需要在系统偏好设置中允许
建议使用 Terminal 或 iTerm2

验证安装是否成功

安装完成后，打开 Terminal，输入以下命令：

bash

node --version
npm --version

如果显示版本号，说明安装成功了！

(二) 安装 Codex CLI

安装 Codex CLI

打开 Terminal，运行以下命令：

1
2


# 全局安装 Codex
npm i -g @openai/codex --registry=https://registry.npmmirror.com

如果遇到权限问题，可以使用 sudo：

1

sudo npm i -g @openai/codex --registry=https://registry.npmmirror.com

验证安装

安装完成后，输入以下命令检查是否安装成功：

1

codex --version

如果显示版本号，恭喜你！Codex 已经成功安装了。

(三) 配置 Codex 环境变量

方法一：使用 cc switch 配置（强烈推荐）

查看 cc switch 配置文档

方法二：临时设置（当前会话有效）

在 Terminal 中运行以下命令：

1
2


export OPENAI_BASE_URL="https://www.88code.org/openai/v1"
export OPENAI_API_KEY="你的API密钥"

注意：API 密钥格式如 88_xxxxxxxxxx

方法三：永久设置（推荐）

添加到你的 shell 配置文件：

对于 zsh (默认)：

1
2
3


echo 'export OPENAI_BASE_URL="https://www.88code.org/openai/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

对于 bash：

1
2
3


echo 'export OPENAI_BASE_URL="https://www.88code.org/openai/v1"' >> ~/.bash_profile
echo 'export OPENAI_API_KEY="你的API密钥"' >> ~/.bash_profile
source ~/.bash_profile

验证环境变量

在 Terminal 中验证：

1
2


echo $OPENAI_BASE_URL
echo $OPENAI_API_KEY

文章目录