秒码 · Codex 使用教程

👇 技术客服二维码【以防失联】【有不定时送 token 活动】

接口地址（Base URL）：https://sub.miaoma.ai/v1 模型说明：平台支持多种模型，默认使用 gpt-5.6-terra（GPT-5.6 Terra）；以上仅为常用示例，不代表全部。完整可用模型请在 Codex 中输入 /model 查看。 额度查询：https://sub.miaoma.ai/q/

🚀 快速开始：选择你的系统

📌 使用前必读（风险与安全提示）

• 任何 AI 都有改错或修改失败的风险，不能接受请勿购买，珍惜彼此时间，可联系客服按剩余天数退款。
• 请勿在生产环境直接让 AI 改动重要代码，重要数据请先备份 / 用 Git 管理。
• 请勿在请求中粘贴账号密码、密钥、证书等敏感信息；如已粘贴，请及时更换。
• 本店仅售卖接口，技术问题提供友情协助，并非万能。

一、Windows 一键配置（保姆级）

2026-10-22 更新：一键安装已支持检测并修复 Codex 缺失依赖。首次安装或遇到 Missing optional dependency，都使用下面同一条命令。

第 1 步：以管理员身份打开 PowerShell

• 左下角「开始」菜单，键盘直接输入 powershell
• 在「Windows PowerShell」上右键 → 以管理员身份运行
• 弹出「是否允许此应用对你的设备进行更改？」→ 点「是」

第 2 步：粘贴运行安装命令

复制下面这行，在 PowerShell 窗口里右键粘贴，回车：

irm https://sub.miaoma.ai/codex/install.ps1 | iex

脚本会自动完成：检查或安装 Node.js、Git → 检查 Codex 能否启动 → 安装或修复 Codex → 输入 Key 并写好配置。若弹管理员授权窗口，点「是」。下载时间取决于网络，请等待当前步骤完成。

• 开头应显示「安装脚本版本: 2026-10-22.1」。
• 已安装但无法启动时，脚本会自动重装 Codex 并安装所需依赖。
• 国内镜像安装或启动验证失败时，会自动切换到 npm 官方源重试。
• 两个源都失败时会停止，不会提示「配置完成」。请保留完整报错并联系客服。

第 3 步：输入你的 Key

出现 请粘贴你购买的 API Key (sk- 开头) 时，粘贴你购买的 Key 回车。

重跑修复后也请按提示输入秒码 Key，脚本会重新写入秒码接口配置。如果已有自定义配置，请先备份用户目录下的 .codex/config.toml 和 .codex/auth.json。

第 4 步：完成 & 使用

看到「Codex 启动验证通过」或「Codex 安装及启动验证通过」，并在输入 Key 后看到「配置完成！」，表示本地安装与配置已完成。新开一个 PowerShell 窗口，先检查版本：

codex.cmd --version

显示 codex-cli 和版本号后，再启动：

codex.cmd

进入后发送一句「你好」确认接口可用。输入 /model 回车可切换模型。codex.cmd 可避免 PowerShell 对 codex.ps1 启动器的执行策略拦截；原来的 codex 命令能正常运行时也可继续使用。

遇到「Missing optional dependency」怎么办？

例如 Missing optional dependency @openai/codex-win32-x64，表示 Codex 的 Windows 运行程序缺失。请先在管理员 PowerShell 中重新运行第 2 步的一键命令，让新版脚本自动修复。

如果自动修复仍失败，可使用下面的官方源手动重装。逐行执行，任一步报错就停止，保留完整输出：

npm.cmd uninstall -g @openai/codex
npm.cmd install -g @openai/codex@latest --include=optional --registry=https://registry.npmjs.org
codex.cmd --version

这组三行只重装 Codex 程序，不删除 .codex 中的配置和会话。能显示版本号后再运行 codex.cmd。仍失败时，请发送安装过程及最后报错的完整截图，并遮住 API Key。

二、Mac / Linux 一键配置（保姆级）

2026-10-22 更新：Mac / Linux 一键安装已支持检测并修复 Codex 缺失依赖，安装失败会自动切换下载源。

第 1 步：打开终端

Mac：按 Command + 空格，输入 terminal，回车打开终端。Linux：打开系统的终端应用，或使用已登录的 SSH 终端。

第 2 步：粘贴运行安装命令

复制下面这行，粘进终端回车：

curl -fsSL https://sub.miaoma.ai/codex/install.sh | bash

