ByteNoteByteNote
字

字节笔记本

2026年6月21日

hermes教程-MiniMax OAuth

#Claude Code
API中转
¥120
每日科技简报 · 每天一篇,快速了解科技圈大事

概述

项目值
提供商 IDminimax-oauth
显示名称MiniMax (OAuth)
认证类型浏览器 OAuth（PKCE 重定向流程）
传输层Anthropic Messages 兼容（anthropic_messages）
模型MiniMax-M2.7、MiniMax-M2.7-highspeed
全球端点https://api.minimax.io/anthropic
中国端点https://api.minimaxi.com/anthropic
需要环境变量否（此提供商不使用 MINIMAX_API_KEY）

前提条件

  • Python 3.9+
  • 已安装 Hermes Agent
  • 拥有 minimax.io（全球）或 minimaxi.com（中国）的 MiniMax 账户
  • 本地机器上可用的浏览器（远程会话可使用 --no-browser）

快速开始

bash
## 启动提供商和模型选择器
hermes model
## → 从提供商列表中选择 "MiniMax (OAuth)"
## → Hermes 会在浏览器中打开 MiniMax 授权页面
## → 在浏览器中批准访问
## → 选择一个模型（MiniMax-M2.7 或 MiniMax-M2.7-highspeed）
## → 开始对话

hermes

首次登录后，凭据会存储在 ~/.hermes/auth.json 中，并在每次会话前自动刷新。

手动登录

你可以不通过模型选择器直接触发登录：

bash
hermes auth add minimax-oauth

中国区域

如果你的账户位于中国平台（minimaxi.com），请改用基于 API 密钥的 minimax-cn 提供商——minimax-cn 仅注册了 auth_type="api_key"（无 OAuth 流程）。直接配置 MINIMAX_CN_API_KEY（以及可选的 MINIMAX_CN_BASE_URL）：

bash
echo 'MINIMAX_CN_API_KEY=your-key' >> ~/.hermes/.env

远程 / 无头会话

在无浏览器的服务器或容器上：

bash
hermes auth add minimax-oauth --no-browser

Hermes 会打印验证 URL 和用户代码——在任何设备上打开该 URL，并在提示时输入代码。

OAuth 流程

Hermes 针对 MiniMax OAuth 端点实现了 PKCE 浏览器 OAuth 流程：

  1. Hermes 生成一对 PKCE 验证器/挑战码以及一个随机 state 值。
  2. 它向 {base_url}/oauth/code 发送 POST 请求（包含挑战码），并收到 user_code 和 verification_uri。
  3. 你的浏览器打开 verification_uri。如果提示，请输入 user_code。
  4. Hermes 轮询 {base_url}/oauth/token，直到收到令牌（或超时）。
  5. 令牌（access_token、refresh_token、过期时间）会保存到 ~/.hermes/auth.json 中的 minimax-oauth 键下。

令牌刷新（标准 OAuth refresh_token 授权）会在每次会话启动时自动执行（当访问令牌距离过期不足 60 秒时）。

检查登录状态

bash
hermes doctor

◆ Auth Providers 部分会显示：

✓ MiniMax OAuth (logged in, region=global)

或者，如果未登录：

⚠ MiniMax OAuth (not logged in)

切换模型

bash
hermes model
## → 选择 "MiniMax (OAuth)"
## → 从模型列表中选取

或者直接设置模型：

bash
hermes config set model.default MiniMax-M2.7
hermes config set model.provider minimax-oauth

配置参考

登录后，~/.hermes/config.yaml 会包含类似以下条目：

yaml
model:
  default: MiniMax-M2.7
  provider: minimax-oauth
  base_url: https://api.minimax.io/anthropic

区域端点

提供商 ID门户推理端点
minimax-oauth（全球）https://api.minimax.iohttps://api.minimax.io/anthropic
minimax-cn（中国）https://api.minimaxi.comhttps://api.minimaxi.com/anthropic

提供商别名

以下所有别名均解析为 minimax-oauth：

bash
hermes --provider minimax-oauth    # 规范名称
hermes --provider minimax-portal   # 别名
hermes --provider minimax-global   # 别名
hermes --provider minimax_oauth    # 别名（下划线形式）

环境变量

minimax-oauth 提供商不使用 MINIMAX_API_KEY 或 MINIMAX_BASE_URL。这些变量仅用于基于 API 密钥的 minimax 和 minimax-cn 提供商。

变量作用
MINIMAX_API_KEY仅由 minimax 提供商使用——minimax-oauth 忽略
MINIMAX_CN_API_KEY仅由 minimax-cn 提供商使用——minimax-oauth 忽略

要将 minimax-oauth 设为活动提供商，请在 config.yaml 中设置 model.provider: minimax-oauth（使用 hermes setup 进行引导流程），或为单次调用传递 --provider minimax-oauth：

bash
hermes --provider minimax-oauth

模型

模型最佳用途
MiniMax-M2.7长上下文推理、复杂工具调用
MiniMax-M2.7-highspeed低延迟、轻量任务、辅助调用

两个模型均支持最多 200,000 个 token 的上下文。

当 minimax-oauth 是主要提供商时，MiniMax-M2.7-highspeed 也会自动用作视觉和委派任务的辅助模型。

故障排除

令牌过期——未自动重新登录

Hermes 会在每次会话启动时刷新令牌（如果距离过期不足 60 秒）。如果访问令牌已过期（例如长时间离线后），刷新会在下一次请求时自动进行。如果刷新失败并返回 refresh_token_reused 或 invalid_grant，Hermes 会将会话标记为需要重新登录。

当刷新失败是致命性的（HTTP 4xx、invalid_grant、授权已撤销等），Hermes 会将刷新令牌标记为失效并在本地隔离，以免重复重试失败的交换。代理会显示一条“需要重新认证”的消息，并在你重新登录前保持静默。

修复： 再次运行 hermes auth add minimax-oauth 以开始新的登录。隔离会在下一次成功交换后清除。

授权超时

设备码流程有固定的过期窗口。如果你未及时批准登录，Hermes 会引发超时错误。

修复： 重新运行 hermes auth add minimax-oauth（或 hermes model）。流程会重新开始。

状态不匹配（可能的 CSRF）

Hermes 检测到授权服务器返回的 state 值与它发送的不匹配。

修复： 重新运行登录。如果问题持续，请检查是否有代理或重定向修改了 OAuth 响应。

从远程服务器登录

如果 hermes 无法打开浏览器窗口，请使用 --no-browser：

bash
hermes auth add minimax-oauth --no-browser

Hermes 会打印 URL 和代码。在任何设备上打开该 URL 并完成流程。

运行时出现“未登录 MiniMax OAuth”错误

认证存储中没有 minimax-oauth 的凭据。你尚未登录，或者凭据文件已被删除。

修复： 运行 hermes model 并选择 MiniMax (OAuth)，或运行 hermes auth add minimax-oauth。

登出

要删除存储的 MiniMax OAuth 凭据：

bash
hermes auth remove minimax-oauth

另请参阅

Claude Code
上一篇

hermes教程-Webhooks

下一篇

hermes教程-MiniMax OAuth

分享: