Claude Code[二] 上下文相关的机制

本文以CC代指Claude Code

从本篇开始,只有一个目标:如何让CC以最准,最快,最少token,自己最少工作量,完成工作

一.CC工作原理:智能体循环

CC处理任务时,会反复执行三个阶段:收集上下文 、采取行动 和验证结果,在此过程同时会对输入保持相应。

二.上下文Context

claude在一个对话中,获取的信息来源于以下几点,这块了解即可,只是claude能力的一部分

1.代码库

2.终端

3.git状态

4.Claude.md

5.自动记忆

6.配置的扩展,如MCP、skills、subagents、Claude in Chrome

上下文窗口是 Claude 在一次会话中所知的全部内容,而 Claude Code 围绕它设计了一整套自动压缩、内容保留与手动管理的机制,让你在有限窗口内持续工作

可执行/context查看上下文的实时数据

参考:探索上下文窗口

三.用CLAUDE.md提供持久上下文

3.1 CLAUDE.md概述

每个 Claude Code 会话都以全新的上下文窗口开始。两种机制可以跨会话传递知识:

  • CLAUDE.md 文件:您编写的指令,为 Claude 提供持久上下文。
  • 自动记忆:Claude 根据您的更正和偏好自己编写的笔记

CLAUDE.md 文件是 markdown 文件,为 Claude 提供项目、个人工作流或整个组织的持久指令。您用纯文本编写这些文件;Claude 在每个会话开始时读取它们

参考:Claude Code 如何工作

3.2 CLAUDE.md的作用域

CLAUDE.md 文件可以位于多个位置,每个位置具有不同的作用域。

作用域 位置 目的 用例示例 共享对象
托管策略 • Windows: C:\Program Files\ClaudeCode\CLAUDE.md 由 IT/DevOps 管理的组织范围指令 公司编码标准、安全策略、合规要求 组织中的所有用户
用户指令 ~/.claude/CLAUDE.md 所有项目的个人偏好 代码样式偏好、个人工具快捷方式 仅您(所有项目)
项目指令 /CLAUDE.md 或 ./.claude/CLAUDE.md 项目的团队共享指令 项目架构、编码标准、常见工作流 通过源代码控制的团队成员
本地指令 ./CLAUDE.local.md 个人项目特定偏好;添加到 .gitignore 您的沙箱 URL、首选测试数据 仅您(当前项目)

/init:若CLAUDE.md 已存在,会改进它,否则创建它

CLAUDE.md 文件可以使用 @path/to/import 语法导入其他文件

在 foo/bar/ 中运行 Claude Code,它从 foo/bar/CLAUDE.md、foo/CLAUDE.md 和任何 CLAUDE.local.md 文件加载指令。加载的文件并非覆盖,以连接的方式加到上下文中。

四. 规则用法

4.1 规则分类

CLAUDE.md为每个对话提供上下文,如果想只对某些文件或主题提供上下文,避免上下文膨胀,需要使用rules。规则分为项目规则和用户规则:

项目规则:在.claude/rules/或rules的子目录放置.md文件,每个文件应涵盖一个主题,具有描述性文件名

用户规则:~/.claude/rules/*.md适用于每个项目

4.2 规则文件写法

.md规则文件的paths部分用于匹配文件,有块写法和流式列表两种等价写法

块写法:

javascript 复制代码
---
paths:
  - "src/**/*.{ts,tsx}"
  - "lib/**/*.ts"
  - "tests/**/*.test.ts"
---

流式列表:

javascript 复制代码
---
paths: ["**/Display/**/*.cs", "**/UI/**/*.cs"]
---

匹配说明:

模式 匹配
**/*.ts 基准目录下任意位置的 .ts 文件
src/**/* 基准目录的 src/ 下的所有文件
*.md 基准目录下任意位置的 .md 文件
/*.md 直接位于基准目录中的 .md 文件,不包括子文件夹中的文件
src/components/*.tsx 直接位于基准目录的 src/components/ 中的 .tsx 文件,不包括子文件夹中的文件

记忆方法:任意目录用**,任意文件用*,任意md文件用*.md,**/*.md与*.md等价

