完整安装指南
支持 Windows、macOS、Linux，官方脚本与配置步骤一次讲清
Claude Code 中文教程 安装、技巧与国内使用指南
教程文章、实用技巧与国内访问方案
Skip to content
最新文章
实用技巧
离开一小时回来不再重算：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 自己的工具输入一样被校验：多余的字段被丢弃，工具不接受的输入会直接拒绝这次调用。说明以前的隐患、现在的行为、钩子作者需要自查的几个点和写法示例。
阅读全文 →实用技巧
GBK 文件不再被改花：Claude Code 拒绝编辑非 UTF-8 文件
•5 分钟阅读
CLI 2.1.296 修复了 Edit 和 NotebookEdit 在非 UTF-8 文件（Windows-1252、Shift-JIS、GBK）里把所有非 ASCII 字符一并替换掉的问题，这类编辑现在会被直接拒绝。说明以前会出什么事、现在的行为、老项目该怎么转码，以及相关的编码修复。
阅读全文 →高级功能
无人值守别无限等：CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS 给 429/529 等待封顶
•5 分钟阅读
CLI 2.1.295 新增 CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS，给无人值守重试模式（CLAUDE_CODE_RETRY_WATCHDOG）等待 429、529 的时间设上限。说明 watchdog 原本怎么等、新变量怎么算、适合哪些 CI 场景，以及和 529 退避延迟变量的区别。
阅读全文 →实用技巧
--debug 更会说话了：子代理 frontmatter 拼错、慢钩子一眼看出
•6 分钟阅读
CLI 2.1.296 改进了 --debug 输出：自定义子代理文件里不认识的 frontmatter 字段会被点名并提示可能的拼写错误；工具调用、提示提交、SessionStart、Stop 上的命令钩子结束时会记录命令、插件、结果和耗时。说明怎么打开调试日志、怎么读这些行，以及子代理被跳过的常见原因。
阅读全文 →