apizt Switch 一键配置工具(新手推荐)

用 apizt Switch 配置 Codex、Claude Code、OpenCode 等工具。

1. 下载并安装

请选择你电脑对应的版本。当前安装包为 2.4.0。

不确定下载哪个?查看安装方法
  • Windows:在「设置 → 系统 → 系统信息」查看「系统类型」。如果显示 x64,下载 Windows 版,双击安装包。
  • Mac:点击左上角苹果菜单 →「关于本机」。显示「芯片 Apple M…」选苹果芯片版,显示「处理器 Intel」选 Intel 版。打开下载的文件,把 apizt Switch 拖到「应用程序」。最低支持 macOS 12。
Mac 打不开?查看处理方法

提示「无法验证开发者」 从本页下载并尝试打开后,进入「系统设置 → 隐私与安全性」,点击「仍要打开」。

提示「App 已损坏」 请将本页下载的 App 拖入「应用程序」,然后在「终端」执行:

xattr -cr /Applications/tokenba-switch.app

2. 准备 API Key

API Key 是工具连接 apizt 用的密钥。已经有 Key?直接去选工具。

查看创建 API Key 的图文步骤。复制自己的 Key,留到下一步填写。

3. 选一个工具,跟着图配置

点你正在用的工具,展开对应步骤。图片可以点开看大图。

Claude Code(终端版)

  1. 添加供应商

    打开 apizt Switch,在左边选「Claude Code」,点「添加供应商」。

  2. 填写 API Key

    把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。

    填写 API Key,核对请求地址和上游格式。
    图 1 填写 API Key,核对请求地址和上游格式。
    预填模型可换成自己实际要用的模型,改好后点击「添加」。
    图 2 预填模型可换成自己实际要用的模型,改好后点击「添加」。
  3. 开始路由

    点右下角「添加」。回到列表,点「开始路由」,选中 apizt 并确认。看到「路由中」后,重新打开终端里的 claude。使用时保持 apizt Switch 开着。

    在 Claude Code 的路由确认框选 apizt。
    图 3 在 Claude Code 的路由确认框选 apizt。
查看具体参数和更多操作

请求地址用 https://api.apizt.com。在「高级选项」保留「OpenAI Chat Completions (需开启路由)」,「完整 URL」保持关闭。模型映射预填 Sonnet claude-sonnet-5-5、Opus claude-opus-5-5、Fable claude-fable-5-1、Haiku claude-haiku-5-5,默认兜底模型为 claude-sonnet-5-5。「实际请求模型」使用完整模型 ID,显示名称填同一个 ID。预填模型仅作示例,可换成自己实际要用的模型。请填写当前 API Key 可调用的完整模型 ID。

点击右下角「添加」。回到供应商列表,点「开始路由」,将「路由到」选为 apizt,再确认「开始路由」。卡片显示「路由中」后,重新打开终端里的 claude,并保持 apizt Switch 运行。

试发一条消息 · 返回工具列表

Claude(桌面版)

  1. 添加供应商

    打开 apizt Switch,在左边选「Claude Desktop」,点「添加供应商」。

  2. 填写 API Key

    把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。

    核对桌面版的请求地址、模型类型与上游格式。
    图 4 核对桌面版的请求地址、模型类型与上游格式。
    可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
    图 5 可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
  3. 开始路由

    点右下角「添加」。回到列表,点「开始路由」,选中 apizt 并确认。看到「路由中」后,完全退出 Claude 桌面版,再重新打开。使用时保持 apizt Switch 开着。在模型菜单选你配置的模型。

查看具体参数和更多操作

请求地址用 https://api.apizt.com。「模型类型」选「模型映射」,「上游格式」保留「OpenAI Chat Completions (需开启路由)」。各档实际请求模型预填 Sonnet claude-sonnet-5-5、Opus claude-opus-5-5、Fable claude-fable-5-1、Haiku claude-haiku-5-5。菜单显示名称填对应的模型 ID。预填模型仅作示例,可换成自己实际要用的模型。请填写当前 API Key 可调用的完整模型 ID。

