文档 · 指南

Groq 接入 Claude Code、Codex 等 Agent

Groq 用自家的 LPU 芯片跑开源模型，以速度快出名，上面既有 OpenAI 的 gpt-oss，也有其他厂商的开源模型。magpie 的 groq 预设把它接到 Claude Code、Codex、OpenCode 等 Agent：一把 Groq 的 Key，模型列表由 Groq 自己给出。

添加

拿一把 Key。在 console.groq.com/keys 创建一把 API Key。
添加。在应用里选 Groq，把 Key 填进 API 密钥，或者在命令行：

终端

magpie provider add groq 
magpie provider test groq

预设里 Chat Completions 和 Responses 都指向 https://api.groq.com/openai/v1，不用自己填地址。在 OpenCode 等其他应用里配过的 Groq 供应商，导入时也会变成 groq 预设。

给 Agent 用

模型 id 写成 groq/<Groq 的模型 id>：

终端

magpie claude groq/openai/gpt-oss-120b
magpie codex groq/openai/gpt-oss-120b

Claude Code 这类说 Anthropic 协议的 Agent，请求由 magpie 转成 Chat Completions 发给 Groq：Groq 的 Chat 接口会报告缓存命中，所以用量页能看到读了多少缓存。

Groq 上的模型大多来自其他厂商，models.dev 也把它们列在 Groq 名下，所以 magpie 不把 Groq 的列表当作模型厂商自己的说法。

限速和上下文

Groq 的 429 会写出是哪个模型限速了（for model `…`）。magpie 只让这把 Key 上的这个模型休息，其他模型照常可用；没有写出模型的 429 才让整把 Key 休息。
Groq 说「reduce the length of the messages」时，magpie 把它认作上下文超长，改写成 Agent 认得的超长错误（例如 OpenAI 的 context_length_exceeded），Agent 就会自己压缩上下文，而不是反复重试。
Groq 不接受某个字段时会回 400 说「unsupported」。对 magpie 自己加的缓存 key 等字段，magpie 会去掉它再问一次，之后也不再发给 Groq。

语音转文字和语音合成

magpie 网关的 /v1/audio/transcriptions 和 /v1/audio/speech 也能用 Groq：表单和音频原样发给 Groq，只把模型换成 Groq 自己的 id，返回 Groq 的原始格式。语音合成同理，model 写 groq/playai-tts。

终端

curl http://127.0.0.1:3425/v1/audio/transcriptions \
  -H 'Authorization: Bearer magpie' \
  -F model=groq/whisper-large-v3 -F file=@meeting.m4a

几点说明

Groq 在路由组里和其他供应商一样排队：一个失败了，组里的下一个接着回答。
一把 Key 不够用时，可以再加一把，作为同一个供应商的另一个账号。

Fireworks 与 Fireworks Nexus 接入 Claude Code、Codex 等 Agent

常见问题

magpie 支持 Groq 吗？

支持，用 groq 预设。填一把 Groq 的 API Key，Chat Completions 和 Responses 接口都已配好，模型由 Groq 的列表给出，模型 id 写成 groq/<模型>。

Claude Code 能用 Groq 上的模型吗？

能。magpie 把 Claude Code 的 Anthropic 请求转成 Chat Completions 发给 Groq，Groq 的 Chat 接口会报告缓存命中，用量里能看到。

Groq 限速了怎么办？

Groq 的 429 写明了模型时，magpie 只让这个模型在这把 Key 上休息，其他模型照常用；路由组里还有别的供应商时，请求会交给下一个。

能用 Groq 的 Whisper 吗？

能。向 magpie 的 /v1/audio/transcriptions 发 OpenAI 格式的表单，model 写 groq/whisper-large-v3；语音合成用 /v1/audio/speech。