Claude Code 进阶配置

---

快速初始化：npx zcf

项目地址：https://github.com/UfoMiao/zcf

一键完成 Claude Code 常用初始化，包括 MCP 服务器配置与提示词模板设置：

npx zcf

推荐选项：

1. 安装类型 — 选"完整安装"
2. API 配置 — 选"自行配置"（配合 CC Switch 使用）
3. MCP 服务器 — 推荐 context7（文档查询）和 deepwiki（知识库）
4. 关闭并重启终端

---

CLAUDE.md 项目上下文

在项目根目录创建 CLAUDE.md，Claude Code 启动时自动加载作为上下文：

# 项目名称

## 技术栈
- 前端：React + TypeScript
- 后端：Node.js + Express

## 项目结构
- src/ — 源代码
- tests/ — 测试文件

## 开发规范
- 使用 ESLint + Prettier
- 提交信息遵循 Conventional Commits

提供准确的项目上下文可以显著减少 Token 消耗，避免 Claude Code 反复询问项目结构。

---

MCP 扩展

Claude Code 通过 MCP（Model Context Protocol）扩展额外能力：

MCP	用途
context7	技术文档实时查询
deepwiki	知识库访问
playwright	浏览器自动化
exa	智能搜索
grok-search-mcp	通过 Grok 执行联网搜索

使用 npx zcf 可统一完成常用 MCP 配置与基础模板初始化。

如需单独接入 Grok 搜索，可参考 Grok Search MCP 配置。

---

Hooks 钩子

在 ~/.claude/hooks/ 或项目 .claude/hooks/ 下创建钩子脚本：

事件	触发时机
before-tool-use	工具调用前
after-tool-use	工具调用后
user-prompt-submit	用户提交消息时

---

自定义命令

在 ~/.claude/commands/ 或 .claude/commands/ 下创建 .md 文件，即可通过 /命令名 调用。

示例：创建 ~/.claude/commands/review.md，之后在对话中输入 /review 即可触发。

---

流量与 Token 优化

以下三项配置均写入 ~/.claude/settings.json，按需选用。

减少工具调用搜索的 Token 泄漏

Claude Code 在工具调用时会触发内部搜索，开启此选项可减少该行为产生的额外 Token 消耗：

{
  "ENABLE_TOOL_SEARCH": true
}

禁用非必要流量

Claude Code 在运行时会发出一些遥测、更新检查等非必要请求。如需完全关闭这些流量：

{
  "env": {
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

跳过 WebFetch 预检查

Claude Code 的 WebFetch 工具在抓取目标页面前，会先向 https://claude.ai/api/web/domain_info?domain= 发起安全预检请求。如果你的网络环境下 claude.ai 被拦截（即使目标网站本身可以访问），预检就会失败，导致 WebFetch 整体报错。

开启此选项跳过预检：

{
  "skipWebFetchPreflight": true
}

适用场景：开了全局代理但代理未正确处理 claude.ai 请求时，或企业防火墙屏蔽了 claude.ai 域名时。

完整示例（三项合并）：

{
  "ENABLE_TOOL_SEARCH": true,
  "skipWebFetchPreflight": true,
  "env": {
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}