/install claudecode-websearch
Claude WebSearch Skill
Use the bundled script to search the web via Claude Code CLI (primary) or Codex CLI (fallback). Both CLIs expose a native WebSearch tool — no third-party search API key needed.
When to Use
- Tavily / Brave / Exa quota is exhausted
- User says "websearch搜一下X", "search for X", "查一下X"
- Any web search need where no API key is configured
Quick Usage
# Primary (Claude Code CLI — fast, recommended)
scripts/websearch.sh "your query"
# With result count
scripts/websearch.sh "your query" --max 3
# Explicit backend
scripts/websearch.sh "your query" --backend codex
Or use the global alias (if installed):
ccws "your query"
How It Works
| Backend | CLI flag | Notes |
|---|---|---|
claude (default) |
--allowedTools "WebSearch" |
Fast (~5s), clean output |
codex |
--search + reasoning_effort=low |
Slower (~30-60s), use as fallback |
The script auto-detects which CLI is available; claude is preferred when both exist.
Setup (one-time)
Install the global alias ccws for quick access:
ln -sf "$(pwd)/scripts/websearch.sh" ~/.local/bin/ccws
Troubleshooting
| Problem | Fix |
|---|---|
claude: command not found |
Install Claude Code CLI: npm install -g @anthropic-ai/claude-code |
codex: command not found |
Install Codex CLI: npm install -g @openai/codex |
| Claude returns empty output | Check claude auth status; re-login if expired |
| Codex times out | Normal — use --backend claude instead |
Not inside a trusted directory (Codex) |
Script handles this by running from a temp dir |
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install claudecode-websearch - 安装完成后,直接呼叫该 Skill 的名称或使用
/claudecode-websearch触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Claude Code WebSearch 是什么?
Free web search using Claude Code CLI or Codex CLI's built-in WebSearch tool — no Tavily, Brave, or Exa API key required. Activate when the user says "websea... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 253 次。
如何安装 Claude Code WebSearch?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install claudecode-websearch」即可一键安装,无需额外配置。
Claude Code WebSearch 是免费的吗?
是的,Claude Code WebSearch 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Claude Code WebSearch 支持哪些平台?
Claude Code WebSearch 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Claude Code WebSearch?
由 jinghan23(@jinghan23)开发并维护,当前版本 v1.0.0。