HoshinoAz使用说明书

HoshinoAz 的中转站 / 新手也能看懂

配置别绕路。
报错有答案。

第一次使用？选择 CC Switch 或 Cockpit Tools。
遇到问题？先查原因，再找到解决方法。

跟着教程走 ↘我现在有个报错 →

本页适用于 cnmoai.com；API Key、分组和余额以本站控制台为准。

API Key 管理 ↗ 兑换充值 ↗ 渠道状态 ↗ 售后交流群 ↗
01

第一次使用，从这里开始

CC Switch，小白上手。

先完成一次调用，再尝试高级配置。
使用 CC Switch ↓使用 Cockpit Tools →
CC Switch 管理配置；Codex / Claude Code 是实际使用的客户端。

请安装对应客户端，再用 CC Switch 添加本站供应商。不同版本的界面可能略有差异，以你当前版本及本站「使用密钥」教程为准。

  1. 1

    安装 CC Switch 和客户端

    选择适合系统与 CPU 架构的安装包。准备使用 Codex，就安装 Codex；准备使用 Claude Code，就安装 Claude Code。安装后重新打开终端，检查客户端能否启动。

    CC Switch 官方下载 ↗Codex 安装说明 ↗Claude Code 安装说明 ↗
    怎么确认客户端安装成功？

    在新终端运行 codex --version 或 claude --version。若提示命令不存在，按对应官方安装说明检查安装和 PATH，再重新打开终端。

  2. 2

    登录 HoshinoAz → 兑换余额 → 创建密钥

    在「购买额度」购买余额兑换码后，回到本站「兑换」页面提交。到账后进入「API 密钥」，创建密钥并选择准备使用的分组；检查密钥的状态、限额和到期时间。

    本店商品的 1 刀对应 1 单位站内中转余额。兑换码负责充值，API Key 负责调用模型，两者不能互换。实际商品售价与模型费率以对应页面为准。

    购买额度 ↗兑换余额 ↗创建 API Key ↗
  3. 3

    从「API 密钥」导入 CC Switch 推荐

    找到刚创建的密钥，打开它的使用或导入入口，选择 CC Switch。允许浏览器启动应用，核对供应商 HoshinoAz、端点地址及目标客户端后确认。随后在 CC Switch 中切换并启用该供应商。

    本站 API 密钥→导入 CC Switch→核对配置→切换 / 启用

    保存供应商不等于启用。若导入入口未显示，或浏览器打不开应用，可以使用下方的手动配置。

  4. 4

    重启客户端，完成一次短请求

    关闭旧的客户端或终端会话，重新启动，输入「只回复：连接成功」。收到回复后，到本站「使用记录」核对本次请求，再继续长对话或编程任务。

    没有请求记录时，优先核对当前供应商、实际接口地址、旧环境变量和本地路由。不要连续重试大任务。

    查看使用记录 ↗

没有成功一键导入？

手动配置，核对这几项。

在 CC Switch 中选择 Codex，添加自定义供应商。下面适用于支持 OpenAI Responses 的分组；请先确认该分组与客户端兼容。

供应商名称
HoshinoAz
API 地址 / Base URL
https://cnmoai.com/v1
API Key
本站「API 密钥」创建的密钥不要填写兑换码、邮箱密码或上游密钥。
接口协议
OpenAI Responses配置文件的协议字段为 wire_api = "responses"。
模型 ID
当前分组实际支持的模型从模型列表复制准确 ID，不要把套餐名称当作模型名。
保存之后
启用 HoshinoAz 供应商重新打开 Codex，再进行短请求测试。

只填写到 /v1，不要追加 /responses 或重复写成 /v1/v1。一般 OpenAI 兼容客户端也常使用此地址，但需按客户端要求选择 Chat Completions 或 Responses。

保存配置后还是不生效？
  1. 确认供应商已切换，而不是只添加了一张卡。
  2. 重新打开终端，让客户端读取新配置。
  3. 检查旧环境变量是否覆盖新配置；处理前先保留原配置。
  4. 使用本地路由或代理模式时，保持 CC Switch 及路由服务运行。
02

用 Cockpit Tools 配置 Codex

Cockpit Tools，跟着这五步。

在 Cockpit Tools 中添加本站 API Key，再启动 Codex。