点击「添加」。回到供应商列表,点「开始路由」,将「路由到」选为 apizt,再确认「开始路由」。卡片显示「路由中」后,彻底退出并重新打开 Claude 桌面版,并保持 apizt Switch 运行。 在模型菜单选择映射后的条目。切换路由供应商后也要重新打开桌面版,让它读取新的模型映射。

试发一条消息 · 返回工具列表

Codex

  1. 添加供应商

    打开 apizt Switch,在左边选「Codex」,点「添加供应商」。

    在 Codex 页面点击「添加供应商」。
    图 6 在 Codex 页面点击「添加供应商」。
  2. 填写 API Key

    把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。

    模型可换成自己实际要用的模型。填好 API Key,核对请求地址后点击「添加」。
    图 7 模型可换成自己实际要用的模型。填好 API Key,核对请求地址后点击「添加」。
  3. 开始路由

    点右下角「添加」。回到列表,点「开始路由」,选中 apizt 并确认。看到「路由中」后,重新打开 Codex。用桌面版就完全退出再打开,用编辑器插件就重开编辑器窗口。使用时保持 apizt Switch 开着。

    在 Codex 的路由确认框选 apizt。
    图 8 在 Codex 的路由确认框选 apizt。
查看具体参数和更多操作

「API 请求地址」保留 https://api.apizt.com/v1,「高级选项」里的上游格式保留「Chat Completions(需转换)」。模型列表预填 gpt-6.1-sol,可换成自己实际要用的模型。在「实际请求模型」填完整模型 ID,菜单显示名填同一个 ID,并确认当前 API Key 可调用该模型。

点击右下角「添加」。回到供应商列表,点「开始路由」,将「路由到」选为 apizt,再确认「开始路由」。卡片显示「路由中」后,重新打开 Codex,并保持 apizt Switch 运行。 桌面端要彻底退出,编辑器插件要重开编辑器窗口。

试发一条消息 · 返回工具列表

Gemini CLI

  1. 添加供应商

    打开 apizt Switch,在左边选「Gemini CLI」,点「添加供应商」。

  2. 填写 API Key

    把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。

    填写 API Key,核对 Gemini CLI 的请求地址和模型。
    图 9 填写 API Key,核对 Gemini CLI 的请求地址和模型。
  3. 开始路由

    点右下角「添加」。回到列表,点「开始路由」,选中 apizt 并确认。看到「路由中」后,退出 Gemini CLI,再运行 gemini。使用时保持 apizt Switch 开着。

查看具体参数和更多操作

「请求地址」用 https://api.apizt.com,沿用 Gemini 原生协议。模型预填 gemini-4-argon。预填模型仅作示例,可换成自己实际要用的模型。请填写当前 API Key 可调用的完整模型 ID。 选择支持 Gemini 原生协议的模型。

点击「添加」。回到供应商列表,点「开始路由」,将「路由到」选为 apizt,再确认「开始路由」。卡片显示「路由中」后,退出并重新运行 gemini,并保持 apizt Switch 运行。

试发一条消息 · 返回工具列表

Grok Build

  1. 添加供应商

    打开 apizt Switch,在左边选「Grok Build」,点「添加供应商」。

  2. 填写 API Key

    把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。

    填写 API Key,核对请求地址与默认模型。
    图 10 填写 API Key,核对请求地址与默认模型。
  3. 开始路由

    点右下角「添加」。回到列表,点「开始路由」,选中 apizt 并确认。看到「路由中」后,重启 Grok Build。使用时保持 apizt Switch 开着。

查看具体参数和更多操作

「API 请求地址」保留 https://api.apizt.com/v1,默认模型预填 grok-4.7。在「高级选项」保留「Chat Completions(需转换)」。预填模型仅作示例,可换成自己实际要用的模型。请填写当前 API Key 可调用的完整模型 ID。

点击「添加」。回到供应商列表,点「开始路由」,将「路由到」选为 apizt,再确认「开始路由」。卡片显示「路由中」后,重启 Grok Build,并保持 apizt Switch 运行。

试发一条消息 · 返回工具列表

