Claude Code 核心概念与基本用法

Claude Code 核心概念与基本用法

本章将深入介绍 Claude Code 的核心概念、基本用法以及高效使用技巧，帮助您快速上手并发挥最大价值。

2.1 核心概念

Claude Code 的核心围绕三个关键概念展开：对话（Conversation）、上下文（Context） 和 工具（Tools）。理解这三者及其交互方式，是高效使用 Claude Code 的基础。

2.1.1 对话（Conversation）

对话是您与 Claude Code 交互的基本单位。每个对话都是一个独立的会话，包含完整的交互历史。

对话特性：
├── 独立性 – 每个对话相互独立，互不干扰
├── 持久性 – 对话内容可以保存和恢复
├── 连续性 – 对话中的消息按顺序关联
└── 上下文承载 – 对话承载着完整的交互上下文

2.1.2 上下文（Context）

上下文是 Claude Code 理解您需求的基石。它包括显式上下文（您提供的信息）和隐式上下文（对话历史、环境信息等）。

上下文层次结构：
├── 项目上下文
│ ├── 工作目录文件
│ ├── 项目配置文件
│ └── 代码库结构
├── 会话上下文
│ ├── 对话历史
│ ├── 已执行的命令
│ └── 工具调用记录
├── 环境上下文
│ ├── 系统信息
│ ├── 环境变量
│ └── 运行时状态
└── 自定义上下文
├── 用户偏好
├── 技能配置
└── 记忆文件

2.1.3 工具（Tools）

工具是 Claude Code 与外部世界交互的能力。每个工具都有特定的功能和用途。

核心工具类别：
├── 文件操作
│ ├── read – 读取文件内容
│ ├── write – 创建或覆写文件
│ └── edit – 精确编辑文件
├── 命令执行
│ ├── exec – 执行 Shell 命令
│ └── process – 管理后台进程
├── 信息获取
│ ├── web_search – 网络搜索
│ └── web_fetch – 获取网页内容
├── 浏览器控制
│ ├── browser – 控制浏览器
│ └── canvas – 展示内容
└── 消息通信
├── message – 发送消息
└── tts – 文本转语音

2.2 基本用法与交互模式

2.2.1 启动与基本操作

启动 Claude Code：

# 启动 Claude Code CLI
claude

# 在特定目录启动
cd my-project && claude

# 使用特定模型
claude –model claude-3-opus

# 加载之前的对话
claude –resume path/to/conversation.json

2.2.2 交互模式详解

1. 直接指令模式

最常用的模式，直接描述需求即可：

用户：创建一个 TypeScript 配置文件

Claude：[读取项目信息] [分析需求] [创建文件]
已创建 tsconfig.json…

2. 多轮对话模式

通过连续交互逐步完善：

用户：帮我优化这段代码
[粘贴代码]

Claude：分析代码发现以下可优化点…

用户：全部应用

Claude：[应用优化] [输出结果]

3. 上下文感知模式

利用项目上下文自动推断：

用户：添加一个新页面

Claude：检测到项目使用 Next.js App Router
[读取现有页面结构]
[分析命名规范]

创建页面路径？

2.2.3 特殊命令

# 会话管理
/save <path> # 保存当前对话
/load <path> # 加载对话
/clear # 清除对话历史
/new # 开始新对话

# 模型控制
/model <name> # 切换模型
/thinking on # 启用思考模式
/status # 查看状态

# 工具控制
/tools # 列出可用工具
/permissions # 管理权限设置

# 帮助
/help # 显示帮助
/skills # 列出可用技能

2.3 提示词编写技巧

2.3.1 高效提示词结构

SCOPED 框架：

S – Specific（具体）
C – Context（上下文）
O – Output（输出格式）
P – Parameters（参数约束）
E – Examples（示例）
D – Dependencies（依赖条件）

2.3.2 上下文提供技巧

1. 项目上下文注入

在项目根目录创建 .claude/ 或使用 CLAUDE.md：

# 项目：电商后台系统
技术栈：React + TypeScript + Tailwind + Zustand
代码规范：ESLint + Prettier
命名约定：组件 PascalCase，函数 camelCase
测试要求：每个组件需有对应测试文件

2.3.3 常见场景提示词模板

代码生成：

创建 [组件名/函数名]：
– 功能：[详细描述]
– 输入参数：[参数列表及类型]
– 返回值：[返回类型及含义]
– 依赖：[使用的库/框架]
– 参考：[类似代码或风格参考]

代码审查：

审查以下代码：
```[粘贴代码]```

关注点：
– 安全漏洞
– 性能问题
– 代码风格
– 最佳实践
– 可维护性

2.4 上下文管理

2.4.1 上下文限制与优化

Token 限制认知：

模型 Token 限制：
– Claude 3 Opus: ~200K tokens
– Claude 3.5 Sonnet: ~200K tokens

实际使用建议：
– 单次对话保持在 50K tokens 以内
– 超过 100K tokens 开始考虑压缩
– 定期清理不必要的历史

2.4.2 上下文分层管理

第一层：系统上下文（自动管理）

由 Claude Code 自动加载：
– AGENTS.md – 工作空间配置
– SOUL.md – AI 身份设定
– USER.md – 用户信息
– TOOLS.md – 工具特定配置

第二层：项目上下文（项目级）

项目根目录配置：
– CLAUDE.md 或 .claude/instructions.md
– 项目特定的上下文说明
– 代码规范和约定
– 技术栈说明

第三层：会话上下文（对话级）

对话中的上下文：
– 当前对话的历史消息
– 已读取的文件内容
– 已执行的命令结果
– 临时变量和状态

2.5 会话保存与恢复

2.5.1 会话保存机制

保存对话：

# 命令行保存
/save conversations/my-project-2024-01-15.json

# 自动保存（默认行为）
# Claude Code 自动保存到 ~/.claude/conversations/

2.5.2 会话恢复

从文件恢复：

# 恢复特定对话
claude –resume conversations/my-project.json

# 恢复最近对话
claude –resume-last

# 列出可恢复对话
claude –list-conversations

2.6 实战案例

案例 1：高效的代码重构对话

用户：
我需要重构 src/api/client.ts，目标是：
1. 提高可测试性（依赖注入）
2. 完善类型定义
3. 添加请求重试机制

约束：
– 保持向后兼容
– 不改变公共 API
– 测试覆盖率 > 80%

案例 2：上下文感知的新功能开发

用户：添加用户头像上传功能

Claude 自动获取上下文：
[读取项目结构] → Next.js App Router
[读取现有组件] → 使用 shadcn/ui
[读取 API 路由] → RESTful 风格
[读取数据库 schema] → Prisma ORM

生成代码符合项目规范

2.7 小结

核心要点：
┌─────────────────────────────────────────────────────────┐
│ 1. 对话是基本单位 – 一个对话专注一个任务 │
│ 2. 上下文是关键 – 清晰的上下文 = 更好的结果 │
│ 3. 工具是能力 – 理解工具才能发挥最大价值 │
│ 4. 提示词是桥梁 – 清晰、具体、有结构 │
│ 5. 管理是持续 – 定期清理、归档、优化 │
└─────────────────────────────────────────────────────────┘

下一章：Claude Code CLI命令详解 – 深入了解每个命令的功能和使用场景。