装上启动器，
三分钟用上。

#下载与安装猫猫启动器

猫猫启动器是一个桌面应用。登录后，它会帮你配置 Claude Code、Codex 等工具，并在需要时一键还原。目前提供两个版本：Mac（Apple 芯片，.dmg）和 Windows（64 位 x64，.exe）。

#下载

• 官网：打开 下载页，选择「Mac 版」或「Windows 版」。
• 网页控制台：点「客户端下载」，选择「macOS 版」或「Windows 安装包」。

安装包文件名形如 MaoMao-Power-<版本号>-mac-arm64.dmg 和 MaoMao-Power-<版本号>-win-x64.exe。

#在 Mac 上安装

1. 双击 .dmg 文件，把应用拖进“应用程序”文件夹。中文系统里应用名显示为“猫猫动力”，英文系统里为“MaoMao Power”。
2. 首次打开时如果被系统拦截，打开“系统设置 → 隐私与安全性”，在安全性部分对该应用选择“仍要打开”。

#在 Windows 上安装

1. 双击 .exe 安装包。
2. 如果出现蓝色的“Windows 已保护你的电脑”提示，点「更多信息」，再点「仍要运行」。
3. 按安装向导完成安装。

#首次启动

1. 打开启动器后，窗口中会显示“正在检测可用线路”，并说明首次使用需要一点时间，进度显示为“已检测 X / Y 条线路”。
2. 检测期间可以先登录。检测完成后才能启动工具。
3. 如果显示“线路暂未就绪”，检查网络连接后点「重试检测」。

#注册与一键登录

没有账号也没关系：在启动器点「一键登录」，浏览器打开后先注册，再在授权页确认即可。全程不需要自己创建或复制密钥。

#注册账号

1. 在启动器点「注册账号 ↗」，或打开 maomao.chat 点右上角「免费注册 ↗」，两者打开的是同一个注册页。
2. 按页面要求填写用户名、邮箱和密码，获取并填写邮箱验证码，完成人机验证。
3. 点「创建账号 ↗」。注册成功后会自动登录。

#一键登录

启动器通过浏览器授权登录。密码只在网页上输入，不需要手动复制密钥。

1. 在启动器点「一键登录」，浏览器会打开授权页。
2. 如果网页还没有登录，先登录；没有账号的先注册。
3. 在授权页点「授权并配置到启动器 ↗」。
4. 浏览器询问是否打开猫猫动力（也可能显示为 MaoMao Power）时，选择允许打开。
5. 回到启动器，会弹出「网页授权请求」，显示发起授权的用户名和将要使用的密钥（部分隐藏）。确认是本人操作后点「确认接管」；不是本人操作的，点「取消」。
6. 按钮变为「配置中…」。完成后提示“授权成功，已配置密钥 …”，账号卡片显示“✓ 已登录”和你的用户名。

#充值与余额

在启动器账号卡片下方点「充值 · 管理 ↗」，会在浏览器中打开网页控制台。余额以美元计，控制台同时显示折算的人民币金额。调用模型时按用量从余额扣费，各模型单价见网站的「模型价格」页。

#查看余额

• 控制台的「BALANCE · 账户余额」卡片显示当前余额和「累计已用」。
• 在启动器登录后，账号卡片里的「余额」显示同一账户的余额。

#在线充值

1. 在控制台「充值金额(美元)」中输入金额，或点 5、10、20、50、100 快捷金额。下方会显示实付的人民币金额。
2. 在「支付方式」中选择「支付宝」或「微信支付」。
3. 点「充值 ↗」，在打开的收银台页面完成支付。
4. 支付完成后回到控制台，确认余额已经增加。

#使用兑换码

1. 在充值区域展开「使用兑换码」，输入兑换码。
2. 点「兑换」。看到“兑换成功!额度已到账”后，余额会随之更新。

#启动和管理工具

「启动」页签分为「桌面应用」和「命令行工具」两组。每行显示工具名、配置状态、接管开关和操作按钮。

• 桌面应用：Codex 桌面版、Claude 桌面版。
• 命令行工具：Codex CLI、Claude Code、Grok Build、OpenCode、OpenClaw、Gemini CLI、Hermes Agent、Pi。

