跳到主要内容

Claude 从未见过 68% 的 Claude Code 文档

每个 Claude 模型都是从其训练截止日期时的文档中学会 Claude Code 的。此后文档仍在不断变化。我们按周回放了它的历史,以衡量两者已经相隔多远。

68%

of what the official Claude Code docs said on 2026年10月15日 was not in them at the end of 2026年6月: the training cutoff of Fable 5.1, Mythos 5.1, Opus 5.5, Sonnet 5.5, Haiku 5.5.

最新的模型 Fable 5.1、Opus 5.5、Sonnet 5.5 和 Haiku 5.5 的可靠知识截止日期是 2026 年 6 月。从 6 月底到 10 月 15 日,文档从 107 页增长到 164 页,如今文档所说的大部分内容都写于这三个半月里。若按更严格的方式计算,即按确切措辞而非按事实,这一比例升至 72%。去掉代码示例则是 70%。无论怎么算,Claude 都从未见过自己手册的大部分内容。

每个模型从未见过什么​

截止日期越早,模型能读到的今天的文档就越少。这些模型目前都仍可通过 Claude API 使用。

  • 2025年2月Haiku 4.5≥ 98.6%
  • 2025年5月Opus 4.5, Opus 4.6≥ 98.6%
  • 2025年8月Sonnet 4.698%
  • 2026年1月Fable 5, Mythos 5, Sonnet 5, Opus 4.7, Opus 4.893.3%
  • 2026年5月Opus 571.3%
  • 2026年6月Fable 5.1, Mythos 5.1, Opus 5.5, Sonnet 5.5, Haiku 5.568.3%

≥ marks cutoffs before July 2025, where the history starts: those models saw even less, so the true share is higher.

Claude Haiku 4.5 的截止日期是 2025 年 2 月,早于几乎所有内容:Claude Code 就在那个月以研究预览版发布,而今天文档的几乎全部内容都出现在之后。

选择你学习 Claude Code 的那一周​

同样的算术也适用于人。把滑块移到你阅读文档的那一周,或你正在跟着学的教程的日期。

68.3%of what the docs say today was not there yet26.9%of what you read has since been deleted, or changed in a number, flag or name107 → 164pages then and now

文档不只是扩充,还会被重写​

增长解释了差距的大部分,但不是全部。页面也会被重写。下面每一条色带是一个季度内写下的文本;随着其中的句子被删除或修改,色带会变细。

035,00070,0002025年7月2026年3月2026年10月
  • Already there in July 2025
  • 2025 Q3
  • 2025 Q4
  • 2026 Q1
  • 2026 Q2
  • 2026 Q3
  • 2026 Q4
Show the data
WeekBefore Jul 20252025 Q32025 Q42026 Q12026 Q22026 Q32026 Q4
2025年7月2,845000000
2025年9月2,2841,52100000
2025年11月2,2371,5611,8710000
2025年12月2,0551,4623,5610000
2026年2月1,5131,0052,6056,204000
2026年4月1,3819552,3148,5405,34000
2026年6月1,2418021,9917,82813,61900
2026年8月9476631,8127,26612,61814,6610
2026年10月8856089676,26910,53532,3245,895
2026年10月8695989576,20610,42631,7089,333

2025 年 7 月,文档有 29 页。如今有 164 页,句子和代码行数是当时的 21 倍。在 2025 年 7 月的文档中,仍然有效的只有 30.5%;其余部分要么被删除,要么被重写,数字、标志或名称都变了。就连最新模型看到的 2026 年 6 月文档,也在不到四个月里失去了 26.9% 的事实。

一句话能维持多久​

追踪每一句话,从它出现的那一周到它消失的那一周,其中一半会在 196 天内消失或被改写。如果只有改动数字、标志、路径或名称的改写才算数,那么一半的事实会在 266 天内消失:约九个月。

0%50%100%266 days196 days0 days180 days360 days
  • Same facts, any wording: half gone after 266 days
  • Exact wording: half gone after 196 days

你的模型从未听说过的东西​

这些是今天参考表中、但在某个模型的截止日期时尚不存在的标识符:CLI 标志、斜杠命令、hook 事件和环境变量。向 Claude 问起其中任何一个,它只能猜。

203 identifiers are in the reference tables today that were not there on 2026年6月24日.

