Skip to content

一键脚本配置 ​

对应控制台「配置客户端」里的 Mac/Linux 一键配置 和 Windows 一键配置。下载脚本运行一次,配置自动写入用户目录下的 .codex 文件夹,大约 2 分钟。

还没买套餐的先完成 购买套餐。


第一步:登录控制台 ​

购买订阅后,访问 codexzh.com/console,登录并进入控制台。


第二步:下载脚本 ​

在控制台「配置客户端」区域,点 Mac/Linux 一键配置 或 Windows 一键配置,下载对应脚本。

  • macOS → 下载 .sh 脚本文件
  • Windows → 下载 .bat 脚本文件

下载后,文件通常保存在**「下载」文件夹**里。


第三步:运行脚本 ​

macOS 用户 ​

1. 打开终端 ​

终端(Terminal)是 Mac 内置的命令行工具。

打开方式:

  • 按下 ⌘(Command)+ 空格,输入「终端」或「Terminal」,回车打开
  • 或打开「启动台」,在搜索框输入「终端」

2. 进入下载目录 ​

bash
cd ~/Downloads

执行后没有任何提示、光标跳到下一行,说明成功。

脚本保存在其他位置?

把 ~/Downloads 替换成脚本所在的路径即可,例如 cd ~/Desktop 表示切换到桌面。

3. 运行脚本 ​

bash
bash setup-codexzh-mac.sh

脚本自动完成所有配置,通常只需几秒钟。

4. 遇到权限不足(Permission denied) ​

如果终端出现:

Permission denied

在命令前加 sudo 重新运行:

bash
sudo bash setup-codexzh-mac.sh

5. 输入密码 ​

加了 sudo 后,终端会提示:

Password:

密码输入时光标不会移动,这是正常的

Mac 出于安全设计,输入密码时不会显示任何字符,也不会有 * 号。直接输完你的 Mac 登录密码,然后按回车即可。如果输错了,重新运行命令再输一次。

6. 确认完成 ​

终端没有报错提示,或显示类似「配置完成」的字样,说明脚本运行成功。关闭终端窗口即可。


Windows 用户 ​

1. 找到脚本文件 ​

打开「文件资源管理器」,点击左侧的「下载」,找到刚才下载的 .bat 文件。

2. 双击运行 ​

直接双击 .bat 文件,脚本会自动运行。

3. 遇到安全警告 ​

Windows 可能弹出「Windows 已保护你的电脑」提示,这是系统对未经微软认证的脚本的默认警告,不影响使用。

处理方式:点击「更多信息」→ 点击「仍然运行」

4. 遇到管理员权限弹窗 ​

若弹出「用户账户控制」窗口,点击「是」即可。

5. 窗口自动关闭 ​

脚本运行结束后,命令行窗口会自动关闭,这是正常现象,说明已运行完成。


第四步:重启 Codex ​

脚本运行完成后,完全退出并重新启动 Codex(ChatGPT 客户端、CLI 或 VSCode 插件),配置即可生效。ChatGPT 客户端记得在左上角切到 Codex 模式,见 快速使用。

想把默认模型改成 Grok 等其他型号,见 模型与切换。

如何完全退出?

不要只是关闭窗口,得彻底退出程序。Mac 用户右键点击 Dock 上的图标选择「退出」,或按 Command + Q;Windows 用户到屏幕右下角托盘找到图标,右键选择「退出」。

配置不生效或启动后报错,见 错误排查指南。