Skip to content

进阶配置与效率优化

如何减少 Token 消耗与非必要流量?

~/.claude/settings.json 中合并写入以下配置:

json
{
  "ENABLE_TOOL_SEARCH": true,
  "skipWebFetchPreflight": true,
  "env": {
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
  • ENABLE_TOOL_SEARCH:减少工具调用搜索的 Token 泄漏
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:关闭遥测和更新检查等非必要请求
  • skipWebFetchPreflight:跳过 WebFetch 预检查(国内网络必加)

如何使用 CLAUDE.md 提升效率?

在项目根目录创建 CLAUDE.md 文件,写入项目技术栈、目录结构和开发规范,Claude Code 启动时自动加载作为上下文:

markdown
# 项目名称

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

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

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

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

MCP 扩展有哪些推荐?

  • context7:技术文档实时查询
  • deepwiki:知识库访问
  • playwright:浏览器自动化
  • exa:智能搜索

Hooks 钩子怎么用?

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

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

自定义命令怎么创建?

~/.claude/commands/.claude/commands/ 下创建 .md 文件。例如创建 ~/.claude/commands/review.md,之后在对话中输入 /review 即可触发。

常用命令速查

  • /model:切换模型(opus / sonnet / haiku)
  • /model sonnet[1m]:切换 1M 超长上下文版本
  • /cost:查看当前令牌用量
  • /compact:压缩上下文,释放空间
  • /resume:恢复历史对话
  • /clear:清空当前对话
  • /help:查看所有命令
  • /exit 或连按两次 Ctrl + C:退出

排障前建议先检查什么?(通用排障清单)

  1. 确认令牌分组、Base URL、User-Agent 三项是否匹配(参考外接与兼容类问题的「外接前需要确认哪 5 项」)
  2. 检查系统环境变量是否残留旧配置(Win + Rsysdm.cpl,或查看 ~/.zshrc
  3. 检查 ~/.claude.json 是否有 OAuth 令牌残留(claude auth logout 清除)
  4. 用 CC Switch 重新写入一次配置,关闭终端窗口重新打开后再试
  5. 如涉及外接场景,确认 5 项检查清单(分组、协议、Base URL、请求头、模型)