进阶配置与效率优化
如何减少 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:退出
排障前建议先检查什么?(通用排障清单)
- 确认令牌分组、Base URL、User-Agent 三项是否匹配(参考外接与兼容类问题的「外接前需要确认哪 5 项」)
- 检查系统环境变量是否残留旧配置(
Win + R→sysdm.cpl,或查看~/.zshrc) - 检查
~/.claude.json是否有 OAuth 令牌残留(claude auth logout清除) - 用 CC Switch 重新写入一次配置,关闭终端窗口重新打开后再试
- 如涉及外接场景,确认 5 项检查清单(分组、协议、Base URL、请求头、模型)