怎么接入 Grok — 让 Cursor、Codex、Claude Code、Trae、ZCode 用上 xAI Grok 模型

Grok 是 xAI 推出的大语言模型，推理能力强、上下文窗口大，通过官方 OAuth 授权即可免费使用。

但大多数 AI 编程工具——Cursor、Codex、Claude Code、Trae、ZCode 等——只认 OpenAI 或 Anthropic 格式的 API，不能直接调用 Grok。

GrokProxy 就是解决方案：一个轻量桌面代理，在本地把 Grok 同时转成 OpenAI 和 Anthropic 兼容接口。你现有的工具不用换、不用改，指向本地地址就能用 Grok。

你的 AI 工具  ──OpenAI / Anthropic API──▶  GrokProxy (本地)  ──xAI API──▶  Grok

安装 GrokProxy

从 Releases 下载对应平台的安装包，或访问 https://github.com/werbenhu/grok-proxy 了解更多：

平台	文件
Windows x64	GrokProxy-*-windows-amd64.exe
Windows ARM64	GrokProxy-*-windows-arm64.exe
macOS Intel	GrokProxy-*-darwin-amd64.app.zip
macOS Apple Silicon	GrokProxy-*-darwin-arm64.app.zip

启动并授权

1. 打开 GrokProxy
2. 选择授权方式：
   • 网站授权（推荐）：点击「开始授权」，浏览器跳转 xAI 官方登录，令牌自动刷新
   • xAI API Key：直接粘贴 api.x.ai 密钥
3. 点击「启动代理」

界面会显示本地地址（默认 http://127.0.0.1:8181）和本地代理密钥。关闭窗口不会停止服务——GrokProxy 会最小化到系统托盘，右键图标可以「打开主界面」或「退出」。

配置客户端

启动代理后，把你的 AI 工具指向本地地址即可：

• OpenAI 兼容工具（Cursor、Codex、Aider、Trae、ZCode 等）：Base URL 填 http://127.0.0.1:8181/v1，API Key 填本地代理密钥，模型填 grok-4.5
• Anthropic 兼容工具（Claude Code 等）：Base URL 填 http://127.0.0.1:8181，API Key 填本地代理密钥，模型填 grok-4.5

任何支持自定义 Base URL 的客户端都能接入。

可用的 Grok 模型

通过 GrokProxy 可以使用 xAI 提供的模型：

模型	说明
grok-4.5	最新旗舰，编程、智能体与知识工作综合能力最强
grok-4-code	编程专用模型，代码生成与理解能力突出

在客户端的 model 字段填入对应名称即可切换。

安全设计

• 默认本地监听：默认绑定 127.0.0.1，也支持局域网地址（监听非回环地址时强制要求本地代理密钥）
• 本地代理密钥：自动生成 16 位密钥，每次请求必须携带
• 数据不离开本机：所有流量仅在你和 xAI 之间，无第三方中转
• 配置本地存储：

系统	路径
Windows	%AppData%\GrokProxy\config.json
macOS	~/Library/Application Support/GrokProxy/config.json

---

项目地址：https://github.com/werbenhu/grok-proxy