Free Claude Code 内置 5 种请求优化：配额探测拦截、命令前缀检测、标题生成跳过、建议模式跳过、文件路径提取。这些优化识别 Claude Code 发出的"探测类"请求，直接本地响应，不转发到上游 Provider，从而节省 Token 和延迟。

Free Claude Code 请求优化机制：省 Token、降延迟的 5 个快路径

问题背景

Claude Code 在运行过程中会频繁发送一些"探测类"请求：配额检查、命令前缀识别、会话标题生成等。这些请求不需要真正的模型推理，但每次都会消耗 API 调用和等待时间。

Free Claude Code 通过分析这些请求的特征（消息内容、系统提示词模式），在代理层直接拦截并返回预设响应，避免不必要的上游调用。

五种优化详解

1. 配额探测拦截（Quota Mock）

触发条件：Claude Code 发送配额/使用量检查请求。

处理：直接返回 "Quota check passed."。

设计意图：Free Claude Code 使用的是用户自己的 Provider，配额由 Provider 管控。Claude Code 对 Anthropic 官方的配额检查没有意义，直接放行。

2. 命令前缀检测（Prefix Detection）

触发条件：Claude Code 请求识别用户输入的命令前缀（如 /help 的 /h）。

处理：用简单的字符串匹配提取命令前缀，不调用模型。

设计意图：命令前缀是确定性的字符串操作，不需要模型推理。本地处理既快又省 Token。

3. 标题生成跳过（Title Skip）

触发条件：Claude Code 请求为会话生成标题。

处理：直接返回 "Conversation"。

设计意图：会话标题对功能没有影响，每次都用模型生成是浪费。返回一个通用标题即可。

4. 建议模式跳过（Suggestion Skip）

触发条件：Claude Code 请求生成建议或推荐。

处理：返回空字符串。

设计意图：建议功能在代理模式下不是核心需求，跳过可以省一次 API 调用。

5. 文件路径提取（Filepath Mock）

触发条件：Claude Code 从命令输出中提取文件路径。

处理：用正则表达式从命令和输出文本中提取文件路径，不调用模型。

设计意图：文件路径提取是模式匹配任务，正则比模型更快更准。

配置开关

每种优化都可以独立开关：

FAST_PREFIX_DETECTION=true
ENABLE_NETWORK_PROBE_MOCK=true
ENABLE_TITLE_GENERATION_SKIP=true
ENABLE_SUGGESTION_MODE_SKIP=true
ENABLE_FILEPATH_EXTRACTION_MOCK=true

默认全部开启。如果发现某项优化导致 Claude Code 行为异常，可以单独关闭排查。

执行顺序

优化按"最便宜到最贵"的顺序执行，命中即短路返回：

1. try_quota_mock — 最简单，字符串匹配
2. try_prefix_detection — 字符串截取
3. try_title_skip — 固定返回
4. try_suggestion_skip — 固定返回
5. try_filepath_mock — 正则匹配

如果都不命中，请求正常转发到上游 Provider。

设计原则

不是所有的请求都值得拦截。这 5 种优化的选择标准是：

• 请求模式明确、可检测（不会误判）
• 响应可以是固定值或简单计算（不需要模型）
• Claude Code 对这些响应的容错性高（不影响核心功能）

如果你发现某个优化导致了意料之外的行为，最安全的做法是关闭对应开关，然后在 GitHub Issues 中反馈。

FAQ

Q: 关闭所有优化会有什么影响？ A: 所有请求都会转发到上游 Provider，功能完全正常，只是会多消耗一些 Token 和延迟。

Q: 这些优化会影响 Claude Code 的代码生成质量吗？ A: 不会。优化只影响探测类请求（配额检查、标题生成等），不影响实际的代码生成、工具调用和对话。

Q: 如何知道某个请求被优化拦截了？ A: 代理日志中会有 Optimization: 前缀的日志。如 Optimization: Skipped title generation request。