苹果用户（macOS）

Codex CLI 支持 macOS。下面的命令在“终端”（Terminal）中执行，不要使用 Windows PowerShell 的 winget 命令。

1. 安装 Homebrew

如果已经安装过 Homebrew，可以跳过这一步。没有安装时，在终端执行官方安装命令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

官方地址：brew.sh。安装结束后按终端提示把 Homebrew 加入 PATH。

2. 安装 Node.js 和 Git

brew install node git

检查版本：

node --version
npm --version
git --version

三个命令都能返回版本号后继续。

3. 安装 Codex CLI

npm install -g @openai/codex
codex --version

看到 codex-cli 和版本号，就说明安装成功。然后进入配置 CCS / API。

macOS 常见问题

提示没有权限写入 npm 全局目录

优先检查 Node.js 是否由 Homebrew 安装：

which node
which npm

如果路径不是 Homebrew 目录，建议重新安装 Node.js，避免直接对系统目录执行大量 sudo 命令。

Mac 可以使用 CCS 吗？

取决于 CCS 是否提供 macOS 版本。若没有 Mac 客户端，可以直接使用 Codex CLI，并按 API 配置 填写兼容接口。

WARNING

这里的苹果用户指 macOS 电脑。iPhone 和 iPad 不能直接运行 Codex CLI。