脚本会检查或安装 Node.js，验证 Codex 能否启动；发现安装损坏时自动重装并安装所需依赖，然后提示输入 Key 并写入配置。请使用日常登录的用户运行，不要在整条一键命令前加 sudo；需要安装权限时脚本会单独提示。

• 开头应显示「安装脚本版本: 2026-10-22.1」。
• 镜像安装或启动验证失败时，自动切换 npm 官方源重试。
• 两个源都失败时停止并保留完整报错，不会提示「配置完成」。
• 脚本保留现有代理设置，下载时间取决于网络。

第 3 步：输入 Key（及电脑密码）

• 出现 请输入你的 API Key 时（如上图最后一行），粘贴你的 Key 回车。
• 若提示输入 password，那是你的电脑开机密码（用于安装权限，输入时不显示是正常的）。

重跑修复后也请按提示输入秒码 Key，脚本会重新写入秒码接口配置。如果已有自定义配置，请先备份 ~/.codex/config.toml 和 ~/.codex/auth.json。

第 4 步：完成 & 使用

看到「Codex 启动验证通过」或「Codex 安装及启动验证通过」，并在输入 Key 后看到「配置完成！」，表示本地安装与配置已完成。新开一个终端，先检查版本：

codex --version

显示 codex-cli 和版本号后，再启动：

codex

进入后发送一句「你好」确认接口可用。输入 /model 回车可切换模型。

遇到「Missing optional dependency」怎么办？

例如包名包含 codex-darwin-arm64、codex-darwin-x64 或 codex-linux，表示当前系统所需的 Codex 运行程序缺失。先重新运行第 2 步的一键命令，让新版脚本自动修复；不需要手动选择系统依赖包。

如果自动修复仍失败，可使用官方源手动重装。逐行执行，任一步报错就停止，保留完整输出：

npm uninstall -g @openai/codex
npm install -g @openai/codex@latest --include=optional --registry=https://registry.npmjs.org
codex --version

这组三行只重装程序，不删除 ~/.codex 中的配置和会话。如果原来使用系统级 npm 并需要管理员权限，给前两行 npm 命令加 sudo；运行 codex 不需要 sudo。使用 nvm 等用户级 Node.js 时不要加 sudo。仍失败时请发送完整安装报错，并遮住 API Key。

三、Windows 手动配置（一键失败时）

1. 安装 Node.js

• 下载（国内快）：node-v24.13.1-x64.msi（镜像）
• 备用：node 官网下载
• 双击安装，全程下一步，不要改路径

2. 安装 Git

• 下载（国内快）：Git-2.51.0-64-bit.exe（镜像）
• 双击安装，全程下一步

3. 安装 Codex（管理员 PowerShell）

逐行执行，能正常显示版本号后再继续写配置：

npm.cmd install -g @openai/codex@latest --include=optional --registry=https://registry.npmmirror.com
codex.cmd --version

安装失败或提示缺少依赖时，请按「Windows 一键配置」末尾的修复步骤处理；其中提供 npm 官方源重装命令。

4. 写配置文件

mkdir "$env:USERPROFILE\.codex" -Force
notepad "$env:USERPROFILE\.codex\config.toml"

记事本粘贴并保存：

model_provider = "codex"
model = "gpt-5.6-terra"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.codex]
name = "codex"
base_url = "https://sub.miaoma.ai/v1"
wire_api = "responses"
requires_openai_auth = true

再建认证文件：

notepad "$env:USERPROFILE\.codex\auth.json"

粘贴（替换成你的 Key）：

{ "OPENAI_API_KEY": "你的Key sk-..." }

5. 使用

新开 PowerShell，输入 codex.cmd，发送一句「你好」确认接口可用。

四、Mac / Linux 手动配置（一键失败时）

1. 安装 Node.js

Mac：打开 Node.js 官方下载页，选择 macOS 的 LTS 安装包（.pkg），下载安装后重新打开终端。

Linux（Ubuntu / Debian）：在终端逐行执行下面命令，安装 Node.js 24。某一步报错就停止：

sudo apt-get update
sudo apt-get install -y curl ca-certificates
curl -fsSL https://deb.nodesource.com/setup_24.x -o /tmp/miaoma-node-setup.sh
sudo bash /tmp/miaoma-node-setup.sh
sudo apt-get install -y nodejs

其他 Linux 发行版请按 Node.js 官方下载页选择 Linux 及对应安装方式；Linux 不使用 Mac 的 .pkg 文件。已有可用的 Node.js / npm 可跳过安装。继续前确认以下命令都能显示版本号：

node --version
npm --version

2. 安装 Codex（终端）

先按当前用户安装。逐行执行，能正常显示版本号后再继续写配置：