本节对应 jlcodes99/cockpit-tools 的 Codex 接入流程。请先选择支持 OpenAI Responses 的本站分组；CC Switch 与 Cockpit Tools 任选一个管理当前配置，避免来回切换覆盖设置。界面文字可能随版本调整。

  1. 1

    安装 Cockpit Tools 和 Codex 客户端

    从官方 Releases 下载适合系统的 Cockpit Tools 安装包。Windows 可选择 .msi / .exe；便携版解压后运行 Cockpit Tools.exe，运行环境需要 WebView2。macOS 可选择 .dmg。随后安装与你的系统兼容的 Codex 客户端。

    Cockpit Tools 官方下载 ↗官方使用说明 ↗Codex 安装说明 ↗

    准备使用 Codex App 时，先确认它能正常打开；若 Cockpit 提示找不到应用，请在设置中补全 Codex 的启动路径。准备使用 CLI 时，先在新终端确认 codex --version 能输出版本。

  2. 2

    准备本站 API Key 和可用模型

    登录 HoshinoAz，兑换余额后进入「API 密钥」，创建并复制密钥。选择支持 Codex / Responses 的分组，查看该分组可用的准确模型 ID；检查密钥状态、余额、限额和有效期。

    前往 API 密钥 ↗兑换余额 ↗

    这里使用本站创建的 API Key。兑换码用于充值，不能填进 API Key 栏。

  3. 3

    Codex → 添加账号 → API Key 关键配置

    打开 Cockpit Tools 的 Codex 页面，点击「添加账号」，选择「API Key」标签，供应商选择「自定义」。填写本站密钥、基础地址和供应商名称；若已经保存 HoshinoAz，也可以从「已保存供应商」中选择。

    供应商
    自定义已有本站配置时，可选择已保存的 HoshinoAz。
    供应商名称
    HoshinoAz
    基础地址 / Base URL
    https://cnmoai.com/v1不要留空，也不要追加 /responses。
    API Key
    本站「API 密钥」创建的密钥完整粘贴，避免首尾空格和换行。
    模型列表
    当前分组实际支持的模型 ID每行一个模型 ID，或点击「从上游获取」。
    协议能力（如界面提供）
    Responses 原生前提是当前分组支持该协议。

    填写 Key 和地址后再获取模型。若版本提供「同步供应商模型到 Codex」，先核对列表再开启并保存。模型同步成功只代表列表配置完成，可用性仍以实际调用为准。

  4. 4

    保存账号，然后「切换并启动」

    点击「添加账号」完成保存。回到 Codex 账号列表，找到本站 API Key 账号并点击「切换」或卡片上的启动图标。在「Codex 启动预览」中核对目标实例和默认模型，首次使用可选择默认实例，再点击「切换并启动」。

    添加 API Key 账号→选择本站账号→核对启动预览→切换并启动

    只保存账号或打开启动预览，还没有完成应用配置。仅点击「切换」时，请重新启动客户端；修改模型配置后，也应重启对应实例。使用本地网关时，保持 Cockpit 及网关服务运行。

  5. 5

    发送短问题，核对本站使用记录

    在刚启动的 Codex 中选择已配置的模型，新开会话并输入「只回复：连接成功」。收到回复后，检查本站「使用记录」是否出现对应请求，再继续日常使用。

    查看使用记录 ↗按错误原文排查 →

    没有本站请求记录时，先核对账号、目标实例、Base URL 和网关状态。不要仅凭 Cockpit 显示的配额判断本站余额，余额与计费以本站控制台为准。

Cockpit Tools 配置卡住了？

这几种情况，先这样处理。

只有 OAuth / Token，找不到 API Key 入口？

确认打开的是 Codex 的「添加账号」窗口，在标签中寻找「API Key」。旧版界面可能不同，可先到官方 Releases 查看更新说明。本站 API Key 请使用 API Key 入口，并填写 cnmoai.com 的基础地址。

「从上游获取」失败，或同步后模型不显示？

先核对 Base URL 为 https://cnmoai.com/v1，确认 Key 有效且模型列表接口可访问。可以先按本站分组列表手动填写准确 ID；如有同步开关，核对列表后保存并重启客户端。遇到 401 / 403 / 404，按下方对应报错排查。模型名单或能力元数据并不代表所有模型和功能都可调用。

已保存「模型供应商」，Codex 却仍使用原来的配置？

保存供应商只是保存可复用配置。回到 Codex 的「添加账号 → API Key」，选择已保存的 HoshinoAz 和正确 Key，完成账号添加，再在启动预览中选择本站账号、目标实例与模型，执行「切换并启动」。不要同时用 CC Switch 切换同一客户端配置。

提示没有启动路径，或切换后客户端没有打开？

