macOS 从零接入

开始前：准备自己的密钥

先完成 创建 API 密钥。以下操作都在你自己的 Mac 上进行。

1. 下载并安装 Node.js

1. 打开下载页，选择 macOS 的 LTS 安装程序 .pkg。
2. 双击安装包，按“继续 → 同意 → 安装”完成；需要时输入你自己的 Mac 开机密码。
3. 安装后关闭已有的终端窗口，再打开新窗口。

2. 打开“终端”并检查

同时按 ⌘ + 空格，输入“终端”或 Terminal，按回车。把下面命令复制进去并回车：

node -v
npm -v

3. 安装 Codex

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

如果出现 EACCES 权限错误，用自己的用户目录安装，再检查：

mkdir -p "$HOME/.local"
npm config set prefix "$HOME/.local"
printf '\nexport PATH="$HOME/.local/bin:$PATH"\n' >> "$HOME/.zshrc"
export PATH="$HOME/.local/bin:$PATH"
npm install -g @openai/codex
codex --version

4. 打开配置文件

在终端粘贴下面两行：

mkdir -p "$HOME/.codex"
nano "$HOME/.codex/config.toml"

屏幕会进入一个文字编辑器。新手第一次使用时，把下面整块内容粘贴进去：

model = "gpt-6.1-sol"
model_provider = "easycode"

[model_providers.easycode]
name = "EasyCode"
base_url = "https://easycodesi.com/v1"
wire_api = "responses"
env_key = "EASYCODE_API_KEY"
requires_openai_auth = false
supports_websockets = false

保存顺序：按 Control + O（字母 O）→ 按回车确认文件名 → 按 Control + X 退出。这里用的是 Control，不是 Command。

5. 设置密钥，保存到下次使用

先把下面占位符换成自己的完整密钥，保留英文引号，再执行：

export EASYCODE_API_KEY="sk-替换为你的密钥"

要让以后新开的终端也记住它，执行：

nano "$HOME/.zshrc"

到文件末尾新加一行，内容与上面完全相同（export EASYCODE_API_KEY="你的完整密钥"），再按 Control+O、回车、Control+X 保存退出。若已经有同名变量，修改原来的那一行。

6. 启动并发送第一句话

mkdir -p "$HOME/easycode-demo"
cd "$HOME/easycode-demo"
codex

首次询问是否信任目录时，确认是刚创建的练习文件夹后按提示确认。在对话框输入：

请只回复：连接成功

7. 以后怎么打开

打开“终端”，输入 codex。如果提示缺少密钥，检查第 5 步是否保存到了 .zshrc；使用 Bash 的用户应把同一行保存到自己的 Bash 启动配置中。

处理代码项目：检查 Git

运行 git --version。如果 Mac 弹出命令行工具安装提示，点击“安装”，完成后再运行一次确认版本号。需要其他方式可查看 Git 官方 Mac 安装页 ↗。