OpenCode

  1. 添加供应商

    打开 apizt Switch,在左边选「OpenCode」,点「添加供应商」。

  2. 填写 API Key

    把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。

    核对 OpenCode 的接口格式、API Key 和 Base URL。
    图 11 核对 OpenCode 的接口格式、API Key 和 Base URL。
    可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
    图 12 可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
  3. 添加并打开工具

    点右下角「添加」。若 apizt 卡片还在「可添加」区,点卡片上的加号。重开 OpenCode,在模型列表里选 apizt 和你要用的模型。

    若卡片在「可添加」,点击加号写入 OpenCode 配置。
    图 13 若卡片在「可添加」,点击加号写入 OpenCode 配置。
    如需设为默认,使用 apizt 卡片的更多菜单。
    图 14 如需设为默认,使用 apizt 卡片的更多菜单。
查看具体参数和更多操作

「供应商标识」保留 apizt,「Base URL」用 https://api.apizt.com/v1。接口格式保留「OpenAI Compatible」。 「模型配置」预填 claude-sonnet-5-5。预填模型仅作示例,可换成自己实际要用的模型。请填写当前 API Key 可调用的完整模型 ID。

填好后点右下角「添加」。如果 apizt 仍在「可添加」区,再点卡片上的「添加」,使其进入「已添加」。 重新打开 OpenCode,从 apizt 供应商选择目标模型。需要设为默认时,可在「已添加」卡片的「更多」菜单选择「设为默认」。

试发一条消息 · 返回工具列表

OpenClaw

  1. 添加供应商

    打开 apizt Switch,在左边选「OpenClaw」,点「添加供应商」。

  2. 填写 API Key

    把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。

    核对 API 协议、API 端点并填入自己的 API Key。
    图 15 核对 API 协议、API 端点并填入自己的 API Key。
    可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
    图 16 可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
  3. 添加并打开工具

    点右下角「添加」。若卡片还在「可添加」区,点卡片上的「添加」。在 apizt 卡片的「更多」菜单里把目标模型设为默认。再打开 OpenClaw 的新会话。

查看具体参数和更多操作

「供应商标识」保留 apizt。「API 协议」选「Anthropic Messages」,「API 端点」用 https://api.apizt.com/v1。预填模型 claude-sonnet-5-5。预填模型仅作示例,可换成自己实际要用的模型。请填写当前 API Key 可调用的完整模型 ID。

填好后点右下角「添加」。如果 apizt 仍在「可添加」区,再点卡片上的「添加」,使其进入「已添加」。 在「已添加」卡片的「更多」中可将 apizt 的模型「设为默认」。用 openclaw models status 查看默认模型,再到 OpenClaw 的新会话测试。

试发一条消息 · 返回工具列表

Hermes

  1. 添加供应商

    打开 apizt Switch,在左边选「Hermes」,点「添加供应商」。

  2. 填写 API Key

    把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。

    核对 Hermes 的 API 模式、端点和 API Key。
    图 17 核对 Hermes 的 API 模式、端点和 API Key。
    可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
    图 18 可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
  3. 添加并打开工具

    点右下角「添加」。若卡片还在「可添加」区,点卡片上的「添加」。在 apizt 卡片的「更多」菜单里点「设为默认」。再运行 hermes chat。

查看具体参数和更多操作

「API 模式」保留「Anthropic Messages」,「API 端点」用 https://api.apizt.com/v1,模型示例为 claude-sonnet-5-5。预填模型仅作示例,可换成自己实际要用的模型。请填写当前 API Key 可调用的完整模型 ID。 需要更换默认模型时,把要用的模型放在列表第一项。

填好后点右下角「添加」。如果 apizt 仍在「可添加」区,再点卡片上的「添加」,使其进入「已添加」。 在「已添加」卡片的「更多」中选择「设为默认」。重新运行 hermes chat,用新会话确认实际模型。

试发一条消息 · 返回工具列表

