MemNexa Quick Start

从创建密钥到导入 CC Switch

这页给新用户按步骤走完最常用流程:在 MemNexa 创建 API 密钥,安装 CC Switch, 用密钥页的“导入到 CC Switch”按钮一键写入配置,然后在本地客户端里切换使用。

一、创建 API 密钥

API 密钥是你在 Claude Code、Gemini CLI、OpenCode、脚本或第三方客户端里调用 MemNexa 的凭证。

  1. 进入密钥页 登录后点击左侧菜单 API 密钥,或直接打开 https://memnexa.com/keys
  2. 新建密钥 点击页面右上角 创建密钥。建议名称写清楚用途,例如“Claude Code 台式机”或“Gemini CLI 项目 A”。
  3. 选择分组 选择你可用的模型分组。不同分组可能对应 Claude、Gemini、OpenAI 兼容模型或不同额度策略。
  4. 按需设置限制 额度、过期时间、限速、IP 白名单/黑名单都是可选安全项。普通新手可以先保持默认,只填写名称和分组。
  5. 保存并确认状态 保存成功后,表格中会出现新密钥。状态为 active 时才能正常调用;如果没看到,刷新密钥页再确认一次。

密钥只相当于调用凭证,不是你的登录密码。不要把密钥发给陌生人,也不要放到公开 GitHub 仓库、公开截图或聊天群里。

二、安装 CC Switch

CC Switch 是本地客户端供应商切换工具。安装后,MemNexa 密钥页可以通过 ccswitch:// 深链直接写入配置。

官方下载

CC Switch 官网

优先从官网进入下载,选择适合你系统的安装包。

备用下载

GitHub Releases

如果官网下载不方便,可以到 GitHub 最新发布页下载 Windows、macOS 或 Linux 版本。

安全提醒

只用官方来源

CC Switch 是免费开源工具。任何要求充值、付款、输入 MemNexa 登录密码或索取验证码的网站都不要使用。

三、一键导入到 CC Switch

这是 MemNexa 原版密钥页已有的功能,优先使用它,少手填配置,也能自动带上用量查询脚本。

  1. 先启动 CC Switch 安装完成后至少打开一次 CC Switch,让系统注册 ccswitch:// 协议。
  2. 回到 MemNexa 密钥页 打开 https://memnexa.com/keys,找到要导入的密钥。
  3. 点击导入按钮 在密钥右侧操作区点击 导入到 CC Switch。如果浏览器弹出“是否打开 CC Switch”,选择允许。
  4. 选择客户端类型 普通 Claude/Gemini 分组会直接导入;Antigravity 分组会弹出选择框,按你实际使用的客户端选择 Claude Code 或 Gemini CLI。
  5. 在 CC Switch 中验证 打开供应商列表,确认出现 MemNexa,再切到本地客户端发送一次测试请求。

自动导入会写入 MemNexa 的 Base URL、API Key,以及 /v1/usage 用量查询配置。导入后如果不生效,先重启 CC Switch 和对应客户端。

四、手动配置备用方式

如果点击导入后没有反应,通常是 CC Switch 协议没有注册成功。可以先用下面参数手动创建供应商。

配置项 填写内容 说明
Provider 名称 MemNexa 名称可以自定义,建议保留 MemNexa 方便识别。
API Base URL https://memnexa.com/v1 OpenAI 兼容客户端通常填写带 /v1 的地址。
API Key 复制你在 /keys 创建的密钥 不要复制登录密码,也不要把密钥发给别人。
用量查询地址 https://memnexa.com/v1/usage 如果 CC Switch 支持用量脚本,使用 Bearer API Key 请求这个地址。
排查

点击导入没有反应

  • 确认 CC Switch 已经安装,并且至少启动过一次。
  • 浏览器出现打开外部应用提示时,需要选择允许。
  • 如果还是不行,重启浏览器和 CC Switch,或改用手动配置。
排查

请求失败或无额度

  • 确认密钥状态是 active
  • 确认密钥所属分组支持你选择的模型。
  • 确认账户余额、订阅或分组额度没有用完。

MemNexa 工作人员不会向你索要登录密码、验证码或完整 API Key。遇到所谓“代配置”要求提供这些信息,直接拒绝。