完整安装指南
支持 Windows、macOS、Linux，官方脚本与配置步骤一次讲清
Claude Code 中文教程 安装、技巧与国内使用指南
教程文章、实用技巧与国内访问方案
Skip to content
最新文章
实用技巧
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 上的命令钩子结束时会记录命令、插件、结果和耗时。说明怎么打开调试日志、怎么读这些行，以及子代理被跳过的常见原因。
阅读全文 →实用技巧
终端标签也能看状态：Claude Code 支持 OSC 7501
•5 分钟阅读
CLI 2.1.295 加入 Program Status Protocol（OSC 7501）支持：实现了该协议的终端可以直接显示 Claude Code 正在工作、在等你，还是已经完成。说明 OSC 是什么、你能看到什么变化、需要什么终端，以及它和自定义状态栏的区别。
阅读全文 →实用技巧
统一 workflow 子代理模型：CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL
•6 分钟阅读
CLI 2.1.296 新增环境变量 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL：让每个 workflow agent 都跑在同一个模型上，而其他子代理继续用各自配置的模型。说明它解决什么问题、怎么设置，以及和普通子代理模型、Agent effort 的边界。
阅读全文 →使用指南
Sonnet 5.5 缓存读取按 $0.10 计：/cost 和预算数字变了
•5 分钟阅读
CLI 2.1.296 更新了 /cost、状态行、--max-budget-usd 与 SDK 的费用数字：Sonnet 5.5 的 cache reads 按每百万 token $0.10 计（此前按 $0.20）。说明这次调整是什么、对大量命中 prompt cache 的长会话意味着什么，以及和 Haiku 5.5 定价的区别。
阅读全文 →