Pi

  1. 添加供应商

    打开 apizt Switch,在左边选「Pi」,点「添加供应商」。

  2. 填写 API Key

    把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。

    填写 API Key,核对 Pi 的接口格式与 Base URL。
    图 19 填写 API Key,核对 Pi 的接口格式与 Base URL。
    可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
    图 20 可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
  3. 添加并打开工具

    点右下角「添加」。若卡片还在「可添加」区,点卡片上的「启用」。重开 Pi,在模型选择器中选 apizt 和你要用的模型。

查看具体参数和更多操作

「供应商标识」保留 apizt,「Base URL」用 https://api.apizt.com/v1。接口格式保留「OpenAI Chat Completions」。 模型预填 gpt-6.1-sol。预填模型仅作示例,可换成自己实际要用的模型。请填写当前 API Key 可调用的完整模型 ID。

填好后点右下角「添加」。如果 apizt 仍在「可添加」区,再点卡片上的「启用」,使其进入「已添加」。 重开 Pi,在模型选择器选择 apizt 下的模型。例如使用 pi --model apizt/gpt-6.1-sol,模型 ID 换成你实际配置的值。

试发一条消息 · 返回工具列表

MiniMax Code

  1. 添加供应商

    打开 apizt Switch,在左边选「MiniMax Code」,点「添加供应商」。

  2. 填写 API Key

    把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。

    核对 MiniMax Code 的接口格式、API Key 和 Base URL。
    图 21 核对 MiniMax Code 的接口格式、API Key 和 Base URL。
    可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
    图 22 可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
  3. 添加并打开工具

    点右下角「添加」。若卡片还在「可添加」区,点卡片上的「添加」。重开 MiniMax Code。用终端版时,运行 mcode 后输入 /provider,选 apizt 下的模型。

查看具体参数和更多操作

「Base URL」用 https://api.apizt.com/v1。接口格式保留「OpenAI Chat Completions」。 模型预填 gpt-6.1-sol。预填模型仅作示例,可换成自己实际要用的模型。请填写当前 API Key 可调用的完整模型 ID。

填好后点右下角「添加」。如果 apizt 仍在「可添加」区,再点卡片上的「添加」,使其进入「已添加」。 重新打开 MiniMax Code。终端版运行 mcode 后输入 /provider,选择 apizt 下的目标模型。

试发一条消息 · 返回工具列表

Kimi Code

  1. 添加供应商

    打开 apizt Switch,在左边选「Kimi Code」,点「添加供应商」。

  2. 填写 API Key

    把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。

    填写 API Key,核对 Kimi Code 的请求地址和接口格式。
    图 23 填写 API Key,核对 Kimi Code 的请求地址和接口格式。
    可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
    图 24 可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
  3. 添加并打开工具

    点右下角「添加」。若卡片还在「可添加」区,点卡片上的「添加」。重开 Kimi Code,输入 /model,选 apizt 下的模型。

查看具体参数和更多操作

「Base URL」用 https://api.apizt.com/v1。接口格式保留「OpenAI Chat Completions」。 模型预填 gpt-6.1-sol。预填模型仅作示例,可换成自己实际要用的模型。请填写当前 API Key 可调用的完整模型 ID。 若手动加模型,按该模型的实际能力填写上下文窗口。

填好后点右下角「添加」。如果 apizt 仍在「可添加」区,再点卡片上的「添加」,使其进入「已添加」。 重新打开 Kimi Code,用 /model 选择 apizt 的模型。也可从 apizt 卡片的「更多」菜单选择「设为默认」。

试发一条消息 · 返回工具列表

DeepSeek Harness

  1. 添加供应商

    打开 apizt Switch,在左边选「DeepSeek Harness」,点「添加供应商」。

  2. 填写 API Key

    把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。

    核对 DeepSeek Harness 的接口格式、API Key 和 Base URL。
    图 25 核对 DeepSeek Harness 的接口格式、API Key 和 Base URL。
    可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
    图 26 可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
  3. 添加并打开工具

    点右下角「添加」。若卡片还在「可添加」区,点卡片上的「添加」。重开 DeepSeek Harness,在模型选择器里选 apizt 和你要用的模型。

查看具体参数和更多操作

