Codex Mac 安装说明

这个说明是给使用 Mac 的同学看的。

下载 codex-config-mac.zip — 内含 install-codex-config.command 与 CODEX_SETUP_README.md，解压后即可使用。

你会拿到一个文件（或从压缩包中解压得到）：

install-codex-config.command

可选阅读同目录下的 CODEX_SETUP_README.md（与网页版说明一致）。

它的作用很简单：

自动创建 ~/.codex 文件夹
自动生成 auth.json
自动生成 config.toml
如果你原来已经有同名文件，会先帮你备份，再覆盖

怎么运行

第 1 步：把文件放到电脑里

比如放到 Downloads 下载目录。

第 2 步：打开终端

Mac 打开终端的方法：

按 Command + 空格
输入 Terminal
回车

第 3 步：执行命令

如果文件在下载目录，直接复制这条命令：

bash ~/Downloads/install-codex-config.command

如果文件不在下载目录，就把上面的路径改成你自己的文件路径。

第 4 步：输入你的 Key

执行后，终端会提示：

请输入你的 OpenAI API Key:

这时候把你的 key 粘贴进去，然后按回车。

注意：

输入的时候屏幕上不会显示内容
这是正常的，不是卡住了
直接粘贴，按回车就行

第 5 步：完成

如果成功，你会看到类似提示：

Codex 配置已写入 /Users/你的用户名/.codex
auth.json -> /Users/你的用户名/.codex/auth.json
config.toml -> /Users/你的用户名/.codex/config.toml

说明已经装好了。

常见问题

1. 提示 `No such file or directory`

意思就是文件路径写错了。

比如你的文件不在 Downloads，那就不能用：

bash ~/Downloads/install-codex-config.command

要改成真实路径。

2. 输 key 的时候没有显示

这是正常的。

终端为了安全，不会把输入的 key 显示出来。直接输入完按回车就行。

3. 原来有配置会不会丢

不会直接丢。

脚本会先备份旧文件，名字大概像这样：

auth.json.bak.20260331-112233
config.toml.bak.20260331-112233

一句话版本

对方只需要做两件事：

打开终端
执行 bash ~/Downloads/install-codex-config.command，然后输入自己的 key