多个 Grok 账户怎么一起用？grok2api 做了一个多账户 API 网关来回答这个问题

你手上有好几个 Grok 账户，但每次用 Claude Code 或 Codex 跑任务，都要手动切换 Key、盯着配额耗尽、遇到 429 就得停下手头的活重新配置？这不是你的问题，是 Grok 官方 API 的使用体验本身就还没那么顺滑。

今天要说的这个开源项目——grok2api，7.1k Star、2.1k Fork，就是来解决这个麻烦的。它是一个多账户 Grok API 网关，把 Build（OAuth）、Web（SSO）和 Console（SSO）三种 Grok 接入方式统一管理起来，对外暴露标准的 OpenAI 和 Anthropic 兼容接口，让 Codex、Claude Code 以及任何 OpenAI SDK 能直接对接，不需要任何魔改。

它实际上在做什么

grok2api 本质上是一个跑在本地的 Go 网关，前端是一个 React 管理界面。你可以往里面批量导入多个 Grok 账户，它会自动维护这些账户的配额、凭证和健康状态。请求进来时，网关根据路由策略分配账户，遇到 429 就自动切换到下一个可用账户，而不是让你的任务卡在那里等手动干预。

三个接入通道的能力边界是不一样的，这是理解 grok2api 的关键：

• Grok Build：通过 OAuth 接入，模型列表来自你账户的实际能力，支持动态模型发现、存储回复、付费账户视频生成。免费账户和付费账户能看到不同的模型集合。
• Grok Web：SSO 方式接入，使用内置模型目录，按账户等级（Basic/Super/Heavy）过滤可用的对话模型、图片生成、图片编辑和视频生成能力。
• Grok Console：SSO 接入，模型列表跟随版本发布，较为固定，但会话转发是无状态的，适合做纯推理类任务。

三种通道的凭证、额度、健康状态、冷却时间都是独立管理的，通道之间的故障转移只发生在同一通道的多个账户之间。

谁会真正用得上它

适合的场景：

如果你在团队里同时运维多个 Grok 账户（比如不同订阅等级，或者有人用 Build 有人用 Web），又需要让 Claude Code、Codex 或其他编程工具稳定接入 Grok，那 grok2api 能帮你省掉大量手动切换和故障恢复的时间。Docker 一键部署，跑起来之后在浏览器里管理账户池，对接端点直接用 OpenAI SDK 调用，体验接近一个自建的模型网关。

它也适合个人用户手里有多个 Grok 账户的情况——比如你注册了多个 X 账号分别拿免费额度，叠加起来跑一些需要持续输出的任务。配额用完自动切下一个，这个体验是官方体验完全没有的。

不适合的场景：

grok2api 不适合完全没有技术背景的普通用户。首次部署需要配置 config.yaml、理解 OAuth/SSO 接入流程，对于只是想找个网页版聊天的用户来说过于复杂。另外，如果你的需求只是偶尔调用一次 Grok，直接用官方 API 或 OpenRouter 会更简单，搭建 grok2api 的成本不划算。

项目文档里也明确写了：“This project is for technical research and learning purposes only. Please comply with Grok’s official terms of use and local laws when using it”——这意味着你需要自己评估合规风险，特别是如果你打算把账户分享给团队成员使用的话。

快速上手，要多久能跑起来

前提：你有一台能跑 Docker 的机器，以及至少一个 Grok 账户。

git clone https://github.com/chenyme/grok2api.git
cd grok2api
cp config.example.yaml config.yaml

生成密钥并填入 config.yaml：

openssl rand -hex 32
openssl rand -base64 32

config.yaml 里填入刚才生成的 jwtSecret 和 credentialEncryptionKey，设置管理员账号密码，然后：

docker compose pull
docker compose up -d
docker compose logs -f grok2api

打开 http://127.0.0.1:8000，用管理员账号登录，连接你的第一个 Grok 账户，等配额同步完成，去 Model Routes 查看可用模型路由，然后在 Client Keys 里创建一个调用密钥，就能用标准 OpenAI SDK 调用了：

POST https://你的服务地址/v1/chat/completions
Authorization: Bearer 你创建的密钥

整个过程熟练的话 15 分钟以内，首次部署可能要花半小时理解配置逻辑。

最新版本里有什么值得关注

grok2api 目前版本是 v3.1.1（2026-08-05），最近三个版本的核心变化值得关注：

• v3.1.1：对齐 DPoP 协议，真实使用配额感知，24 小时恢复探测；支持裸 JSON 数组凭证导入
• v3.1.0：Build 账户检测和路由故障转移改进；修复 Windows 下视频上传的 fsync 只读句柄问题
• v3.0.11：支持选择性分页凭证导出；减少数据库 I/O（延迟凭证水合）；简化出口管理

从版本节奏看，作者在持续完善账户管理精细度和跨平台稳定性，最近几个版本尤其在”用真实配额驱动路由决策”这个方向上有实质推进，不再只是依赖账户状态而是结合实际消耗。

值得注意的使用边界

1. 免费账户和付费账户的模型覆盖差异很大。Grok Build 的模型列表是从每个账户实际能力里动态发现的，不是全局静态列表——这意味着同一个网关里，不同账户可能看到不同的可用模型，路由策略需要理解这个逻辑。
2. Web 账户工具可以自动同意条款、随机生成 20-40 岁生日、开启 NSFW，这个功能对某些用户有用，但开启前请确认你所在司法管辖区的合规要求。
3. Grok Build 目前不暴露图片生成或图片编辑接口，如果你的工作流需要图文混合生成，Web 或 Console 通道更合适。
4. 视频任务（grok-imagine-video）在 Build 通道仅对付费账户开放，免费账户无法通过 Build 生成视频。

下一步建议

如果你认同这个场景，强烈建议先跑一个最小化 demo：只导入一个 Grok 账户，用 Claude Code 的 OPENAI_BASE_URL 配置指向你的网关地址，实跑一次编程任务感受一下路由和 429 自动恢复的体验。这比看文档更能判断它是否值得投入时间部署到生产。

项目的 GitHub 仓库：https://github.com/chenyme/grok2api，文档有中文版本，对于国内用户比较友好。如果你在使用中遇到 429 频繁的问题（Issue 区的高频话题），可以关注一下 v3.1.1 里新增的 24 小时恢复探测和真实配额感知这两个 feature 的实际效果。