01 - Claude Code 总览

定位

Claude Code 是 Anthropic 发布的编码助手。它以 Claude 大模型为核心推理引擎，外接一套工具系统，使模型可以读写文件、执行命令、调用外部服务，从而在真实工程环境中完成任务。

交付形态

形态	描述
CLI	在终端中以交互会话或一次性命令运行
桌面应用	macOS、Windows 独立应用
Web	在浏览器中访问 claude.ai/code
IDE 扩展	VS Code、JetBrains 系列

不同形态共享同一套 Agent 内核，差异主要在输入输出通道与权限管理策略。

核心概念

Agent

一个围绕模型展开的执行单元。Agent 接收用户输入，按固定循环推进：提示词组装 → 模型调用 → 工具执行 → 结果回填 → 下一轮，直到模型输出终止信号。

Turn

会话中的一次完整往返。一个 turn 包含一条 user 消息与随后若干条 assistant 消息（含 tool_use 与 tool_result）。

Tool

一个具名能力的封装。包含 JSON Schema 定义的参数、执行体、结果序列化器。工具在模型侧表现为可调用函数，在执行侧表现为一次本地或远程操作。

System Prompt

一段在每次 API 调用中随 system[] 字段一起发送的规则文本。由多个区块拼接而成：身份声明、行为准则、环境信息、当前工作目录状态等。

Context

模型在一次调用中实际读到的全部文本，包括 system、历史 messages、当前 user turn 及工具定义。Context 预算有限，超出后由压缩机制介入。

阅读顺序建议

1. 先读 02-agent-loop.md 建立全局流程认知
2. 再看 03-system-prompt.md 与 04-tools.md 理解两个主要的输入通道
3. 05-commands.md 之后的章节按需查阅

版本说明

本文档基于公开文档与可观察行为整理。Claude Code 迭代较快，字段名、工具集、命令列表可能随版本变化，遇到差异以当前运行版本为准。