magpie
magpie
magpie 是一个桌面应用，让 Claude Code、Codex、OpenCode、Gemini CLI 等编程智能体共用同一个服务商。导入上上之钥的 Key 后，每个工具都会走它原生支持的接口：Claude Code 用 Anthropic Messages，Codex 用 OpenAI Responses，其他工具用 Chat Completions。导入时 magpie 会自动读取可用模型。
最快的方式是在控制台 API 密钥页面点击 Key 右侧的导入 magpie，一键写入所有接口地址和密钥。
第一步：安装 magpie
打开 magpie 官网，下载对应系统的安装包（支持 macOS、Windows、Linux），版本需要 0.1.8 或更新； 按系统完成安装： macOS：把 magpie 拖进应用程序（Applications）文件夹； Windows：运行安装程序； Linux：按安装包说明安装，安装后会生成桌面启动项； 安装后至少打开一次 magpie。
magpie 需要先打开一次才会向系统注册 magpie:// 链接。没打开过就点一键导入，浏览器会没有反应，或者提示「magpie 未安装或版本过旧」。
第二步：一键导入 Key
登录控制台，进入 API 密钥页面。还没有 Key 的话先点创建密钥； 在要使用的 Key 右侧点击导入 magpie（也可以点使用密钥，在弹窗里点一键导入到 magpie）； 在弹出的列表里选择你要用的工具（Claude Code、Codex、Gemini CLI、OpenCode、Pi、Hermes Agent、Grok Build 等）； 浏览器询问是否打开 magpie 时选择允许 / 打开； magpie 弹出确认窗口，会列出服务商名称、Key 将发往的地址和模型列表。核对地址是本站（https://upupkey.com）后点击 Add 保存。
网页会接着提示下一步：在 magpie 的「Agents」页为刚才选的工具选择模型，并给出可直接使用的模型名（例如 zerotoken/claude-sonnet-5-5）。magpie 只需导入一次，其他工具也可以在「Agents」页选同一个服务商。
导入链接里的 Key 只会交给你本机的 magpie，不会经过 magpie 的服务器。
导入后，magpie 会按 Key 所属分组拿到这些接口：
同一个服务商重复导入时，确认按钮会变成 Replace，会覆盖之前的配置。更换 Key 或分组之后，直接重新导入一次即可。
第三步：在编程工具中使用
在 magpie 里为 Claude Code、Codex 等工具选择刚导入的上上之钥服务商和模型，然后在终端里正常启动：
在需要「服务商/模型」格式的工具里，模型写成服务商 ID/模型名。服务商 ID 是名称转成小写、空格和符号换成短横线，例如名称为 ZeroToken 时 ID 是 zerotoken，可以在 magpie 的服务商详情里查看。
用 Claude 分组跑 Codex
Claude 分组的 Key 也能在 Codex 中使用，magpie 会把 Codex 的请求直接发到本站的 /v1/responses，模型选 claude-sonnet-5-5 等 Claude 模型即可。
如果你在这项功能上线前就导入过，Codex 可能仍然用不了 Claude 模型。请在 magpie 里删除这个服务商，再从控制台重新一键导入一次。
手动添加
在 magpie 中新建服务商，按下表填写：
magpie 只接受 https 地址。地址填错（例如 Anthropic 地址多加了 /v1）会出现 /v1/v1/... 的 404 错误。