第一次使用
第一次接入时，按下面顺序完成即可：准备账户 → 选择分组 → 创建 API 密钥 → 接入客户端 → 确认首次调用。
1. 准备账户
打开 259AI 控制台，注册或登录。
可以先创建密钥并完成配置；实际发起调用前，需要确认有可用的按量余额，或有对应分组的有效订阅。
按量余额和订阅额度是两种不同的使用方式，具体可用额度、有效期及限制以控制台显示为准。
2. 先决定用什么
| 你想做什么 | 创建密钥时的厂商 | 接下来查看 |
|---|---|---|
| 用 Codex / GPT 编程或处理任务 | OpenAI，再选 GPT / Codex 分组 | 推荐 CC Switch，另有 Codex CLI 手动接入 |
| 用 Claude Code | Anthropic，再选 Claude 分组 | 推荐 CC Switch，另有 手动接入 |
| 用 Claude 桌面端 | Anthropic，再选支持桌面端所需模型的 Claude 分组 | CC Switch 的桌面端补充 |
| 用龙虾（Hermes）接入 GPT | OpenAI，再选支持目标 GPT 的分组 | Hermes 接入 |
| 使用 image2 系列生图 | OpenAI，再选对应生图分组 | AI 生图教程 |
分组决定这把密钥可以使用哪些模型，以及对应的渠道和计费方式。选择时先确认它支持你要用的客户端和模型，再看倍率及计费方式。
分组名称、倍率、可用模型可能调整，使用时以控制台当前显示为准。只从你的账户当前可选列表中选择；没有订阅时，不要直接选择需要订阅的分组。
登录 模型广场，查看目标分组可用的模型与价格，复制完整模型名称。不要因为两个分组名称相似，就假定支持的模型和费用相同。
生图需要使用支持生图的分组。拥有文本订阅，不代表可以使用所有生图分组，详见 AI 生图教程。
3. 创建 API 密钥
进入控制台的 API 密钥 页面，点击 创建密钥。
- 名称写成方便识别的用途，例如“我的 Codex”或“生图”。
- 在 厂商 中按上表选择 OpenAI 或 Anthropic；不要直接沿用弹窗默认选项。
- 选择适合该用途的分组。
- 如设置了密钥额度或过期时间，请记住它们也会影响后续调用。
建议为不同用途分别创建密钥，方便查看使用记录和单独停用。需要手动复制时，使用密钥旁的复制按钮，不要复制页面上缩略显示的内容。
以后需要切换分组，可以在这把密钥所在行点击 选择分组。切换前重新确认目标模型、倍率和可用余额或订阅。
API 密钥和登录密码不同
客户端接入需要的是 API 密钥。请不要将真实密钥发到群聊、截图或公开仓库。如果已经泄露，先在控制台停用该密钥，再创建新密钥并更新客户端配置。
4. 接入客户端
使用 Codex 或 Claude Code，推荐按照 CC Switch 接入教程 导入配置。导入后，在 CC Switch 中启用对应配置，再重启客户端。
如果要接入 Hermes 或生图工具，请分别按对应教程填写配置。
5. 确认第一次调用
接入文本客户端后，新建一个对话，先发送一个短请求，例如：
请只回复：接入成功。等到回复完整结束，再进入控制台的 使用记录 页面，按刚才的时间和 API 密钥核对记录。
确认这两点后，再开始较长的任务：
- 客户端完整收到回复，没有中途报错。
- 使用记录中的时间、密钥和模型与本次测试相符。
如果使用生图工具，先完成一张测试图，再按同样的方法核对使用记录。测试调用会产生正常用量。
看见配置不等于已经接入成功
CC Switch 中显示“已启用”，或客户端能显示模型列表，只代表完成了相应配置。请用一次完整调用和使用记录确认实际使用情况。
遇到问题
先查看 接入报错与排查。仍无法解决时，加入 QQ 群 1103052862，提供客户端名称、模型、分组、出错时间和已隐藏密钥的错误信息。
不要发送真实 API 密钥、登录密码或完整的私人对话内容。