#安装工具

1. 未安装的工具显示「安装」。点击后变为「安装中…」，启动器在后台完成安装。
2. 桌面应用：启动器下载安装包并显示“下载中 N%”。Mac 上会自动放入“应用程序”文件夹；Windows 上按系统弹出的授权窗口或安装向导完成。
3. 命令行工具：启动器在后台自动安装（使用各工具的官方安装脚本或 npm），完成后提示安装完成并自动刷新。

#启动工具

1. 已安装的工具显示「启动 ↗」，点击后工具会带着猫猫的配置打开。
2. 命令行工具会在新的终端窗口中运行。在 Mac 上第一次这样启动时，系统可能询问是否允许启动器控制“终端”，请选择允许。
3. 按钮显示「线路准备中…」或「配置中…」时暂时不能启动，请稍等片刻。

#「⋯」菜单

每个已安装工具的右侧有「⋯」按钮：

• 「重启 ↻」：重启该工具，让新配置生效。确认框会提醒可能中断正在运行的任务，点「确认继续」。
• 「卸载 工具名」：命令行工具在后台卸载。Mac 上的桌面应用会在访达中定位，拖进废纸篓即可；Windows 上的桌面应用会自动卸载，或打开系统的应用管理。Grok Build 和 Hermes Agent 会打开官方卸载说明。

#升级工具

检测到工具有新版本时，该行会出现「升级」。点击后显示「升级中…」，完成后自动刷新。

#接管开关

“接管”指启动器把工具的接口地址和凭据改为通过猫猫访问。关闭接管时，启动器会把配置恢复成你原来的设置，登录信息保留。

• 总开关：在账号卡片里，旁边显示「开启中」或「已还原」。页面向下滚动、账号栏收起后，显示为「接管已开启」或「接管已关闭」。关闭后所有工具恢复原配置，提示“已还原,本机配置恢复原样”；重新打开提示“已接管,全部客户端已配置”。
• 单个工具开关：登录后，每个工具名旁有一个小开关。关闭它只还原这一个工具，例如让某个工具继续使用你自己的官方账号。总开关关闭时，单个开关不可操作。
• Codex 联动：Codex CLI 与 Codex 桌面版共用一套配置，两者的开关会同时打开或关闭。
• 状态标签：「已配置」表示该工具已指向猫猫；「待配置」表示接管已开启但配置尚未完成；「已还原」表示该工具未被接管，使用你自己的原配置。

#启动器支持的工具

启动器目前可以一键安装、配置和启动以下工具，列表顺序与启动器界面一致。

#余额、密钥与充值管理

登录后，启动器的账号卡片集中显示余额、接管状态和当前使用的密钥。

#查看余额

• 「余额」显示美元余额，旁边是约合的人民币金额。
• 余额低于 1 美元时，卡片变为提醒样式，并出现「充值」链接，点击打开网页控制台。
• 启动器会定期刷新余额；充值后想立即看到，点一下「启动」页签即可刷新。

#切换密钥

1. 点账号卡片中的密钥框（显示“密钥名 · 使用中”），展开密钥列表。列表中每把密钥显示名称、部分密钥和可用模型。
2. 选择要使用的密钥。
3. 在确认框「切换猫猫密钥」中点「确认切换」。完成后提示“已切换到「密钥名」”。

#打开充值和管理页面

点账号卡片下方的「充值 · 管理 ↗」，会在浏览器中打开网页控制台。浏览器没有登录时，需要先登录。

#退出账号

点「退出账号」并确认。启动器会还原本机工具配置并清除登录记录，提示“已退出，本机配置已还原”。

#「更多」页

「更多」页签显示账单、用量、调用记录和邀请奖励，末尾是应用设置。未登录时显示“登录后查看账号数据”。

