通俗版 Claude Code 文档

结构照原 docs，内容改成真能照着做的人话版。
查看原始文档 目录顺序与官方保持一致

Usage and costs

成本

费用从哪来，怎么估、怎么控。

页面信息

对应原页

Manage costs effectively

页面性质

第三方中文解释页

使用建议

先看人话解释，再对照原页命令和代码

这页不是官方原文，而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留，解释部分则尽量讲成人能照着做的话。

如果你碰到特别敏感的配置、权限或企业环境差异，最好顺手点上面的“查看原始文档”再核一遍。

这一页先讲明白

这页讲钱从哪花、怎么估、怎么控。

越早把账算清，越不容易后面被账单追着跑。

Claude Code 干活不是白来的，尤其团队一起用时，成本会很快显出来。

这页就像算农忙请工的账，要知道哪种活最费、哪种配置最烧钱。

不怕花钱，怕的是不知道钱花到哪去了。

先盯住大头：模型选择、使用频率、自动化任务。

成本异常时，不要只怪工具，先看是不是流程设计太重。

监控和成本要配着看，单看一头容易判断失真。

关键片段

原页关键片段：Using the /usage command

下面这块是这一段最值钱的原文样板，先对着看一眼。

Total cost:            $0.55
Total duration (API):  6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes:    0 lines added, 0 lines removed
关键片段

原页关键片段：Manage context proactively

这一段要真抓重点，通常就抓下面这块原文。

# Compact instructions

When you are using compact, please focus on test output and code changes
改配置

原页关键片段：Offload processing to hooks and skills 1

这会儿轮到改配置了，字段名和关键字别自己乱换。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/filter-test-output.sh"
          }
        ]
      }
    ]
  }
}
终端里敲

原页关键片段：Offload processing to hooks and skills 2

先别急着往下翻，下面这条命令跑完，心里才有底。

#!/bin/bash
input=$(cat)
cmd=$(echo "$input" | jq -r '.tool_input.command')

# If running tests, filter to show only failures
if [[ "$cmd" =~ ^(npm test|pytest|go test) ]]; then
  filtered_cmd="$cmd 2>&1 | grep -A 5 -E '(FAIL|ERROR|error:)' | head -100"
  echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"allow\",\"updatedInput\":{\"command\":\"$filtered_cmd\"}}}"
else
  echo "{}"
fi

预留广告位

正文中段响应式广告 等你后面真接 AdSense，这里再放正式广告。

Documentation Index

这里不是让你背"Documentation Index"这个词，而是让你看它真干活时怎么使。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Track your costs

这一段主要是在把"Track your costs"讲实，不是只摆个标题给你看。

Using the /usage command

这里主要是在交代"Using the /usage command"这一块会碰到哪些事。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

关键片段

Using the /usage command

下面这块是这一段最值钱的原文样板，先对着看一眼。

Total cost:            $0.55
Total duration (API):  6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes:    0 lines added, 0 lines removed

Managing costs for teams

这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Rate limit recommendations

这一段更像在讲判断条件，什么时候该上，什么时候先别急。把触发条件看清，比背标题更重要。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Agent team token costs

看到这里，就把"Agent team token costs"当成一件真要上手的活来看。

如果你打算把外接能力往里挂，这里提到的 hooks、MCP、skills、memory 都要分清各自负责哪一摊。

Reduce token usage

这里不是让你背"Reduce token usage"这个词，而是让你看它真干活时怎么使。

Manage context proactively

这段主要是在说平时怎么管，不是光教你怎么开。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

关键片段

Manage context proactively

这一段要真抓重点，通常就抓下面这块原文。

# Compact instructions

When you are using compact, please focus on test output and code changes

Choose the right model

看这段时就盯一个事：到底该选哪条更合适。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Reduce MCP server overhead

这一块主要是在说"Reduce MCP server overhead"真到手上该怎么用，哪里最容易踩坑。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

Install code intelligence plugins for typed languages

