通过 Grok 端点给 Codex 或 Claude 接上实时联网搜索

你代理的答案只会和它的训练截止日期一样新——问当前版本号或某个库的现状，它就靠猜。181 星的 grok-skill 把实时查询接进了 Codex 或 Claude：调用你自己运营的 OpenAI 兼容 Grok 端点，返回带来源的答案。

为什么这个 Skill 重要

这个仓库的自我定位是「一个 Codex/Claude 技能插件，通过你的 OpenAI 兼容 Grok 接口（2api）实现激进的联网检索」。它点名的适用场景是实时信息查询、版本检查和文档查找——恰恰是过时模型会悄悄编造答案的问题。

两个设计选择撑起了它的价值。输出是结构化 JSON，带 content 字段加 sources 列表，你的代理可以引用来源而不是凭记忆转述。配置则做了分层——交互式脚本、配置文件或环境变量——外加一个 gitignore 的 config.local.json 覆盖机制，让 API key 永远不会落进仓库。

安装

README 记载的是 Windows PowerShell 安装器。克隆并运行：

git clone https://github.com/Frankieli123/grok-skill.git
cd grok-skill
powershell -ExecutionPolicy Bypass -File .\install.ps1

手动替代方案是从 GitHub 下载 ZIP，然后在 PowerShell 中运行 install.ps1。两种方式都会把技能装到 C:\Users\<你的用户名>\.codex\skills\grok-search\。README 只记载了这条 PowerShell 路径——项目结构是一个 SKILL.md、一份配置模板、两个 PowerShell 脚本加 scripts/grok_search.py，构件都是普通文件，但没有记载面向其他操作系统的安装器。

配置

README 记载了三种方式，并把交互式那种标注为推荐。先是交互式：

powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.codex\skills\grok-search\configure.ps1"

或者直接编辑 config.json：

{
  "base_url": "https://your-grok-endpoint.example",
  "api_key": "YOUR_API_KEY",
  "model": "grok-2-latest",
  "timeout_seconds": 60,
  "extra_body": {},
  "extra_headers": {}
}

字段含义一目了然：base_url 是你的端点，model 指定模型（示例 grok-2-latest），timeout_seconds 限制请求时长，extra_body 和 extra_headers 透传附加参数。也可以设置 GROK_BASE_URL、GROK_API_KEY 和 GROK_MODEL 环境变量。出于安全考虑，把真实 key 放进同目录下的 config.local.json——它已被 gitignore。

实战流程：从命令行查询

搜索脚本可以直接调用：

python scripts/grok_search.py --query "What is the latest version of Node.js?"

答案以 JSON 返回：

{
  "content": "The synthesized answer...",
  "sources": [
    {"url": "https://example.com", "title": "Source Title"}
  ]
}

实战流程：让你的代理先搜索再回答

README 给出了粘进全局代理配置（C:\Users\<你的用户名>\.codex\AGENTS.md 或 ~/.claude/CLAUDE.md）的提示词规则，让技能在代理回答之前触发。文档记载的触发清单覆盖七种情况：版本号、发布日期或更新日志；API 文档或 SDK 用法；错误信息或故障排除；任何项目、服务或技术的当前状态；任何可能过时或时效性强的信息；包安装命令或依赖项；官方文档链接。规则最后要求代理在回答中引用结果里的来源。

使用技巧

• 让 API key 彻底远离 Git——config.local.json 就是为此而生的，README 也把 key 标注为「DO NOT commit to Git」。
• 端点由你自己运营：base_url 指向你的 OpenAI 兼容 Grok 端点，可用性和速率限制都取决于你配置的端点。
• README 在同一个文件里同时提供英文和中文版——混合语言团队拿它当参考很方便。

什么时候不该用它

这个 skill 的前提是你在运营一个 OpenAI 兼容的 Grok 端点（README 的语境是 2api 方案）——没有端点，base_url 就无处可指。文档记载的安装器是 Windows PowerShell，其他操作系统没有脚本化安装。而如果你的运行时对某类查询已经有可信的搜索路径，再把查询绕道外部端点，只是在问题和答案之间多加一环依赖。

查看排行榜了解更多 skill。