MiniMax | shunt

用 MINIMAX_API_KEY 将 MiniMax-M3(1M 上下文)路由到 MiniMax 的兼容 Anthropic 端点。

MiniMax 通过一个兼容 Anthropic 的端点提供其模型 —— shunt 原样转发 Claude Code 的 Messages 请求并注入 MiniMax API 密钥。没有内置的预设,因此上游需显式声明 kind 和 base_url。

快速开始

让编码 agent 为你完成接入 —— 对于没有具名蓝图的提供方,shunt add 会把文档 URL 注入其通用调研指南(离线且只读;配置由 agent 编辑,该命令绝不会修改配置):

shunt add upstream https://platform.minimax.io/docs/token-plan/claude-code --print | claude

或者按照下面的手动步骤操作。

配置上游

[[upstreams]]
name = "anthropic"
provider = "anthropic"   # 让 Anthropic 作为无路由匹配模型(例如 claude-*)的默认项

[[upstreams]]
name = "minimax"
kind = "anthropic"
base_url = "https://api.minimax.io/anthropic"
auth = { mode = "api_key", env = "MINIMAX_API_KEY" }

[[routes]]
model = "MiniMax-M3"
provider = "minimax"

有序的 [[upstreams]] 会替换 shunt 的内置提供方,因此该配置必须声明它仍然回退到的 anthropic 默认项(server.default_provider 默认为 anthropic)。

旧的 [providers.minimax] 表形式仍然受支持 —— 但不要在同一个文件中混用 [[upstreams]] 和 [providers.*]。

凭据

export MINIMAX_API_KEY='...'

绝不要把密钥写进配置。shunt check 校验配置的结构,但不会读取密钥的值 —— 如果 MINIMAX_API_KEY 未设置,第一个被路由到 minimax 的请求会返回一个认证错误。

模型

模型 id	说明
`MiniMax-M3`	1M token 上下文;客户端可能会附加 Claude Code 的 `[1m]` 标记(`MiniMax-M3[1m]`,也就是 MiniMax 自己的 Claude Code 接入文档所记载的 slug)—— shunt 会在匹配前把它剥离,所以请路由不带后缀的 id

在 Claude Code 中通过 ANTHROPIC_MODEL、ANTHROPIC_CUSTOM_MODEL_OPTION 或子 agent 的 model: frontmatter 选择那个已路由的 id。若想改为在 /model 选择器中呈现一个条目, 请用 [models.upstream_model] 映射声明一个以 claude 为前缀的别名 —— 见模型发现。被映射的 id 不得以 [1m] 结尾 —— 客户端会在匹配前剥离该提示,这也使得以 MiniMax-M3[1m] 为键的 [[routes]] 条目不可达,所以请始终路由不带后缀的 MiniMax-M3。

校验

shunt check    # -> config ok
shunt run
curl -sS http://127.0.0.1:3001/v1/messages \
  -H 'anthropic-version: 2023-06-01' \
  -H 'content-type: application/json' \
  -d '{"model":"MiniMax-M3[1m]","max_tokens":16,"messages":[{"role":"user","content":"Reply with OK."}]}'

确认响应的 x-gateway-upstream 头写的是 minimax,然后将 Claude Code 指向 shunt。

子 agent 插件

shunt-minimax 插件为上面那个模型提供一个现成的 Claude Code 子 agent:

/plugin marketplace add pleaseai/shunt
/plugin install shunt-minimax@shunt