ModelSwap ModelSwap
EN

$ modelswap web

密钥与模型，一处掌控。

AI Agent 的密钥与模型管控台：41 个模型平台预置开箱即用、适配 10 个 Agent、37 个用量来源直查、多设备同步（局域网点对点 + 自托管云）；切换只改自己的字段、不丢 hooks 与 statusLine，自动快照可回滚，并提供可被其他 Agent 直接调用的 CLI 与 Skill。

开始安装 阅读文档
0预置模型平台
0Agent 适配器
AES-256加密密钥库
0用量来源直查
Agent 配置
Claude Code ChatGPT Kimi Hermes WorkBuddy
智谱 Coding Plan
GLM-5 GLM-5-Air GLM-5-Flash
MiniMax Coding
MiniMax-M2
$ modelswap · claude → zhipu · GLM-5 · config.toml + auth.json ✓
今日用量
Claude 5h 8%
GLM 周 62%
DeepSeek 余额 81%
Install

两种方式，一分钟上手。

桌面版与 CLI 共享同一数据目录，二选一即可，随时共存。

版本
  • Apple 芯片（M1/M2/M3/M4+）
  • Intel 芯片
下载 
npm install -g modelswap
modelswap web
01

Agent 配置

适配 Claude Code、ChatGPT Codex、Kimi Code、WorkBuddy、Hermes 等 10 个 Agent。模型切换点一下，config.toml 与 auth.json 自动写对，不再手工编辑。

Agent 配置
Claude Code ChatGPT Kimi Hermes WorkBuddy
智谱 Coding Plan
GLM-5 GLM-5-Air GLM-5-Flash
MiniMax Coding
MiniMax-M2
$ modelswap · claude → zhipu · GLM-5 · config.toml + auth.json ✓
02

内置模型平台

预置 41 个模型平台：国际官方、聚合与国内平台全覆盖，Coding Plan、Token Plan 等订阅套餐统一纳管。

国际平台
国内平台
聚合 / 本地
Coding PlanToken Plan订阅按量付费
03 自动创建密钥

加密密钥库

AES-256-GCM 本地加密，密钥可绑定项目自动注入 .env。配合浏览器扩展，在官方控制台一键创建 Key 并自动回填入库，全程不落明文。

1浏览器扩展打开官方控制台
2一键创建 API Key
3自动回填本地加密库
AES-256-GCM sk-…•••7f2a → ~/.modelswap/vault (encrypted)
04

平台用量查询

37 个订阅与余额来源实时查询，智能轮询刷新；剩余量不足时横幅与本地通知提前告警。

Claude 5h 窗口仅剩 8%，建议切换或等待重置
Claude 5h 8%
GLM 周 62%
DeepSeek 余额 81%
05

配置安全

外科手术式写入：只改 ModelSwap 自己的字段，hooks、statusLine、MCP 配置原样保留。每次切换前自动快照，设置页对比查看、一键恢复。

settings.jsonhooks保留
settings.jsonstatusLine保留
config.toml快照已保存
config.toml恢复一键回滚
06

多设备同步

局域网点对点直连，或接入你自己的云存储（Cloudflare / Supabase / WebDAV / iCloud 等 9 种后端）；密文同步，服务器看不到明文，另有一次性同步码跨机迁移。

本机
⇄
自托管云E2E
⇄
其他设备
07

CLI 与 Skill

ModelSwap 的每个能力都可以被程序调用：其他 Agent 通过 CLI 或 Skill 直接创建密钥、切换模型，无需打开面板。

# 让你的 Agent 直接操作 ModelSwap
modelswap web          # 打开控制台
modelswap vault        # 密钥管理

# Skill（即将提供）—— 自然语言直接调用
"在智谱创建一个新 Key 并入库"
"把 Codex 切换到 GLM-5"
竞争力

与其他使用方式对比

能力 手工配置 配置切换器 ModelSwap
模型 / 平台一键切换✗✓✓
密钥加密存储✗—✓
自动创建 API Key✗✗✓
平台用量查询✗✗✓
切换不丢自定义配置✓✗✓
切换前自动快照与回滚—✗✓
无常驻进程（不碰请求路径）✓✗✓
Agent 内直接切换模型✗✗✓
供 Agent 调用 (CLI/Skill)✗✗✓
多 Agent 适配✗~✓
FAQ

常见问题

密钥存在哪里，安全吗？

密钥保存在本机 ~/.modelswap 下的加密库中，使用 AES-256-GCM 加密；云同步为端到端加密，云端永远不落明文。

支持哪些 Agent？

内置 10 个 Agent 适配器：Claude Code、ChatGPT Codex、OpenCode、OpenClaw、WorkBuddy、ZCode、Hermes、Kimi Code、Grok、MiMo Code，一键写入各自的配置文件。

自动创建密钥是怎么工作的？

浏览器扩展在你的官方控制台页面内操作：点击创建后自动填表单、复制新 Key 并回填到 ModelSwap 加密库，全程只在你的浏览器与本机之间进行。

其他 Agent 能调用 ModelSwap 吗？

能。CLI 已经可用，任何 Agent 都能通过命令行调用 ModelSwap；运行 modelswap skill 会把 SKILL.md 安装到当前项目的 .agents/skills/modelswap/ 目录，支持 Agent Skill 的工具即可直接使用。

会和现有配置冲突吗？

不会。ModelSwap 只改写自己管理的字段，你的 hooks、statusLine、MCP 等自定义配置原样保留；每次切换前还会自动保存配置快照（每个 Agent 保留最近 10 份），可在设置页对比查看并一键恢复，随时退回官方或原平台。