这段就是手把手操作，照顺序来最稳。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

Offload processing to hooks and skills

这一段主要是在把"Offload processing to hooks and skills"讲实，不是只摆个标题给你看。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

改配置

Offload processing to hooks and skills 1

这会儿轮到改配置了，字段名和关键字别自己乱换。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/filter-test-output.sh"
          }
        ]
      }
    ]
  }
}
终端里敲

Offload processing to hooks and skills 2

先别急着往下翻，下面这条命令跑完，心里才有底。

#!/bin/bash
input=$(cat)
cmd=$(echo "$input" | jq -r '.tool_input.command')

# If running tests, filter to show only failures
if [[ "$cmd" =~ ^(npm test|pytest|go test) ]]; then
  filtered_cmd="$cmd 2>&1 | grep -A 5 -E '(FAIL|ERROR|error:)' | head -100"
  echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"allow\",\"updatedInput\":{\"command\":\"$filtered_cmd\"}}}"
else
  echo "{}"
fi

Move instructions from CLAUDE.md to skills

这里不是让你背"Move instructions from CLAUDE.md to skills"这个词，而是让你看它真干活时怎么使。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Adjust extended thinking

这一段主要是在把"Adjust extended thinking"讲实，不是只摆个标题给你看。

Delegate verbose operations to subagents

这一段主要是在把"Delegate verbose operations to subagents"讲实，不是只摆个标题给你看。

Manage agent team costs

看到这类标题，就把它当成日常管摊子的规矩。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Write specific prompts

这里不是让你背"Write specific prompts"这个词，而是让你看它真干活时怎么使。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

Work efficiently on complex tasks

这一段主要是在把"Work efficiently on complex tasks"讲实，不是只摆个标题给你看。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

Background token usage

这里不是让你背"Background token usage"这个词，而是让你看它真干活时怎么使。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Understanding changes in Claude Code behavior

看到这里，就把"Understanding changes in Claude Code behavior"当成一件真要上手的活来看。

照着做一遍

如果你不想来回翻，就先照这几步顺着做。

每做完一步就看一下结果，再决定要不要继续往下。

关键片段

第 1 步：Using the /usage command

下面这块是这一段最值钱的原文样板，先对着看一眼。

Total cost:            $0.55
Total duration (API):  6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes:    0 lines added, 0 lines removed
关键片段

第 2 步：Manage context proactively

这一段要真抓重点，通常就抓下面这块原文。

# Compact instructions

When you are using compact, please focus on test output and code changes
改配置

第 3 步：Offload processing to hooks and skills 1

这会儿轮到改配置了，字段名和关键字别自己乱换。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/filter-test-output.sh"
          }
        ]
      }
    ]
  }
}
终端里敲

第 4 步：Offload processing to hooks and skills 2

先别急着往下翻，下面这条命令跑完，心里才有底。

#!/bin/bash
input=$(cat)
cmd=$(echo "$input" | jq -r '.tool_input.command')

# If running tests, filter to show only failures
if [[ "$cmd" =~ ^(npm test|pytest|go test) ]]; then
  filtered_cmd="$cmd 2>&1 | grep -A 5 -E '(FAIL|ERROR|error:)' | head -100"
  echo "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"allow\",\"updatedInput\":{\"command\":\"$filtered_cmd\"}}}"
else
  echo "{}"
fi

一眼看懂这一页

先把这页到底在讲什么看明白，再去碰具体命令和配置，最不容易绕晕。

Costs
   |
   v
这是 Usage and costs 里的一摊要紧活
   |
   v
先弄懂，再下手

文末提醒

这站会按官方 docs 的导航和内容变化继续重生成，原站加页、删页、改页时，这里会跟着更新。

人话解释会尽量顺着原页往下讲，但命令、参数名、配置名这些硬东西还是保留原样，免得你抄过去跑不起来。

预留广告位

文末横幅广告 适合放在文章读完以后，不抢首屏注意力。