Download
下载并安装桌面 App
先完成应用安装，配置会在下一步进行。
Terminal
打开命令窗口
你不需要了解命令行，只要按图找到它即可。
macOS
用聚焦搜索打开“终端”
按下 Command + 空格，输入“终端”，然后点击“终端.app”。
Windows
搜索并打开 PowerShell
点击开始菜单，输入 powershell，然后打开“Windows PowerShell”。
Configure
运行一条配置命令
复制对应系统的命令，粘贴到刚才打开的窗口中。
macOS · Terminal
复制并运行 macOS 安装命令
$ curl -fsSL https://codex.quartette-ai.com/install/macos.sh | bash- 点击“复制命令”，粘贴到终端。
- 按回车运行，等待出现 API Key 提示。
- 粘贴 API Key，再按一次回车。
输入 API Key 时不会显示明文，这是正常的。请勿截图或把你的 API Key 分享给他人。
✓ Quartette Codex setup complete.
Windows · PowerShell
复制并运行 Windows 安装命令
PS> irm https://codex.quartette-ai.com/install/windows.ps1 | iex- 点击“复制命令”，粘贴到 PowerShell。
- 按回车运行，等待出现 API Key 提示。
- 粘贴 API Key，再按一次回车。
API Key 会以安全方式输入，不显示明文。请勿截图或把你的 API Key 分享给他人。
[OK] Quartette Codex setup complete.
Launch
重新打开 App，开始使用
最后一步：让应用重新载入刚刚写入的配置。
配置完成。现在可以开始了。
打开桌面 App。如果你之前已经打开过它，请先彻底退出应用，再重新启动。
- 已打开过 App？请彻底退出后重开。
- 安装脚本已自动备份原有配置。
- Quartette Provider 已写入并启用。
Recommended · 进阶教程
继续了解 Codex 的使用方法
完成配置后，跟着视频熟悉常用操作与提示词技巧。
Questions
常见问题
几个配置过程中最容易困惑的地方。
粘贴 API Key 后看不到文字，是不是没有输入？
这是正常的安全行为。终端会隐藏 API Key 的明文显示；粘贴后直接按回车即可。
之前已经打开过 App 怎么办？
完成配置后彻底退出 App，再重新打开。只关闭窗口可能不会结束后台进程，因此建议使用系统菜单中的“退出”。
怎样确认配置已经成功？
命令窗口最后出现 Quartette Codex setup complete. 即表示完成。随后重启 App。
可以重复运行配置命令吗？
可以。安装脚本会先为当前 config.toml 创建带时间戳的备份，再更新 Quartette 相关配置。