完整安装指南
支持 Windows、macOS、Linux，官方脚本与配置步骤一次讲清
Claude Code 中文教程 安装、技巧与国内使用指南
教程文章、实用技巧与国内访问方案
Skip to content
最新文章
实用技巧
大请求自动 gzip：CLAUDE_CODE_GZIP_REQUEST_BODIES
•4 分钟阅读
CLI 2.1.300 起，发往 api.anthropic.com 的大体积请求会默认用 gzip 压缩，即使关掉了遥测也一样。说明这项改动解决什么痛点、和遥测的关系、怎么用 CLAUDE_CODE_GZIP_REQUEST_BODIES=0 关闭，以及什么时候可能需要关。
阅读全文 →实用技巧
MCP 工具 schema 被拒后，别再每轮 400：Claude Code 会跳过参数继续聊
•5 分钟阅读
CLI 2.1.300 修复了一个烦人问题：某个 MCP 工具的 input schema 被 API 拒绝后，整段对话每一轮都 400。现在 Claude Code 会在本会话剩余时间里去掉该工具的参数再发送，避免对话卡死。说明以前怎么坏、现在怎么绕、你还需要修 MCP 本身。
阅读全文 →高级功能
OTel 分清 5 分钟和 1 小时缓存写入：cache_creation_5m / 1h_tokens
•5 分钟阅读
CLI 2.1.300 在 OpenTelemetry 的 api_request 事件里新增 cache_creation_5m_tokens 与 cache_creation_1h_tokens，把提示缓存的写入量按 5 分钟 / 1 小时 TTL 拆开。说明这两个字段看什么、和 idle compaction、计费报表怎么一起用。
阅读全文 →实用技巧
离开一小时回来不再重算：Claude Code 的空闲压缩（idle compaction）
•5 分钟阅读
CLI 2.1.299 在终端里加入空闲压缩：上下文超过 200K token 的对话闲置约 54 分钟后，会赶在一小时提示缓存过期前自动压缩，回来发下一条消息时不用把整段历史重新处理一遍。说明触发条件、怎么调阈值、怎么关闭，以及什么时候该关。
阅读全文 →实用技巧
@ 文件只给路径不塞内容：CLAUDE_CODE_DISABLE_FILE_MENTIONS
•4 分钟阅读
CLI 2.1.299 新增 CLAUDE_CODE_DISABLE_FILE_MENTIONS：设为 1 后，@ 提到的文件和目录不再被展开塞进上下文，Claude 只拿到路径，再按需用文件工具去读。说明默认的 @ 行为、新变量适合哪些场景、怎么设置、为什么项目设置里写了不生效。
阅读全文 →高级功能
Hooks 改参数要守规矩：updatedInput 现在会被校验
•5 分钟阅读
CLI 2.1.300 起，PreToolUse 和 PermissionRequest 钩子返回的 updatedInput 会像 Claude 自己的工具输入一样被校验：多余的字段被丢弃，工具不接受的输入会直接拒绝这次调用。说明以前的隐患、现在的行为、钩子作者需要自查的几个点和写法示例。
阅读全文 →