Claude Code
当前市场上最具代表性的**终端 AI 编程代理 (Terminal AI Coding Agent)** 之一。简单来说,Claude Code 是一个直接运行在你的命令行里的智能代码工具,它能理解你的整个代码库,自主编辑文件、运行命令,并与你的开发工具链深度整合。
[!info] related notes autonomous-coding-agent opencode mcp claude-code-memory AI Agent 配置文件路径参考
Claude-Code
[!info] related notes
- 相关产品: Claude AI, claude使用报错, opencode
- 相关工作流: autonomous-coding-agent, mcp
Overview
一个 Anthropic(也即Claude厂商)推出的 终端AI编程代理。 官方支持以Claude账号订阅登录。 但是除此以外,也支持通过环境变量覆盖ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN来使用其他厂商模型接入开发。
记忆机制
Claude Code 的记忆更适合拆成两层看:
- 手写的
CLAUDE.md - 自动积累的 Claude Code Memory
这让它比较适合本地优先、可审计、可编辑的开发流。
规则文件与配置文件
规则 / 记忆文件
Claude Code 主要有两条规则文件线:
CLAUDE.md/CLAUDE.local.md.claude/rules/
常见层级如下:
- 用户级:
~/.claude/CLAUDE.md - 用户级规则目录:
~/.claude/rules/**/*.md - 项目级:
CLAUDE.md或.claude/CLAUDE.md - 项目级规则目录:
.claude/rules/**/*.md - 本地个人项目覆盖:
CLAUDE.local.md - 组织托管:系统目录下的
CLAUDE.md
加载规则不是“最近的覆盖最远的”,而是:
- 沿当前工作目录向上发现
- 把发现的
CLAUDE.md/CLAUDE.local.md拼接到上下文 - 同目录中
CLAUDE.local.md会追加在CLAUDE.md后面 .claude/rules/下的规则文件会递归发现并在匹配场景下参与上下文- 用户级规则先于项目级规则加载,因此项目规则优先级更高
Claude Code 不直接读 AGENTS.md。如果仓库已经有 AGENTS.md,更稳的做法是在 CLAUDE.md 中通过 @AGENTS.md 导入。
Prompt / slash command 文件
Claude Code 还支持把常用 prompt 固化成自定义 slash commands:
- 用户级:
~/.claude/commands/*.md - 项目级:
.claude/commands/*.md
这些 Markdown 文件会变成 /命令名,适合把高频 prompt、review 模板、fix 模板做成可复用入口。
配置文件
- 用户设置:
~/.claude/settings.json - 项目共享设置:
.claude/settings.json - 项目本地覆盖:
.claude/settings.local.json - 用户级 MCP:
~/.claude.json - 项目级 MCP:
.mcp.json
优先级从高到低:
- Managed
- CLI arguments
- Local
- Project
- User
如果要看当前哪些配置源生效,官方推荐在 Claude Code 里运行 /status。
多 Agent 编排
Claude Code 内置了 Workflow 多 Agent 编排引擎,支持用确定性脚本控制多个 sub-agent 协作:
- Claude Code Workflow — Workflow 引擎详解(API、并发、Schema、缓存恢复)
- Claude Code 多 Agent 编排模式 — Agent 工具 vs Workflow vs 直接对话的对比与选型