「Base URL」用 https://api.apizt.com/v1。接口格式保留「OpenAI Chat Completions」。 预填 gpt-6.1-sol。预填模型仅作示例,可换成自己实际要用的模型。请填写当前 API Key 可调用的完整模型 ID。

填好后点右下角「添加」。如果 apizt 仍在「可添加」区,再点卡片上的「添加」,使其进入「已添加」。 重新打开 DeepSeek Harness,在模型选择器里选 apizt 及目标模型。若使用网页界面,可从终端运行 dsh web 打开。

试发一条消息 · 返回工具列表

Antigravity

  1. 添加供应商

    打开 apizt Switch,在左边选「Antigravity」,点「添加供应商」。

  2. 填写 API Key

    粘贴自己的 API Key,点「获取模型列表」。模型可换成自己实际要用的模型,这里填 agy 支持的 Gemini 模型显示名称。

    核对 API Key 和请求地址,将模型换成 agy 实际支持的名称。
    图 27 核对 API Key 和请求地址,将模型换成 agy 实际支持的名称。
  3. 从 apizt 卡片打开终端

    点「添加」。回到 apizt 卡片,点「使用此供应商打开终端」。在打开的 agy 会话里测试。

查看具体参数和更多操作

本节用于 Antigravity CLI(agy)。「请求地址」用 https://api.apizt.com。预填模型仅作示例,可换成自己实际要用的模型。点「获取模型列表」,在「模型」填写当前 agy 支持的 Gemini 模型显示名称,并确认 apizt API Key 可调用对应模型。

点击「添加」,回到 apizt 卡片,点「使用此供应商打开终端」,在打开的 agy 会话测试。API Key 和请求地址只传给该次启动的进程。

试发一条消息 · 返回工具列表

4. 试发一条消息

在刚配好的工具里开一个新会话,选好模型,发送「你好」。收到回复后,到 apizt 控制台的请求日志核对时间和模型。

遇到问题,可以展开下面的排错说明,或联系支持。

查看版本、配置速查和排错

更新于

适用范围:apizt Switch 2.4.0,适用于 macOS(苹果芯片、Intel)及 Windows x64。

版本与验证:配置图取自 macOS 苹果芯片版 apizt Switch 2.4.0,安装包覆盖 macOS 与 Windows x64。截图核对表单和操作入口,模型调用以你的客户端实际回复及请求日志为准。

配置速查

配置项填写内容注意事项
安装包2.4.0按系统与芯片架构选择。
供应商apizt在左侧选择实际使用的客户端,再点添加供应商。
API Key控制台创建的令牌请求地址和接口格式已有预设;模型须在令牌可用范围内。
启用配置按工具小节操作开始路由、添加到客户端,或从供应商卡片打开终端。

还没有 API Key?注册获取免费体验额度 · 已注册:进入控制台创建 API Key

为此工具单独创建令牌,并设置合理额度和模型权限。截图中的模型仅作示例,以账号当前可用模型为准;不要公开密钥或上传含密钥的配置文件。

怎样确认配置已生效

  1. 按对应小节完成启用,选择自己实际要用的模型。
  2. 在目标客户端发送短消息,检查回复和 apizt 控制台请求日志。

接入失败时逐项检查

现象检查与处理
找不到「开始路由」在页内选择你正在用的工具,核对该工具小节的启用方式。
路由启动失败检查默认本地端口 15722 是否被占用,或查看「路由设置」中的实际端口。
客户端仍显示旧模型彻底退出目标客户端再打开;编辑器插件需重开编辑器窗口。检查实际请求模型 ID 和令牌权限。
下载后无法打开核对系统和芯片类型。Mac 用户可回到下载区展开「Mac 打不开?查看处理方法」。
想停止路由打开「设置 → 路由 → 恢复客户端配置」,选择「停止并恢复」。正常退出 apizt Switch 也会恢复启动路由前的配置。
从旧版升级升级前备份应用数据目录,macOS 默认位置为 ~/.tokenba-switch。新版会迁移数据库,如需退回旧版请使用升级前的备份。

资料与下一步

遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID,联系支持时先隐藏 API Key。