CLI flags 11

  • --append-subagent-system-prompt
  • --append-subagent-system-prompt-file
  • --autocompact
  • --cloud
  • --desktop
  • --environment
  • --forward-subagent-text
  • --permission-prompts
  • --ref
  • --restricted
  • --system-prompt-snapshot

Slash commands 21

  • /artifact-capabilities
  • /artifact-diagramming
  • /artifacts
  • /auto-mode-setup
  • /autocompact
  • /bug
  • /claude-in-chrome
  • /dataviz
  • /design
  • /design-login
  • /design-sync
  • /import
  • /list-agents
  • /output-style
  • /plugin-authoring
  • /rate-limit-options
  • /skill-doctor
  • /slides
  • /subtask
  • /update-config
  • /workflow-authoring

Hook events 3

  • DirectoryAdded
  • PostModelSwitch
  • PreModelSwitch

Environment variables 168

Show all 168
  • ANTHROPIC_BEDROCK_REGION_PREFIX
  • ANTHROPIC_DEFAULT_MODEL
  • ANTHROPIC_FEDERATION_RULE_ID
  • ANTHROPIC_FOUNDRY_AUTH_TOKEN
  • ANTHROPIC_ORGANIZATION_ID
  • ANTHROPIC_PROFILE
  • BETA_TRACING_ENDPOINT
  • CCR_SESSION_ACCOUNT_EMAIL
  • CLAUDE_AFK_COUNTDOWN_MS
  • CLAUDE_AFK_TIMEOUT_MS
  • CLAUDE_AX_PREPARK_MS
  • CLAUDE_AX_STARTUP_QUIET_MS
  • CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS
  • CLAUDE_CODE_ARTIFACT_COMMENTS
  • CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT
  • CLAUDE_CODE_ARTIFACT_PUBLISH_EDITS
  • CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS
  • CLAUDE_CODE_AUTO_MODE_SERVER
  • CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS
  • CLAUDE_CODE_BASH_EDIT_DIFF
  • CLAUDE_CODE_BG_TASKS_REPORT_RUNNING
  • CLAUDE_CODE_BRIDGE_SESSION_ID
  • CLAUDE_CODE_BS_AS_CTRL_BACKSPACE
  • CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION
  • CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK
  • CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT
  • CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD
  • CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF
  • CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP
  • CLAUDE_CODE_DISABLE_CFC_PROMPT
  • CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT
  • CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS
  • CLAUDE_CODE_DISABLE_FILE_MENTIONS
  • CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT
  • CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK
  • CLAUDE_CODE_DISABLE_MOUSE_CLICKS
  • CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION
  • CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK
  • CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS
  • CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY
  • CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK
  • CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS
  • CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT
  • CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT
  • CLAUDE_CODE_DISABLE_WEB_FETCH
  • CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER
  • CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS
  • CLAUDE_CODE_ENABLE_CFC
  • CLAUDE_CODE_ENABLE_TODO_TOOLS
  • CLAUDE_CODE_FORCE_TERMINAL_IMAGES
  • CLAUDE_CODE_FORWARD_SUBAGENT_TEXT
  • CLAUDE_CODE_GATEWAY_HINT_HEADERS
  • CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS
  • CLAUDE_CODE_GOAL_CHECKIN_MINUTES
  • CLAUDE_CODE_GZIP_REQUEST_BODIES
  • CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS
  • CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS
  • CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH
  • CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION
  • CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH
  • CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION
  • CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS
  • CLAUDE_CODE_MCP_STARTUP_WAIT_MS
  • CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT
  • CLAUDE_CODE_MESSAGING_SOCKET
  • CLAUDE_CODE_MESSAGING_TOKEN
  • CLAUDE_CODE_NONBLOCKING_STDOUT
  • CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES
  • CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH
  • CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS
  • CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS
  • CLAUDE_CODE_PLUGIN_DIRS
  • CLAUDE_CODE_PLUGIN_DIR_WATCH
  • CLAUDE_CODE_PROCESS_WRAPPER
  • CLAUDE_CODE_PROJECT_DIR_NAME
  • CLAUDE_CODE_PROMPT_CACHE_TTL
  • CLAUDE_CODE_REMOTE_MCP_CONFIG
  • CLAUDE_CODE_REMOTE_SESSION_UUID
  • CLAUDE_CODE_REMOTE_SLACK_THREAD_TS
  • CLAUDE_CODE_REMOTE_SLACK_THREAD_URL
  • CLAUDE_CODE_RESTRICTED
  • CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS
  • CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS
  • CLAUDE_CODE_SEND_FEEDBACK
  • CLAUDE_CODE_SESSION_ACCESS_TOKEN
  • CLAUDE_CODE_SKIP_AWS_CRED_CACHE
  • CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS
  • CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK
  • CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY
  • CLAUDE_CODE_STARTUP_FAILURE_RESULTS
  • CLAUDE_CODE_SUBAGENT_MODEL_FORCE
  • CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL
  • CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS
  • CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE
  • CLAUDE_CODE_TOOL_MEMORY_LIMIT
  • CLAUDE_CODE_TRANSCRIPT_LOCAL_GC
  • CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS
  • CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS
  • CLAUDE_CODE_WEBFETCH_DEADLINE_MS
  • CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR
  • CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE
  • CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS
  • CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS
  • CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUG
  • CLAUDE_DISABLE_ADOPT
  • CLAUDE_JOB_DIR
  • CLAUDE_PID
  • CLAUDE_PLUGIN_ROOT
  • CLAUDE_RUNNER_ACCOUNT_EMAIL
  • CLAUDE_RUNNER_ACCOUNT_ID
  • CLAUDE_RUNNER_API_BASE_URL
  • CLAUDE_RUNNER_ATTEMPT
  • CLAUDE_RUNNER_CHECKOUT_PATH
  • CLAUDE_RUNNER_CLAUDE_BIN
  • CLAUDE_RUNNER_CLIENT_PLATFORM
  • CLAUDE_RUNNER_CORRELATION_ID
  • CLAUDE_RUNNER_DEBUG_LOG_PATH
  • CLAUDE_RUNNER_EXIT_REASON
  • CLAUDE_RUNNER_FETCH_DEPTH
  • CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS
  • CLAUDE_RUNNER_ORDER_ID
  • CLAUDE_RUNNER_ORDER_SERVER_TIME
  • CLAUDE_RUNNER_POOL_ID
  • CLAUDE_RUNNER_PRIMARY_REPO_REVISION
  • CLAUDE_RUNNER_PRIMARY_REPO_URL
  • CLAUDE_RUNNER_REPO_REF
  • CLAUDE_RUNNER_REPO_SOURCES
  • CLAUDE_RUNNER_REPO_URL
  • CLAUDE_RUNNER_SESSION_ID
  • CLAUDE_RUNNER_SESSION_UUID
  • CLAUDE_RUNNER_SKIP_GIT_VERIFY
  • CLAUDE_RUNNER_WORKSPACE_PATHS
  • CLAUDE_RUNNER_WORK_ORDER_FILE
  • CLAUDE_SESSION_INGRESS_TOKEN_FILE
  • CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS
  • CLAUDE_SUBAGENT_BG_SHELL_MAX_MS
  • CRYPT_E_NO_REVOCATION_CHECK
  • DATABASE_URL
  • ENABLE_BETA_TRACING_DETAILED
  • FORCE_HYPERLINK
  • GITHUB_TOKEN
  • GIT_CONFIG_COUNT
  • MCP_DISCOVERY_CACHE
  • MCP_DISCOVERY_CACHE_MAX_STALE_S
  • MCP_DISCOVERY_CACHE_STRIKES
  • MCP_DISCOVERY_CACHE_TTL_S
  • MCP_PROTOCOL_NEGOTIATION
  • MCP_SDK_GENERATION
  • NPM_TOKEN
  • OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT
  • OTEL_EXPORTER_OTLP_LOGS_HEADERS
  • OTEL_EXPORTER_OTLP_METRICS_HEADERS
  • OTEL_EXPORTER_OTLP_TRACES_HEADERS
  • OTEL_LOG_ASSISTANT_RESPONSES
  • OTEL_LOG_MANAGED_SETTINGS
  • OTEL_METRICS_INCLUDE_REPOSITORY
  • PIP_INDEX_URL
  • SELF_HOSTED_RUNNER_BG_RESULT_GRACE_MS
  • SELF_HOSTED_RUNNER_HOST_CONFIG_DIR
  • SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS
  • SELF_HOSTED_RUNNER_POST_TURN_SETTLE_MS
  • SELF_HOSTED_RUNNER_SIGKILL_GRACE_MS
  • VERTEX_REGION_CLAUDE_5_5_OPUS
  • VERTEX_REGION_CLAUDE_5_5_SONNET
  • VERTEX_REGION_CLAUDE_5_OPUS
  • VERTEX_REGION_CLAUDE_5_SONNET
  • VERTEX_REGION_CLAUDE_FABLE_5_1
  • VERTEX_REGION_CLAUDE_HAIKU_5_5

