云智 Token Hub · 文档

yunzhi-maas-helper 使用说明

yunzhi-maas-helper 是云智 Token Hub 官方的编码工具配置助手:一个零依赖的 Node.js 交互式 CLI,完成 API Key 验证、模型列表自动获取与 OpenCode / Claude Code / Codex 的配置写入。

安装与启动

terminal
# 方式一:从官方文档站安装(推荐)
npm install -g https://docs.piteyun.com/pkg/yunzhi519-maas-helper-0.1.2.tgz
# 方式二:临时运行,不落全局
npx https://docs.piteyun.com/pkg/yunzhi519-maas-helper-0.1.2.tgz
# 方式三:浏览器直接下载后本地安装
curl -fLO https://docs.piteyun.com/pkg/yunzhi519-maas-helper-0.1.2.tgz
npm install -g ./yunzhi519-maas-helper-0.1.2.tgz

yunzhi-helper   # 已安装时:不带参数进入交互菜单

安装包与校验值:下载 yunzhi519-maas-helper-0.1.2.tgz(也可以在浏览器里直接打开该链接下载)。SHA256:680adc326bb4da98f91066f8c938cb8f3dc5935542bd1e8a75bb49c342c8c128。

只用交互菜单 密钥、模型和工具配置都从交互菜单完成,不要使用快捷子命令跳过菜单——菜单流程里包含密钥验证与状态核对,跳过容易写入不一致的配置。
主菜单项功能
输入 / 配置 API Key先选接入端点(按量 y-llm / 订阅 llm),再隐藏输入(不回显),调用所选端点 GET /v1/models 实时验证后才保存
配置编码工具OpenCode / Claude Code / Codex 三个管理子菜单
测试真实请求向 /v1/chat/completions 发起一次真实调用,验证端到端可用
查看当前配置Helper 与各工具的配置文件位置、端点、模型一览

OpenCode 管理菜单

  • 配置模型 — 从实时列表选择主模型 / 小模型,确认后立即写入
  • 刷新模型列表 — 只更新可选模型目录,不改动当前选择
  • 配置装载/配置刷新 — 规范化端点与 Provider 元数据(旧端点自动纠正)

Claude Code 管理菜单

  • 配置模型 — Haiku / Sonnet / Opus / Fable 四角色逐项从实时列表选择
  • 配置装载/配置刷新 — 应用配置并规范化根端点
  • 清除网关配置 — 移除全部 ANTHROPIC_* 环境变量,恢复官方登录

Codex 管理菜单

进入时自动探测 /v1/responses 与 Codex 关键路径(数组 input + 流式):通过后开放模型配置(写入 wire_api = "responses"),当前平台已支持;本 Helper 内没有有效 Key 时会提示先去主菜单配置,不会误配置。

配置文件位置

内容位置
Helper 自身(含明文 Key)~/.yunzhi-maas-helper/config.json
OpenCode 公开配置~/.config/opencode/opencode.jsonc
OpenCode 凭据~/.local/share/opencode/auth.json(0600)
Claude Code 环境变量~/.claude/settings.json
Codex 配置 / 凭据$CODEX_HOME/config.toml / auth.json
不要提交到代码仓库 Helper 配置含明文 API Key。把它加入 .gitignore,也不要截图或粘贴到工单中。

内置的安全行为

  • 密钥输入全程不回显;验证失败不落盘
  • 公开配置与凭据分离;auth.json 自动设置 0600 权限
  • 旧版内嵌在公开配置里的 apiKey 会被清理并迁移到凭据文件
  • 配置写入前解析旧文件,解析失败不会用空对象覆盖;TOML 采用临时文件 + 原子替换