npm install -g @openai/codex@latest --include=optional --registry=https://registry.npmmirror.com
codex --version

如果提示 EACCES / permission denied，且你使用的是系统级 Node.js 安装，可执行下面这条命令，再运行 codex --version。使用 nvm 等用户级 Node.js 时不要加 sudo，建议回到一键安装页按报错排查。

sudo npm install -g @openai/codex@latest --include=optional --registry=https://registry.npmmirror.com

镜像安装失败或提示缺少依赖时，请按「Mac / Linux 一键配置」末尾的修复步骤处理；其中提供 npm 官方源重装命令。

3. 写配置文件

mkdir -p ~/.codex
vim ~/.codex/config.toml

内容：

model_provider = "codex"
model = "gpt-5.6-terra"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.codex]
name = "codex"
base_url = "https://sub.miaoma.ai/v1"
wire_api = "responses"
requires_openai_auth = true

认证文件 ~/.codex/auth.json：

{ "OPENAI_API_KEY": "你的Key sk-..." }

4. 使用

新开终端，输入 codex，发送一句「你好」确认接口可用。

不会用 vim？运行 nano ~/.codex/config.toml 更简单（粘贴后按 Ctrl+O 回车保存，Ctrl+X 退出）。

编辑器 / 桌面端 App 使用

在 VSCode / Cursor 里使用

1. 先按上面任一方式配置好并能正常对话。
2. 打开 VSCode 或 Cursor → 扩展市场搜索 Codex → 选 OpenAI 官方的 Codex – OpenAI's coding agent → 安装。
3. 安装后点右上角 Codex 图标，即可在编辑器侧边栏使用编程助手。

Codex 桌面端 App（图形界面，新手推荐）

Codex 除了命令行，还有桌面客户端 App，纯图形界面、不用敲命令。下面是完整配置流程。

第 1 步：下载安装

• Windows：微软商店下载 Codex 桌面端
• Mac：下载 Codex.dmg 双击安装

小技巧：下载页把光标移到文件上（先别点击），就会出现下载按钮。

第 2 步：退出个人账号（如果有）

打开 App，若默认是个人 ChatGPT 登录，先点左下角头像 →【退出登录】。

第 3 步：换成 API 密钥登录

在「开始使用 Codex」界面，点【换种方式登录】。

在「OpenAI API 密钥」输入框，粘贴你购买的 Key（sk-...，首尾别带空格）→ 点【继续】。

第 4 步（可选）：切换中文界面

App 默认英文，想要中文：顶部 File → Settings

在 General → Language 里选「中文（中国）」。

第 5 步（关键！）：配置接口地址指向我们的服务

默认 App 连的是 OpenAI 官方，必须改成我们的接口才能用你的卡：

1. 点左下角【设置】→ 进【配置 / Configuration】
2. 点右侧【打开 config.toml】

3. 在打开的 config.toml 文件里，粘贴以下内容并保存：

model_provider = "codex"
model = "gpt-5.6-terra"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.codex]
name = "codex"
base_url = "https://sub.miaoma.ai/v1"
wire_api = "responses"
requires_openai_auth = true

4. 保存后重启 App 生效。

第 6 步：开始使用

回到主界面，在「我们该做什么？」输入框里就能开始用了 🎉（右下角可查看并切换全部可用模型）

查额度 · 计费 · 常见问题

查询额度 / 使用记录

打开额度查询页：https://sub.miaoma.ai/q/

粘贴你的 Key，即可查看： - 剩余额度、总额度、已用额度 - 每日额度 / 当天已用（月卡） - 到期时间、最后使用时间

计费规则 / 模型说明

• 按额度计费，不同模型消耗不同。默认使用 gpt-5.6-terra（GPT-5.6 Terra），实际消耗以页面显示为准。
• 模型说明（ChatGPT 订阅通道）：
• ✅ 平台支持多种模型，模型列表会持续更新；完整列表请在 Codex 中输入 /model 查看。常用示例：gpt-5.6-terra（默认）、gpt-5.5、gpt-5.4、gpt-5.4-mini（轻量）
• ❌ 旧模型 gpt-5.2、gpt-5.3-codex 已被官方弃用，请勿使用
• 月卡为每日配额模式（每天可用额度刷新），日卡 / 体验卡为限期总额度。

常见问题 FAQ

技术客服

遇到任何问题，截图联系客服，我们会尽快协助：

📷 二维码占位：微信技术客服 📷 二维码占位：售后 / 续费

秒码 · Powered by miaoma.ai