返回文档首页
开始接入
这条路径适合第一次接入 qimoq 的用户。建议按「注册账号 → 领取 / 充值额度 → 创建访问凭证 → CC Switch 一键导入 → 下一步」走完，先把账号和客户端跑通，再去细调模型、额度限制和排障。
注册账号
进入站点后先登录或注册。若站点暂未开放注册，请按邀请或管理员开通流程创建账号。
登录成功后，余额、访问凭证、调用日志和作品记录都会归属到当前账号。
首次接入建议使用专门的测试账号或项目账号，不要把个人测试凭证混到生产脚本里。
领取 / 充值额度
账号需要有可用额度才能发起真实调用。额度来源通常有三种：
| 方式 | 说明 |
|---|---|
| 新用户赠送 | 如站点开启赠送，注册或首次登录后会自动到账 |
| 充值卡密 | 在「钱包」购买卡密，再到「兑换码」页面兑换到账户余额 |
| 管理员发放 | 私有部署或团队账号可由管理员直接调整额度 |
如果使用充值卡密，请先进入「钱包」购买，再到「兑换码」页面粘贴卡密并兑换。兑换成功后，余额会立即进入当前账号。
创建访问凭证
进入「访问凭证」页面，点击「创建访问凭证」，填写清晰的用途名称，例如 codex-main、claude-code、test-script。
第一次创建时，优先确认名称和可用模型范围，其它限制可以后续再调整：
| 字段 | 建议 |
|---|---|
| 名称 | 写清客户端或脚本用途 |
| 分组 / 模型范围 | 按目标客户端选择，Codex 用 GPT / Codex，Claude Code 用 Claude，Gemini CLI 用 Gemini |
| 额度限制 | 自动化脚本建议先设小额上限 |
| 速率限制 / IP 限制 / 有效期 | 首次接入可先保持默认，生产环境再收紧 |
完整凭证只会在创建或主动复制时临时显示，请复制后妥善保存，不要发到公开仓库、聊天记录或网页前端代码里。
CC Switch 一键导入
支持 CC Switch 的客户端建议优先一键导入，减少手动填写 Base URL、API Key 和模型 ID 时出错。
当前适合用 CC Switch 导入的客户端包括 Codex、Claude Code、Claude Desktop、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 等。操作顺序：
- 安装并打开一次 CC Switch。
- 回到 qimoq「访问凭证」页面。
- 找到用途匹配的凭证，点击导入配置。
- 选择目标客户端。
- 确认 Endpoint、API Key、主模型和快速模型。
- 浏览器询问是否打开 CC Switch 时选择允许。
- 保存后重启客户端或终端。
不要分享 ccswitch:// 导入链接；链接里可能包含完整 API Key。
下一步
接入跑通后，再按你的实际场景进入下一篇文档：
| 目标 | 入口 |
|---|---|
| 配置 Codex | Codex 接入 |
| 配置 Claude Code | Claude Code 接入 |
| 配置 Gemini CLI | Gemini CLI 接入 |
| 手动配置或 curl 验证 | 手动配置模板 |
| 复制模型 ID | 模型 ID |
| 查看失败原因和消费 | 使用日志与排查 |
如果你只是想确认访问凭证是否能用，可以先用 手动配置模板 里的 curl 请求跑一次，再回到具体客户端里配置。