• 「用量账单」：默认展开。显示近一段时间（天数见标题）的「实际扣费」，以及按官方公开价格估算的「预估节省」（实际更贵时显示「预估多花」）。展开「费用对比与模型明细」可查看各模型的“官网估算”和“猫猫实扣”，最多列出 6 个模型；完整记录点「打开网页控制台 ↗」查看。节省金额仅按有公开定价的模型估算。
• 「调用量」：近 7 天各模型每天的词元（token）用量，可在「曲线图」和「柱状图」之间切换。标题旁显示今天的调用次数和扣费。
• 「最近调用」：最近的调用记录，每条显示模型、时间、扣费，以及输入、输出、缓存和首响应耗时；顶部汇总「缓存命中率」和「平均首响应耗时」。每页 5 条，用「上一页」「下一页」翻页。服务端没有提供的数据显示为“未上报”或“未采集”。
• 「邀请好友」：显示你的邀请码。点「复制邀请链接」会复制一段邀请文字和注册链接。好友消费后累计奖励，待结满 1 美元后，点「转入余额」即可转入。窗口右上角的复制按钮也能一键复制邀请文字和链接。
• 「应用设置」：「开机启动」开关。

#更新启动器

启动器会在启动后和收到新版通知时自动检查更新。下载、安装和重启都需要你点击确认，不会自动进行。

1. 有新版本时，窗口顶部显示“新版本 v…”和「下载更新」。也可以点窗口底部的「检查更新」手动检查；已是最新时提示“已是最新版本”。
2. 点「下载更新」，进度显示为“下载中 N%”。
3. 下载完成后点「安装并重启」，在确认框「安装更新并重启猫猫启动器」中点「确认继续」。
4. 重启后提示“已更新至 v…”。

#关闭与退出启动器

工具通过启动器访问猫猫，使用期间启动器需要保持运行。关闭窗口和完全退出的效果不同。

单击托盘图标可以显示或隐藏主窗口；托盘菜单中还可以显示主窗口、快速启动 Claude Code 或 Codex。

#常见问题排查

工具里出现报错时，按 常见问题 · 工具里报错了，怎么办？ 的顺序处理。

#网页登录失败

• 检查用户名和密码。连续多次失败可能触发频率限制，请稍后再试。
• 人机验证失败或过期时，刷新页面重新验证。
• 忘记密码时，在登录页点「忘记密码?」。

#点了「一键登录」，启动器没有反应

• 确认启动器已经运行。
• 浏览器询问是否打开应用时，要选择允许。没有弹出时，刷新授权页再授权一次。
• 启动器提示“授权数据无效，请回到网页重试”时，回到网页重新授权。
• 启动器提示“密钥已失效,已打开浏览器重新授权…”，说明当前密钥已被停用或删除，按打开的网页重新授权即可。

#工具启动不了

#安装工具失败

• 提示“后台安装失败”时，检查网络后重试。
• 命令行工具多数需要 Node.js，先按启动器的提示安装 Node.js。
• 在 Mac 上安装桌面应用需要写入“应用程序”文件夹的权限。

#余额不足

• 启动器余额低于 1 美元时会出现「充值」提醒；余额用完后，模型调用会报错。
• 到网页控制台充值或使用兑换码。充值后点启动器的「启动」页签刷新余额。

#提示模型不存在或无权使用

• 模型 ID 要与「模型价格」页完全一致，包括大小写和连字符。
• 检查密钥是否限定了模型：控制台中该密钥会显示「全部模型」或具体模型，点「模型」可以修改。
• 模型暂不可用时也可能出现这类错误，可以先换一个模型试试。

#常见错误码

#想让某个工具改回使用自己的官方账号

1. 在启动器中关闭该工具的接管开关。Codex CLI 与 Codex 桌面版会一起关闭。
2. 完全退出该工具后重新打开，按官方方式登录。
3. 在猫猫和官方账号之间切换后，旧会话不一定能继续对话，建议新开会话。

#关闭接管后，工具仍然连到猫猫

完全退出该工具后重新打开。仍不对时，检查工具自己的设置。

#Mac 提示无法打开，或 Windows 提示“已保护你的电脑”

按「下载与安装猫猫启动器」一章的步骤处理。只放行从 maomao.chat 下载的安装包。

#创建和管理 API 密钥

API 密钥以 sk- 开头，是调用模型的凭据，也用于计费。可以为不同的软件或用途分别创建密钥，方便单独停用和查看。只用启动器的话可以跳过这一章，一键登录会自动配置密钥。

#创建密钥

