check-toolsearch
检查 ToolSearch(WebSearch)是否可用
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/doccker/cc-use-exp/HEAD/.claude/commands/check-toolsearch.md -o ~/.claude/commands/check-toolsearch.mdcheck-toolsearch.md
验证当前 Claude Code 环境是否支持 ToolSearch 工具。
## 执行步骤
### 1. 尝试调用 WebSearch
使用 WebSearch 工具搜索关键词 `Claude Code CLI`。
### 2. 获取本机版本
使用 Bash 执行 `claude --version` 获取用户当前安装的 Claude Code 版本号。
### 3. 判断结果
**如果搜索成功返回结果**:
```
✅ ToolSearch 可用
搜索功能正常,你的 Claude Code 已支持 WebSearch/ToolSearch。
好处:
- 大幅减少 token 占用(工具定义不再内嵌上下文)
- 模型表现更好(上下文更干净,注意力不被稀释)
- 对话轮次更多(同样的上下文窗口可以增加数轮对话)
当前 Claude Code 版本为 {claude --version 的输出}。
```
**如果搜索失败或报错**:
```
❌ ToolSearch 不可用
可能原因:
1. 使用第三方中转地址,域名未通过白名单检查
2. Claude Code 版本不支持
解决方案:
python tools/patch-toolsearch.py 或者
python3 tools/patch-toolsearch.py
脚本会自动检测安装位置并解除域名限制,执行后重启 claude 即可。
```当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。
网关/代理/WAF/CDN 中间件的安全关键词匹配实现规范,防止纯子串匹配误判正常响应内容中的技术术语(如 Cloudflare、502、error)
当 API/任务可能执行超过 10 秒(批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合)时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。
当用户操作 .sh、Dockerfile、Makefile、.yml、.yaml 文件,或在 Markdown 中编写 bash 代码块时触发。提供 Bash 编写规范。
前后端接口契约安全规范,适用于接口新增或调整、联调、列表分页异常与临时兼容治理;用于避免响应结构漂移被前端兼容长期掩盖。
当设计或修改 REST API 响应结构、处理 API 返回值,或生成 Excel/CSV/PDF/对账文件等下游产物时触发。防止 API 设计缺陷导致的字段错位、类型歧义,以及生成产物时关键字段缺失但静默成功的问题。
网关/代理/WAF/CDN 中间件响应判定与关键词匹配安全规范。适用于 proxy/gateway/waf/cdn/nginx/openresty/rewrite/redirect 等代码,防止把正常长正文中的 Cloudflare、502、bad gateway、error 等技术术语误判为上游错误。
当 API/任务可能执行超过 10 秒(批量数据处理、远程 API 批量调用、全表扫描、跨租户聚合)时触发。防止同步接口被网关 30s 超时切断、用户重复点击触发并发、状态缓存内存泄漏等问题。提供异步任务状态机标准模板。