src/*.{ts,tsx}等价于

复制代码
src/*.ts
src/*.tsx

如果不加 paths 字段,规则会在启动时加载,效果等同于 CLAUDE.md

五.AGENTS.md

5.1 AGENTS.md概述

AGENTS.md 是 CC 为兼容其他AI工具而支持的上下文文件

默认情况下,仅在工作目录或其上方没有 CLAUDE.md 时才读取 AGENTS.md

5.2 控制加载的上下文文件

会话中执行/config,在Project instructions选项中可控制加载的文件

5.3 查看已加载的文件

会话中执行/Context all可查看已加载的上下文文件

六.自动记忆

自动记忆让 Claude 跨会话积累知识,无需你编写任何内容

6.1 自动记忆的开关

在会话中执行/memory,可通过Auto-memory开启或关闭自动记忆

6.2 存储位置

执行/context all,可以看到一个memory目录,用于存放自动记忆文件

memory目录下包含若干.md文件,其中MEMORY.md是索引文件,其他的.md是一个主题的记忆文件。

6.3 自动记忆文件的读写

MEMORY.md(前200 行/25KB)每次对话加载,主体文件按需加载。Claude 根据信息在未来对话中是否有用来决定什么值得记住并自动写入主题.md

七.输出样式

作用:输出样式可改变 Claude 在整个会话中的响应和工作方式

分类:内置输出样式 和 自定义输出样式

7.1 内置输出样式

Claude Code 的五个内置输出样式,核心差异在于沟通方式与自主程度,而非底层智力或代码质量。它们都会完成同样扎实的工程任务,但"说多少、什么时候问、让不让你动手"截然不同。速度与 token 消耗的差异,主要由输出长度和交互停顿导致,而非模型本身变快或变慢。

样式 速度感知 准确度/完成度 Token 消耗 核心特点 适用情况
Default 基准 标准 基准 Claude Code 的标准系统提示,专为软件工程任务设计,无额外风格指令 日常开发,无需特殊解释或教学,只想要一个靠谱的编程助手
Proactive 最快(感知) 标准(假设合理) 与 Default 相近 收到任务立即执行,对常规决策自行做合理假设,不频繁停下来问,除非涉及删除或生产变更 你很清楚要做什么,希望 AI 一口气干完,不想被反复确认打断
Concise 快 标准(工程同样彻底) 最低 第一句就给结果,砍掉开场白、步骤叙述和总结。简单问题 1-3 句答完,但错误报告、安全警告仍完整保留 熟悉项目、只想要结果的老手;赶时间、需要快速迭代的场景
Explanatory 稍慢(输出长) 标准 + 洞察 较高 在 Default 基础上,用 Insight 块解释"为什么这样改",每块 2-3 个关于代码库或实现选择的要点 接手新项目、阅读陌生代码库;希望理解 AI 决策依据的日常开发
Learning 最慢(有停顿) 标准 + 教学 最高 包含 Explanatory 的 Insight,还会在关键设计点留 TODO(human),停下来等你写代码,你完成后才继续 学习新语言/框架、新手入门;希望边做边练,而非直接拿结果

7.2 设置输出样式

执行/output-style:列出选项,执行/output-style <style>:切换样式

/config:通过菜单设置输出样式

设置样式会保存在settings.local.json中持久化,也可以直接改settings.local.json

7.3 自定义输出样式

可通过.md文件自定义输出样式,放于以下目录:

  • 用户:~/.claude/output-styles
  • 项目:.claude/output-styles

参考:输出样式

相关推荐
真上帝的左手1 小时前
26. AI-Agent-技术架构:Harness、Runtime、Orchestrator、Framework
人工智能·架构·agent·ai编程·智能体
逐梦苍穹2 小时前
不训练不微调:直接改权重矩阵,给小模型补上新能力
ai编程·codex·claudecode
ndz2 小时前
ModelFold 对话模型订阅:三档怎么选,Claude Code 和 Codex 怎么接
ai编程
ZzT2 小时前
GPT-6.2 API 降价 20%,为什么老代码直接切过去反而更费钱?
openai·ai编程
翼帆4 小时前
我用 AI 复刻了 CodeTank,重温代码坦克
前端·javascript·开源·ai编程·游戏开发·codetank
掘黄金的打工人4 小时前
LangChain 少样本示例 和 动态示例选择
langchain·aigc·ai编程
回家路上绕了弯6 小时前
做错一步不算什么,错了接着干才是事故
ai编程
Flynt6 小时前
不装SDK手写了一遍MCP:最新规范已经没有initialize握手了
agent·ai编程·mcp
小虎AI生活15 小时前
新出的 Hy4 flash 好用吗?我用 WorkBuddy 做了个小测试
aigc·ai编程