这篇是整套教程的地图。你只要按下面六步走一遍，就能用自己的工具发出第一条消息。每一步都有单独的详细教程，这里只讲最短路径。
先看一眼全流程
- 注册账号并登录控制台。
- 在合作商店买一张「余额兑换卡」。
- 到控制台「兑换」页粘贴卡密，额度到账。
- 在「API 密钥」页创建一把密钥，选一个分组。
- 把弹窗里的配置复制进你的工具。
- 发一条「你好」，到「使用记录」页确认有记录。
第一到第三步：注册、买额度、兑换
注册并登录
打开 注册页，按页面提示填写，完成后用 登录页 进入控制台。控制台菜单里有「API 密钥」「兑换」「使用记录」这几项，后面都会用到。
买一张余额兑换卡
额度在合作商店 catfk.com 购买，商品叫「余额兑换卡」，面额有 1、5、10、20、50、100、200、300、500 美元。第一次试用买 5 或 10 美元就够了。付款后你会拿到一串卡密，先复制下来。
到控制台兑换
打开控制台的 兑换页，把卡密粘进输入框，点兑换，额度即时到账。详细的买卡和兑换步骤见 买额度与兑换。
第四到第五步：建密钥、粘配置
创建密钥并选分组
打开 API 密钥页，点创建，给密钥起个名字，然后选一个分组。新手推荐选「ChatGPT 【稳定分组 超高缓存 高并发 】」，倍率 0.12×。分组决定你能用哪些模型和扣多少钱，各分组的区别见 分组怎么选。
创建成功后，密钥明文只显示这一次。请立刻复制并保存到安全的地方，以后页面上不会再显示完整密钥。密钥以 sk- 开头，本教程里一律用 sk-你的密钥 代替。
把配置粘进工具
回到密钥列表，点这把密钥右侧的「使用」按钮。弹窗会按分组平台给出现成的配置：ChatGPT（OpenAI）分组给 Codex CLI、Codex CLI (WebSocket)、OpenCode 三个标签；Anthropic 分组给 Claude Code、Codex CLI、OpenCode。弹窗里直接点复制最省事，不用自己拼地址和密钥。
以 Codex CLI 为例，弹窗会给出两个文件：config.toml 和 auth.json，都放在用户目录下的 .codex 文件夹（Windows 是 %userprofile%\.codex，macOS 是 ~/.codex）。复制、粘贴、保存即可，手工写法见 Codex CLI 配置。
第六步：发一条「你好」验证
打开你的工具，随便发一句「你好」。能收到回复，说明地址和密钥都对了。然后打开控制台的 使用记录页，刷新一下，应该能看到刚才这条请求：用的哪把密钥、哪个模型、花了多少额度。有这条记录，就算配置成功。
如果你会用终端，也可以不经过任何工具，直接发一条请求试试（macOS / Linux 终端，把 sk-你的密钥 换成真实密钥）：
curl https://api.zyuou.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6.1-sol",
"messages":[{"role":"user","content":"你好"}]}'
正常会返回一段 JSON，里面有模型的回复。如果返回 401 和 Invalid API key，说明密钥粘错了或已被停用，回 密钥页 核对。其他报错到 常见报错 对照。
接下来读哪篇
- Codex CLI 配置：config.toml 与 auth.json 的完整写法。
- Codex VS Code 扩展：在编辑器里用同一把密钥。
- Claude Code 配置：三种 shell 的环境变量和 settings.json 写法。
- CC Switch 导入：密钥页一键导入，多套配置来回切。
- Cherry Studio / ChatBox：聊天客户端怎么填地址和模型名。
- 分组怎么选：每个分组的倍率、平台和适合谁。
- 买额度与兑换：卡密购买和兑换的逐步说明。
- 常见报错：401、402、403、404、429 各是什么意思，怎么处理。
还是不行？
先到 常见报错 按状态码对照一遍。还解决不了，加 QQ 群 1104498354（备注「新手」），或直接找客服 QQ 3480261526，把报错原文发过来。