No longer documented 1

  • CLAUDE_CODE_TEAM_NAME

"文档记录之始"不等于"发布之始":其中少数早已存在,只是后来才进入文档。无论哪种情况,模型都没有可供学习的页面。

把清单交给 Claude​

since-cutoff 插件会把这些清单放到 Claude 面前。会话启动时,一个 hook 读取正在运行的是哪个模型,并向其上下文添加一条简短的说明:在该模型截止日期之后才有文档记录的标志、命令和 hook 事件,以及一条指令——在依赖记忆或声称某功能不存在之前,先查阅文档。

claude plugin marketplace add derob98/ailmanac --sparse .claude-plugin plugins
claude plugin install since-cutoff@ailmanac

这个 hook 只有几行 POSIX shell:不需要 Node,不联网,每个会话约 400 到 750 个 token。当 Claude Code 没有把模型传给 hook 时,例如在我们的无头 -p 测试中,说明会列出自 2026 年 6 月以来的变化,这对每个 Claude 模型都成立。在那次测试中,会话收到了说明,Claude 把它一字不差地复述了出来。

该怎么做​

  • 不要相信 Claude 对 Claude Code 的记忆。 对于标志、设置、hook 和命令,让它去读页面。Claude Code 自带一个回答自身问题的向导代理,文档也在 code.claude.com/docs/llms.txt 发布了索引。
  • 给你的教程标注日期。 六个月前的指南已经失去了三分之一以上的事实。复制其中的命令之前,请对照文档检查任何更早的内容。
  • 优先选择注明核实时间的页面。 本站每个页面都带有最后一次核实的日期;新鲜度仪表盘列出了所有页面,Deprecation & Migration Watch 则追踪被移除的内容。

