yunzhi-maas-helper 是云智 Token Hub 官方的编码工具配置助手：一个零依赖的 Node.js 交互式 CLI，完成 API Key 验证、模型列表自动获取与 OpenCode / Claude Code / Codex 的配置写入。
安装与启动
# 发布后 npm install -g @yunzhi/maas-helper@latest # 当前内部阶段：从源码安装 cd yunzhi-maas-helper && npm install -g . yunzhi-helper # 不带参数进入交互菜单
只用交互菜单
密钥、模型和工具配置都从交互菜单完成，不要使用快捷子命令跳过菜单——菜单流程里包含密钥验证与状态核对，跳过容易写入不一致的配置。
菜单结构
| 主菜单项 | 功能 |
|---|---|
| 输入 / 配置 API Key | 隐藏输入（不回显），调用 GET /v1/models 实时验证后才保存 |
| 配置编码工具 | OpenCode / Claude Code / Codex 三个管理子菜单 |
| 测试真实请求 | 向 /v1/chat/completions 发起一次真实调用，验证端到端可用 |
| 查看当前配置 | Helper 与各工具的配置文件位置、端点、模型一览 |
OpenCode 管理菜单
- 配置模型 — 从实时列表选择主模型 / 小模型，确认后立即写入
- 刷新模型列表 — 只更新可选模型目录，不改动当前选择
- 配置装载/配置刷新 — 规范化端点与 Provider 元数据（旧端点自动纠正）
Claude Code 管理菜单
- 配置模型 — Haiku / Sonnet / Opus / Fable 四角色逐项从实时列表选择
- 配置装载/配置刷新 — 应用配置并规范化根端点
- 清除网关配置 — 移除全部
ANTHROPIC_*环境变量，恢复官方登录
Codex 管理菜单
进入时自动探测 /v1/responses：平台未上线 Responses API 时给出明确提示并终止；上线后开放模型配置（写入 wire_api = "responses"）。
配置文件位置
| 内容 | 位置 |
|---|---|
| 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 采用临时文件 + 原子替换