使用指南••6 分钟阅读
Claude Haiku 5.5 成为默认 Haiku：1M 上下文，每百万 token 输入 0.10 美元
CLI 2.1.293 加入 Claude Haiku 5.5（claude-haiku-5-5），并把它设为 Anthropic API 上的默认 Haiku 模型：1M 上下文，输入/输出每百万 token 0.10/0.50 美元，超过 100K 的提示按 0.50/2.50 计。说明它适合干什么、怎么切换、怎么算账。
Claude 中文网
Skip to content
Claude Code 教程大全
完整教程列表
涵盖从基础入门到高级技巧的完整学习路径
实用技巧••5 分钟阅读
子代理状态栏能分清是谁了：subagentStatusLine 新增 agentType
CLI 2.1.293 在 subagentStatusLine 的输入数据里加了 agentType 字段，状态栏脚本终于能区分不同的自定义子代理类型。说明它解决了什么、怎么在脚本里读这个字段、按类型显示不同标签的写法和调试方法。
Claude 中文网
实用技巧••5 分钟阅读
用 cat、grep 看文件也会加载嵌套 CLAUDE.md 了：路径规则漏加载修复
CLI 2.1.293 修复了一个容易被忽略的问题：Claude 用 Bash 里的 cat、head、tail、sed -n 或 grep 查看单个文件时，路径限定的规则和子目录里的嵌套 CLAUDE.md 不会被加载。说明这些规则平时怎么生效、以前漏在哪、升级后要注意什么。
Claude 中文网
使用指南••6 分钟阅读
claude plugin install 新增 --marketplace：一条命令加市场并装插件
CLI 2.1.292 给 claude plugin install 加了 --marketplace <source>：市场没添加过会自动添加（走和 marketplace add 相同的策略检查），然后直接从这个市场安装插件。说明以前的两步流程、新写法、团队脚本里怎么用和注意事项。
Claude 中文网
实用技巧••6 分钟阅读
子代理也能指定 effort 了：Agent 工具新增 effort 参数
CLI 2.1.292 给 Agent 工具加了 effort 参数，你可以让 Claude 以指定的努力程度运行子代理：简单的检索跑低档省时省钱，难题交给高档。说明它解决什么问题、怎么在提示里用、和 maxEffortLevel 上限的关系。
Claude 中文网
实用技巧••6 分钟阅读
遇到 529 过载别硬刷：CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS 调长重试间隔
CLI 2.1.292 新增环境变量 CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS，可以给 529（服务过载）请求的退避重试设一个更长的基础延迟。说明 529 是什么、什么时候值得调大、怎么设置，以及同版本的 NO_PROXY 修复。
Claude 中文网
使用指南••7 分钟阅读
WebSearch 不再搜满 200 次就停：改成每小时回填 100 次
CLI 2.1.290 把交互会话里 WebSearch 的额度从「一共 200 次、用完就停」改成按时间回填，默认每小时 100 次，可用 CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR 调整或关掉回填。说明变化、适用场景与配置方法。
Claude 中文网
实用技巧••6 分钟阅读
claude attach / claude logs 支持会话名：不用再复制长长的会话 ID
CLI 2.1.290 起，claude attach 和 claude logs 可以直接写会话名的一部分来代替完整 ID，接入后台会话、查看日志更顺手。说明用法、和 /rename 的配合、名字重复时怎么办，以及同版本里后台会话的几处相关修复。
Claude 中文网
使用指南••8 分钟阅读
网关不认结构化输出：会话标题、记忆召回失败怎么关
CLI 2.1.288 修复在 Mantle 或拒绝 structured outputs 的网关后面，会话标题、记忆召回、prompt hooks 失败的问题，并新增 CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS 一键关闭结构化输出。说明症状、开关用法与排查顺序。
Claude 中文网
最佳实践••8 分钟阅读
Read 拒绝规则不再被 @ 引用绕过：符号链接与变量前缀补洞
CLI 2.1.289 修复多处权限绕过：通过符号链接 @ 引用或在 IDE 里选中的文件不再躲过 Read deny 规则；沙箱自动放行下，带环境变量前缀或变量赋值的 Bash 命令也不再漏掉 deny/ask。说明影响范围与团队自查方法。
Claude 中文网
实用技巧••8 分钟阅读
You should know：旁路代理帮你盯漏掉的坑
CLI 2.1.287 内置可选插件 You should know：旁路代理盯着你和 Claude 可能漏掉的事并提醒。用 /plugin enable cc-plugin-you-should-know@builtin 开启（需第一方会话且遥测开启）。说明适用场景、边界与怎么关。
Claude 中文网
使用指南••8 分钟阅读
危险 rm 加了重定向也不再漏问：always-ask 修好了
CLI 2.1.287 修复：对 / 或家目录一类危险 rm，若同时把输出重定向到 ~ 或通配路径，曾会丢掉 always-ask 强确认。升级后仍会先问人，降低误删风险。说明触发形态、边界与团队该怎么验。
Claude 中文网
使用指南••8 分钟阅读
MCP 弹出登录 URL：协议升级后连不上怎么修
CLI 2.1.287 支持 MCP 2025-11-25 协议的 URL 提示（例如让你打开链接登录）。升级后若某 MCP 再也连不上，可在该服务器配置里加 bareElicitationCapability: true。说明适用场景、配置边界与排查顺序。
Claude 中文网
实用技巧••8 分钟阅读
权限提示显示「2 of 5」：排队请求还剩几条一眼看清
CLI 2.1.286 在权限提示里增加类似「2 of 5」的计数：多条权限请求叠在一起时，能看到当前是第几条、总共还有几条待批。说明适用场景、和 Auto mode 的边界，以及升级后怎么读这条提示。
Claude 中文网
使用指南••8 分钟阅读
日志脱敏加固：密钥名带隐形字符也能挡住
CLI 2.1.286 修复日志与会话转录的密钥脱敏：即使密钥名里夹了零宽空格等不可见字符，也会按密钥打码；并补强 URL 密码、Bearer/Basic、百分号编码 token、/feedback 压缩包等泄漏面。说明影响面与团队该怎么查。
Claude 中文网
实用技巧••8 分钟阅读
claude --desktop：从终端一把打开桌面端会话
CLI 2.1.285 新增 claude --desktop，在当前目录打开 Claude 桌面应用，也可配合 --continue / --resume <id> 续上既有会话，方便 CLI→桌面端切换。说明用法、适用场景与和 Remote Control 的边界。
Claude 中文网
使用指南••8 分钟阅读
allowedProviders：限制本机可用的 API 提供商
CLI 2.1.285 增加托管设置 allowedProviders，可限制某台机器允许使用的 API 提供商（Anthropic API、自定义端点、Bedrock、Mantle、Vertex、Foundry、Claude Platform on AWS、Cloud gateway 等），减少非预期外呼。说明适用场景与配置边界。
Claude 中文网
实用技巧••8 分钟阅读
CLAUDE_CODE_DISABLE_WEB_FETCH：关掉自动网页抓取
CLI 2.1.285 新增环境变量 CLAUDE_CODE_DISABLE_WEB_FETCH，可关闭 WebFetch 工具，避免工具运行期间自动抓取网页。说明适用场景、和团队策略的边界，以及关掉后的替代做法。
Claude 中文网
使用指南••8 分钟阅读
Sonnet 5.5 成默认 Sonnet：1M 上下文和定价怎么读
CLI 2.1.284 起 Anthropic API 上默认 Sonnet 换成 Claude Sonnet 5.5（claude-sonnet-5-5），标称 1M 上下文；定价约 $2/$10 每百万 token，缓存读 $0.20。说明选 Sonnet / 跟默认时会怎样，以及何时仍可留在旧 Sonnet。
Claude 中文网
高级功能••8 分钟阅读
Auto mode 新增「这次行，下次再问」：工作区外读取怎么批
CLI 2.1.284 为 Auto mode 在「读取工作目录外路径」的提示中增加「Yes, but ask again next time」：放行这一次，下次仍询问。对比永久放行；并简述同版本起交互终端与 VS Code 在未配置权限模式时默认进入 Auto mode。
Claude 中文网
实用技巧••8 分钟阅读
/mcp reconnect all：一次重连所有挂掉的 MCP
CLI 2.1.284 在交互终端增加 /mcp reconnect all，对连接失败或需要重新认证的 MCP 服务器一次性重试。说明何时用、和续跑会话里 MCP 工具最多等待 10 秒的修复，以及和作用域配置的边界。
Claude 中文网
使用指南••8 分钟阅读
新模型别自动放行：availableModelsMatch=exact 与 deniedModels
CLI 2.1.283 为托管设置增加 availableModelsMatch=exact 与 deniedModels：白名单只锁到具名版本，新版本默认进不来；即使白名单放过也能单独拉黑。说明团队管控场景与配置要点。
Claude 中文网
实用技巧••8 分钟阅读
CLAUDE.md 过时了吗：/doctor prompt-audit 怎么体检提示词
CLI 2.1.283 增加 /doctor prompt-audit（别名 /checkup prompt-audit），检查 CLAUDE.md、skills、agents、commands 里面向旧模型的写法。说明何时跑、报告里优先看什么，以及和遥测类 doctor 的区别。
Claude 中文网
实用技巧••8 分钟阅读
网关如何串起一轮提示：x-claude-code-prompt-id 怎么开
CLI 2.1.283 可选发送 x-claude-code-prompt-id 网关提示头（CLAUDE_CODE_GATEWAY_HINT_HEADERS=1），让 LLM 网关把服务同一用户提示的多次请求归到一组。说明适用场景、怎么开，以及和网关 400 类问题的边界。
Claude 中文网
实用技巧••8 分钟阅读
宽屏别再一行拖到天边：maxProseWidth 怎么卡散文宽度
CLI 2.1.282 新增 maxProseWidth，宽终端里限制 Claude 散文行宽，表格与代码块仍占满屏宽。说明适用场景、和全屏模式的关系，以及怎么验证生效。
Claude 中文网
实用技巧••9 分钟阅读
遥测为什么没亮：/status 与 claude doctor 会点名被忽略的变量
CLI 2.1.282 在启动提示、/status 与 claude doctor 中列出项目 settings 里被忽略或关掉遥测的变量；并说明项目/本地 settings 不再开导出类 OpenTelemetry。排查「以为开了其实没开」。
Claude 中文网
安装指南••9 分钟阅读
历史里的网搜解密失败：2.1.282 修好整会话 400
CLI 2.1.282 修复对话历史中无法解密的 web search 结果导致每轮请求 400；常见于第三方网关答过的回合。说明症状、升级策略，以及续跑/thinking 相关的同批修复。
Claude 中文网
高级功能••8 分钟阅读
Hooks 里别再冒「Response」：2.1.281 清引导，PermissionRequest 也收紧
CLI 2.1.281 去掉 hooks 引导里多余的 Response 字样；2.1.280 起 PermissionRequest 不再跑 agent 型钩子，并给 hook_execution_complete 补上输出体积。写 hooks 时该跟哪条。
Claude 中文网
实用技巧••9 分钟阅读
多目录装插件：CLAUDE_CODE_PLUGIN_DIRS 和 edit-skill-overrides
CLI 2.1.280 增加 CLAUDE_CODE_PLUGIN_DIRS，可额外指定插件目录；并露出 edit-skill-overrides、edit-chrome-settings、edit-sandbox-settings。另述 skills 误进 .trash、仿冒 marketplace 名被拒等踩坑。
Claude 中文网
实用技巧••8 分钟阅读
MCP 描述太长被砍：用环境变量抬上限
CLI 2.1.280 增加 CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH，可调整会话内每个 MCP 服务器工具描述与 server instructions 的默认 2048 字符上限。说明何时该抬、何时该精简，以及和 MCP 启动等待的分工。
Claude 中文网
高级功能••9 分钟阅读
Auto mode 别再死磕：拒绝一次就停，静默则退避
CLI 2.1.280 修复 Auto mode 在安全审查拒绝或无答复时的重试死循环：明确拒绝则只否决一次并提示重试无用；无答复则退避，连续十次后结束本轮。另述符号链接写入按落盘路径判定的权限修复。
Claude 中文网
安装指南••8 分钟阅读
代理翻车：`ANTHROPIC_BASE_URL` 触发 advisor 标签 400 怎么修
CLI 2.1.275 回归导致走代理或网关时请求带上 advisor_20260301 输入标签并整批 400；2.1.276 已修复。对照兼容端点配置、升级步骤与仍失败时的排查顺序。
Claude 中文网
实用技巧••9 分钟阅读
远程会话叉回本地后台，MCP 断线也不再闷声
CLI 2.1.273：Remote Control 会话可 fork 成保留状态的本地后台会话并腾出界面；MCP 中途断开且重连失败会通知，可用 /mcp 做诊断。另述网关可观测请求头的可选开启。
Claude 中文网
最佳实践••8 分钟阅读
给努力程度封顶：maxEffortLevel 怎么卡住成本
CLI 2.1.267 起可用 maxEffortLevel（全局或按模型）限制 effort，覆盖 Bedrock、Vertex、Foundry；用户仍可往下调。顺带说明 --system-prompt-snapshot off 的取舍。
Claude 中文网
最佳实践••8 分钟阅读
没有 CLAUDE.md 也能开工：AGENTS.md 怎么当项目说明
CLI 2.1.277 起，仓库没有 CLAUDE.md 时会改读 AGENTS.md 作项目说明；可在 /config 的 Project instructions 切换。对照 CLAUDE.md、README 与 Hooks 的分工，以及 -p / SDK 挂起改报错退出。
Claude 中文网
高级功能••8 分钟阅读
Auto mode 分类器上云了：看 /status，别再付多余开销
CLI 2.1.278 起 Auto mode 默认走服务端分类器，避免分类器开销计费；/status 新增 Auto mode server 行可确认本会话是否上云。deny、ask 与 environment 规则仍然先生效。
Claude 中文网
高级功能••10 分钟阅读
Claude Code 里做设计稿、幻灯片和文档
在 Claude Code 里直接做设计评审稿、UI 线框和文档幻灯片：对着仓库 RFC 与真实文件出稿、对话里改、就绪后分享链接。覆盖 /design、/design-sync 与 Design MCP，聚焦开发闭环。
Claude 中文网
高级功能••10 分钟阅读
Claude Mods：用 Function Hooks 扩展界面
Claude Mods 用 TypeScript function hooks 在进程内改界面与工具行为，不同于 hooks.json 的 shell 钩子。介绍早期预览、能力边界、信任原则，并对照 Skills / MCP / 插件。
Claude 中文网
实用技巧••8 分钟阅读
限额紧了就开 Concise：少废话不减实质
周限额紧时切内置 Concise：先给结果、少铺垫，错误与安全警告仍完整。说明切换时机、何时别用，以及自定义 style 的 keep-coding-instructions 陷阱。
Claude 中文网
使用指南••9 分钟阅读
Claude Code 接下兼容模型：壳还在，账单变了
Claude Code 是 harness：工具与权限留本地，推理可走兼容端点。订阅登录不等于接别人的模型。便宜 token 有质量与上下文代价；限额撞墙时再评估，硬重构仍建议官方模型。
Claude 中文网
高级功能••9 分钟阅读
用 `claude plugin eval` 测插件到底有没有用
"装完插件别只靠手感。用 `claude plugin eval` 写真实提示词用例并打分，再关掉插件重跑看差值。init 会起草检查项并估全量费用；评测会调模型，先 --runs 1。"
Claude 中文网
安装指南••10 分钟阅读
Claude Code 安装失败对照表
Claude Code 安装失败对照：PATH、脚本 HTML/syntax error、403、OAuth、代理与 CA、API Key 覆盖订阅、WSL2 粘贴，附 claude doctor。
Claude 中文网
实用技巧••8 分钟阅读
换口吻别塞 CLAUDE.md：Output styles 怎么用
Output styles 只改怎么说，不改项目知识。内置 Default/Proactive/Concise/Explanatory/Learning；用 /config 切换，写入 settings.local.json。
Claude 中文网
实用技巧••8 分钟阅读
底部状态栏自己画：`statusLine` 看上下文和花费
"用 shell 读 stdin JSON 自定义底部栏：模型、上下文占用、花费、限流、git。本地跑、不耗 API；可用 /statusline 自然语言配置。"
Claude 中文网
高级功能••9 分钟阅读
插件怎么装、怎么自己做：marketplace 和 plugin.json
插件打包 skills/agents/hooks，用 /plugin install name@marketplace 安装。结构要点：只有 plugin.json 放在 .claude-plugin/，其余在根下。
Claude 中文网
工作流程••8 分钟阅读
先别改代码：Plan mode 怎么进、怎么批、怎么回来
Plan mode 只读探查、写方案、等你批准后再改代码。用 Shift+Tab 或 /plan 进入；批过才落地；方案跑偏了再切回计划模式重来。
Claude 中文网
最佳实践••8 分钟阅读
CLAUDE.md 你写，MEMORY.md 它记：自动记忆怎么用
CLAUDE.md 是你手写的项目说明；自动记忆由 Claude 跨会话记笔记到 MEMORY.md。索引只读前 200 行或 25KB，别把铁律和备忘混谈。
Claude 中文网
使用指南••9 分钟阅读
脚本和 CI 里跑 Claude：`-p`、`--bare` 和权限
"`claude -p` 非交互可脚本化，但默认仍会加载项目与用户配置。CI 用 `--bare` 加 API Key，再用旗标显式传入上下文。"
Claude 中文网
最佳实践••8 分钟阅读
权限怎么配：allow、ask、deny，再加一层沙箱
规则顺序是 deny → ask → allow。敏感路径用 Read deny；OS 级隔离靠沙箱。bypassPermissions 只适合可丢弃环境。
Claude 中文网
高级功能••9 分钟阅读
Auto mode 不是关掉确认：环境、`$defaults` 和人机卡点
Auto mode 会把工具调用交给分类器，但 deny 和 ask 仍先生效。信任边界写进 autoMode.environment，别忘了 `$defaults`。
Claude 中文网
使用指南••8 分钟阅读
MCP 作用域：local / project / user 怎么批
MCP 的 local / project / user 三个作用域整表生效、字段不合并；项目服务器需人工批准，仓库内批准在未信任目录不生效。
Claude 中文网
高级功能••9 分钟阅读
Agent Teams：什么时候该拉队伍，什么时候用子代理就够
Agent Teams 适用场景：队友能互相发消息并抢共享任务；子代理只会向主会话交摘要。先确认实验开关与版本，再谈并行评审和调试，避免盲目上并行。
Claude 中文网
最佳实践••8 分钟阅读
CLAUDE.md 管倾向，Hooks 才是铁律
CLAUDE.md 每次会话都会读，但它只是上下文提示，不是强制开关。说不清的规矩写进文件；一次都不能破的关键动作用 Hooks 拦截，两者互补。
Claude 中文网
最佳实践••7 分钟阅读
CLAUDE.md 别写成第二份 README
README 给人看，可以写长写背景；CLAUDE.md 给代理看，每次会话都注入，只留短事实和命令。两个文件职责不同，请不要互相复制，分工写更清楚。
Claude 中文网
使用指南••8 分钟阅读
离开电脑也能接着写：Remote Control、Cloud、Dispatch 怎么选
人离开工位时，Claude Code 有三种接着干的方式。这篇只讲 Remote Control、Cloud 和 Dispatch 的差别、适用场景，以及国内订阅和代理通道上容易踩的限制。
Claude 中文网
高级功能••12 分钟阅读
Claude Code 2026：并行会话与 Auto mode
对照 Anthropic 官方文档和 2026 年已发布的 Claude Code 博文，梳理桌面并行、动态工作流、Artifacts、Auto mode 与上下文写法上真正变了的地方，以及普通开发者现在该怎么用。
Claude 中文网
最佳实践••9 分钟阅读
CLAUDE.md 文件推荐约束提示词
可直接改的 CLAUDE.md 约束模板：沟通风格、架构边界、运行调试与常见技术栈规则示例，帮你把项目约定稳定写进每次会话上下文，拿来即改。
Claude 中文网
安装指南••10 分钟阅读
Windows 安装 Claude Code 的新姿势，保姆级教程
Windows 安装 Claude Code：Node 与终端选择、官方脚本步骤、常见报错排查，以及环境变量配置方法，适合新手按步骤一次装好。
Claude 中文网
安装指南••8 分钟阅读
Claude Code 在Windows中设置环境变量有几种方法：
Windows 下为 Claude Code 配置环境变量：CMD、PowerShell 与系统持久化写法对照，避免新开终端丢失配置或出现 command not found。
Claude 中文网
安装指南••3 分钟阅读
Claude Code 卸载与彻底清理指南
如何彻底卸载 Claude Code：清理 npm 全局或本地包、残留目录与配置文件，并检查 PATH，避免旧命令或错误路径干扰后续重新安装。
Claude 中文网