1. 在控制台「API 密钥」卡片中点「+ 创建密钥」。
2. 填写名称，例如“我的 Cursor”。名称只用于区分，最多 50 个字符。
3. 需要时限定可用模型：在「限定模型」中按能力筛选（「全部能力」「对话」「图像生成」「视频生成」「语音」），可以搜索厂商或模型，勾选允许调用的模型；「全选」会勾选当前列出的全部模型。不勾选任何模型，密钥即可调用全部模型。
4. 点「创建」。显示“创建成功”后，点「复制密钥」并妥善保存。

#管理密钥

密钥列表中每把密钥占一行，显示名称、状态（「启用中」或「已禁用」）、可用模型（「全部模型」或具体模型）、部分密钥和创建时间。

• 重命名：点密钥名称，直接修改。
• 「模型」：打开「编辑密钥」，调整可用模型或名称后点「保存」。密钥本身不变；全部取消勾选即恢复为可用全部模型。
• 「显示」：限定了模型的密钥才有此按钮，展开查看全部允许的模型，点「收起」折叠。
• 「复制」：复制这把密钥的完整内容。
• 「禁用」／「启用」：临时停用或恢复密钥，停用后它无法再调用模型。
• 「删除」：确认后永久删除，无法恢复。

卡片右上角的「复制接入地址」会复制 API 地址 https://maomao.chat/v1。

#密钥泄露怎么办

1. 立即在控制台对该密钥点「禁用」；确认不再需要的，点「删除」。
2. 点「+ 创建密钥」新建一把，替换到你的软件和代码里。
3. 如果启动器正在使用这把密钥，在启动器的密钥列表里切换到新密钥，或重新点「一键登录」授权。

#在其他工具中使用

猫猫兼容 OpenAI 接口格式，也支持 Anthropic Messages 格式。凡是支持“自定义 OpenAI 接口”的软件，都可以填入猫猫的地址和密钥使用。

#通用步骤

1. 在控制台为这个软件单独创建一把密钥，例如命名为“我的 Cursor”，需要时限定可用模型。
2. 在软件设置中找到自定义 OpenAI 接口，常见名称有 API 地址、Base URL、接口地址或 OpenAI 兼容服务商，填入 https://maomao.chat/v1。
3. 填入密钥，按需添加模型 ID，再用软件自带的“测试连接”功能检查。

#常见工具

• Cursor：在模型设置中填写自定义的 OpenAI Base URL 和 API Key。部分功能可能仍只使用 Cursor 自带的服务。
• Cherry Studio：添加一个 OpenAI 兼容类型的服务商，填写 API 地址和密钥，再添加要用的模型。
• OpenClaw、OpenCode：推荐直接在启动器中安装和启动，配置自动完成。手动配置时同样填写 OpenAI 兼容地址和密钥。
• Claude Code、Codex CLI 等编程工具：推荐使用启动器。手动配置 Claude 系工具时，把 Anthropic 接口地址设为 https://maomao.chat（例如环境变量 ANTHROPIC_BASE_URL）。

#代码示例

OpenAI SDK（Python）：

from openai import OpenAI

client = OpenAI(api_key="sk-你的密钥", base_url="https://maomao.chat/v1")
reply = client.chat.completions.create(
    model="你的模型 ID",
    messages=[{"role": "user", "content": "你好，猫猫"}],
)
print(reply.choices[0].message.content)

Anthropic SDK（Python）：

from anthropic import Anthropic

client = Anthropic(api_key="sk-你的密钥", base_url="https://maomao.chat")
message = client.messages.create(
    model="你的模型 ID",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好，猫猫"}],
)
print(message.content[0].text)

更多接口和示例见网站的「开发文档」。

#网页账号与密码

网页控制台用来管理账号、余额和 API 密钥，地址是 maomao.chat。

#登录

1. 点首页右上角「登录」，填写用户名和密码，完成人机验证后登录。
2. 登录后进入「控制台」，在这里统一管理密钥、余额和充值。

#修改或找回密码

• 已登录：在控制台右上角点「改密码」。
• 忘记密码：在登录页点「忘记密码?」，填写注册邮箱，点「发送重置邮件 ↗」，再按邮件提示操作。
• 退出网页登录：在控制台右上角点「退出」。