我们如何测量​

  • 历史。 web3dev1337/claude-code-docs 是一个知名文档镜像的分叉,保留了完整的同步历史:2025 年 7 月至 2026 年 10 月之间共 3,604 次同步。我们取每周的最后一次同步,共 67 份快照。
  • 范围。 除变更日志和每周摘要(它们本来就是为记录历史而存在)以及 Agent SDK 页面(2026 年从另一个文档站点迁入,否则会被算作新增)之外的所有 Claude Code 页面。
  • 单位。 每个页面被拆分为句子、表格行和代码行,去除链接和标记。同时出现在五个或更多页面上的行,例如横幅或通用代码行,会被丢弃。最终剩下 90,674 个不同的单位可供追踪。
  • 消失。 一个单位在连续两份每周快照中缺失,或在最新一份快照中缺失,就算消失,因此某个页面在一次同步中失败不会被计入。
  • 事实。 同一周内,替换了一句被删除句子的新句子,如果至少 60% 的词相同,且每个数字、标志、路径和标识符都完全一致,就被视为同一个事实。用这种方法关联了 7,965 处改写。
  • 截止日期。 每个模型与其截止月份最后一天或之前的最后一份每周快照比较,这是最宽松的解读。早于 2025 年 7 月的截止日期使用第一份快照,而它包含的内容已经多于这些模型可能见过的内容:它们的占比是下限。
  • 存活。 对第一份快照之后产生的所有单位做 Kaplan–Meier 估计,至今仍然存在的单位按删失处理。

这个镜像并非官方:如果它漏掉或弄乱了某个页面,数字也会随之带有偏差。我们检查了截止日期所在的几周,看是否有页面在一次同步中消失,没有发现。这项分析比较的是文本,而不是产品行为。

复现​

脚本及其输出都在本站的仓库中:scripts/research/docs-decay.mjs 和 data/research/claude-code-docs-decay.json。需要 Node 和 git,运行约 15 秒:

git clone https://github.com/web3dev1337/claude-code-docs
git clone https://github.com/derob98/ailmanac
node ailmanac/scripts/research/docs-decay.mjs claude-code-docs