Appearance
一键脚本配置
这是最简单的配置方式，官方提供脚本自动完成所有环境配置，无需手动修改任何文件。
整个过程大约 2 分钟，跟着步骤一步一步来即可。
第一步：登录控制台
购买订阅后，访问 codexzh.com/console，登录并进入控制台。
第二步：下载脚本
在「API 密钥管理」页面，点击「一键配置脚本」按钮，选择你的操作系统对应版本下载。
- macOS → 下载
.sh脚本文件 - Windows → 下载
.bat脚本文件
下载后，文件通常保存在你电脑的**「下载」文件夹**里。
第三步：运行脚本
根据你的操作系统，选择对应的操作方式：
macOS 用户
1. 打开终端
终端（Terminal）是 Mac 内置的命令行工具，你需要用它来运行脚本。
打开方式：
- 按下键盘 ⌘（Command）+ 空格，输入「终端」或「Terminal」，回车打开
- 或打开「启动台」，在搜索框输入「终端」
打开后会出现一个带光标的黑色或白色窗口，这就是终端。
2. 进入下载目录
在终端里输入以下内容，按回车：
bash
cd ~/Downloadscd 的意思是「进入某个文件夹」，~/Downloads 就是你的下载文件夹。执行后没有任何提示、光标跳到下一行，就说明成功了。
脚本保存在其他位置？
把 ~/Downloads 替换成脚本所在的路径即可，例如 cd ~/Desktop 表示切换到桌面。
3. 运行脚本
输入以下命令，按回车：
bash
bash setup-codexzh-mac.sh脚本会自动完成所有配置，通常只需几秒钟。
4. 遇到权限不足（Permission denied）
如果终端出现类似下面的错误：
Permission denied说明脚本需要更高的系统权限，在命令前加 sudo 重新运行：
bash
sudo bash setup-codexzh-mac.sh5. 输入密码
加了 sudo 后，终端会提示：
Password:密码输入时光标不会移动，这是正常的
Mac 出于安全设计，输入密码时不会显示任何字符，也不会有 * 号，看起来像是没有在输入。直接输完你的 Mac 登录密码，然后按回车即可。如果输错了，重新运行命令再输一次。
6. 确认完成
终端没有报错提示，或显示类似「配置完成」的字样，就说明脚本运行成功。关闭终端窗口即可。
Windows 用户
1. 找到脚本文件
打开「文件资源管理器」，点击左侧的「下载」，找到刚才下载的 .bat 文件。
2. 双击运行
直接双击 .bat 文件，脚本会自动运行。
3. 遇到安全警告
Windows 可能弹出「Windows 已保护你的电脑」提示，这是系统对未经微软认证的脚本的默认警告，不影响使用。
处理方式：点击「更多信息」→ 点击「仍然运行」
4. 遇到管理员权限弹窗
若弹出「用户账户控制」窗口，点击「是」即可。
5. 窗口自动关闭
脚本运行结束后，命令行窗口会自动关闭，这是正常现象，说明已运行完成。
第四步：重启 Codex
脚本运行完成后，完全退出并重新启动 Codex，配置即可生效。
如何完全退出？
不要只是关闭窗口——需要彻底退出程序。Mac 用户可以右键点击 Dock 上的 Codex 图标，选择「退出」；Windows 用户右键任务栏图标选择「退出」。
常见问题
Q：终端在哪里？
终端是 Mac 自带的工具。按 ⌘+空格 打开 Spotlight，输入「终端」回车即可打开。
Q：输入密码时什么都看不到，光标也不动，是不是坏了？
没有坏。Mac 的安全设计让密码输入完全隐藏，不显示任何字符（包括 *）。直接输完密码按回车就行，系统已经接收到了你的输入。
Q：运行脚本时提示 Permission denied，怎么办？
在命令前加 sudo：
bash
sudo bash setup-codexzh-mac.sh然后输入 Mac 密码（不显示，输完回车）。
Q：Windows 弹出「此应用无法运行」或安全警告，怎么处理？
点击「更多信息」，再点「仍然运行」即可。这只是 Windows 的默认安全提示，不代表文件有问题。
Q：Windows 上脚本运行完窗口直接关了，是成功了吗？
是的。Windows 脚本运行完成后窗口自动关闭是正常行为。之后重启 Codex 即可。