在 Cockpit 设置中检查 Codex App 的启动路径，并确认客户端已经安装。只想使用 CLI 时，可关闭「切换 Codex 时自动启动 Codex App」，再使用当前版本提供的 CLI 启动入口。先检查选择的实例及启动错误，再重复执行。

报 127.0.0.1 连接失败、Connection refused 或网关不可用？

通过 Cockpit 重新启动所选实例，确认本地网关运行、端口未被占用，且客户端与网关在同一运行环境。HoshinoAz 供应商地址仍填写 https://cnmoai.com/v1；客户端被 Cockpit 配置为本地地址时，由本地网关继续转发。仍失败时记录 Cockpit 版本、实例名称与打码日志，到售后群反馈。

Cockpit 配额与本站余额不一致，怎么办？

API Key 账号的余额展示取决于供应商适配与接口支持；OAuth 账号的配额也不代表本站余额。请查看本站余额和使用记录，反馈时说明当前账号类型、分组与模型 ID。

03

按错误原文查，不用猜

遇到报错，从这里排查。

搜索状态码、英文原因或中文关键词，展开查看处理步骤。责任标签是排查方向，需结合实际响应与使用记录判断。

04

容易混淆的地方，逐个说清楚

常见问题，一次看懂。

第一次使用需要做哪些事？

注册并完成邮箱验证，购买与兑换余额，创建 API Key，选择分组，然后配置客户端。先进行一次短请求，确认使用记录中出现对应记录。

商品的「1 刀」怎么理解？

本店 1 刀兑换码增加 1 单位站内中转余额，5 / 10 / 20 / 50 刀同理。这里描述的是站内余额面值；支付价格以云猫商品页面为准，不按汇率兑换。

购买后余额为什么没有自动增加？

云猫发货的是兑换码，买家需要回本站「兑换」页面提交。购买成功不等于本站已兑换。请查看云猫订单中的卡密，再核对本站兑换记录。

有余额，为什么仍然提示额度不足？

还可能受到密钥独立限额、分组权限、套餐到期或周期配额限制。阅读错误原文，确认当前密钥绑定的分组。若明确是上游额度不足，请联系售后核查。

一个 API Key 能调用所有模型吗？

不一定。当前分组、权限与上游支持范围决定可用模型和协议。换模型或分组前确认实际支持范围与费率；密钥本身不保证所有能力都开放。

模型名单同步成功就一定能使用吗？

模型名单仅代表已获取或配置相应 ID。能力元数据可能缺失，实际权限、渠道可用性及具体功能仍需通过调用验证。「能力元数据未更新」也不等于所有请求都会失败。

CC Switch 的费用估算和本站不同？

客户端可能采用本地定价估算。本站费用需要结合实际分组费率、输入输出、缓存与使用记录查看。明显异常时，提供具体请求时间与请求标识，让售后核对。

回答很慢，需要一直重试吗？

复杂任务、长上下文、高推理强度和线路拥堵都会增加等待。先测试短问题，再适当减少输入或并发。超时或中断前请求可能已执行，请先查使用记录。

收不到注册验证码怎么办？

确认邮箱地址正确，检查垃圾邮件和拦截规则，并按页面倒计时重新发送一次。仍收不到时，提供大致发送时间和邮箱服务商，售后会检查邮件发送情况。

兑换码无效或显示已使用？

检查是否粘贴了空格、是否已在其他账号兑换，并查看历史兑换记录。仍有问题时，通过售后群联系管理员，提供订单号；不要将完整兑换码发到群里。

登录时的 Cloudflare 验证是什么？

这是本站配置的 Turnstile 人机验证。等待验证完成后再提交；若组件未加载，检查网络、系统时间和浏览器扩展，刷新后再试。它不等于 API Key 的认证。

国内网络连接超时如何排查？

先打开 cnmoai.com 判断站点是否能访问，再核对客户端地址。可换手机热点等正常网络进行对比；仅某条网络失败可能与线路有关。持续无法访问时记录时间和网络类型联系售后。

05 / 售后与交流

问题没解决？
我们一起看。

加入 HoshinoAz 售后交流群，带上排查信息。

在 QQ 的「找群」中搜索 607017290，申请加入售后交流群。售后信息请以管理员通知为准。

反馈时，请带上这些信息

  • 发生时间，注明时区；建议使用北京时间
  • 客户端、操作系统与版本
  • 所用分组、准确模型 ID
  • 错误原文及打码截图
  • request_id / trace_id（如有）
  • 短请求能否复现、已尝试的步骤

请遮住 API Key、密码、验证码与兑换码。订单信息或私人内容请在确认管理员身份后私聊。