基础使用

掌握 Claude Code 的基础使用方法，开启智能编程之旅。

短答案

Claude Code 最适合处理明确的项目任务：告诉它目标、相关文件或错误现象，让它先检查再修改，最后用项目真实命令验证结果。

你的任务	推荐 prompt 模式	如何验证	常见错误
理解代码库	`先读取相关文件，解释 <功能> 是怎么工作的。`	Claude 能说出真实文件和数据流。	只问“讲讲架构”，不给目标功能。
修 bug	`根据 <现象/错误> 排查原因，确认后再修改。`	测试、构建或手动检查通过。	只说“帮我修”，不给错误或路径。
加功能	`先给实现计划，再做最小可用版本。`	新路径可用，旧行为没坏。	让 Claude 顺手重写无关代码。
重构	`先找现有模式，提出小范围重构，再只改目标文件。`	diff 小，测试仍通过。	没看本地约定就开始抽象。
代码审查	`按 bug 和回归风险审查，给文件引用。`	发现必须能对应到具体文件或行为。	只要泛泛最佳实践。
写文档	`按当前代码和命令更新文档。`	命令、路径、链接真实存在。	凭记忆写文档。

第一次会话检查清单

在项目根目录打开 Claude Code。
涉及账号、计费或 API key 时先跑 /status。
让 Claude 先检查，再修改。
明确文件、命令、错误现象或目标功能。
修改后要求它运行项目真实验证命令。

启动 Claude Code

交互模式

在终端中直接运行：

claude

这将启动交互式会话，您可以与 Claude 进行对话式编程。

单次命令模式

使用 -p 参数执行单次命令：

claude -p "分析当前项目的代码结构"

基本交互

文件操作

读取文件：

请读取 src/main.js 文件并解释其功能

编辑文件：

请在 package.json 中添加一个新的脚本命令 "dev": "vite"

创建文件：

创建一个新的 React 组件 Button.tsx，包含基本的按钮功能

代码分析

理解代码：

解释这段代码的作用：
function fibonacci(n) {
  if (n <= 1) return n;
  return fibonacci(n-1) + fibonacci(n-2);
}

代码审查：

审查 src/utils.js 文件，指出潜在的问题和改进建议

项目操作

项目分析：

分析当前项目的技术栈和架构

依赖管理：

检查 package.json 中过时的依赖并建议更新

核心概念

上下文理解

Claude Code 具有项目上下文感知能力：

自动读取 CLAUDE.md 配置文件
理解项目结构和文件关系
记住对话历史中的重要信息

工具集成

Claude Code 可以使用多种工具：

文件系统操作：读取、写入、删除文件
命令行工具：执行 bash 命令
版本控制：Git 操作
包管理：npm、yarn、pip 等

智能建议

Claude 会根据项目情况提供智能建议：

代码风格统一
最佳实践推荐
性能优化建议
安全问题识别

常用命令模式

快速修复

修复 eslint 检查出的所有错误

代码重构

将这个类组件重构为函数组件，使用 hooks

测试编写

为 src/utils/math.js 中的函数编写单元测试

文档生成

为当前项目生成详细的 README.md 文档

最佳实践

1. 明确指令

❌ 不好的指令：

帮我修复这个 bug

✅ 好的指令：

src/components/UserList.tsx 中的用户列表不显示，请检查代码并修复问题

2. 提供上下文

❌ 缺少上下文：

优化这段代码

✅ 包含上下文：

这段代码是用户认证逻辑，目前性能较慢，请优化：
[粘贴代码]

3. 分步执行

对于复杂任务，分步进行：

第一步：分析当前的数据库结构
第二步：设计新的用户表
第三步：编写迁移脚本

进阶技巧

使用 Tab 补全

在输入文件路径时，使用 Tab 键可以快速补全路径。

多文件操作

同时修改 src/components/ 目录下的所有 .tsx 文件，添加 TypeScript 严格类型检查

项目范围搜索

在整个项目中搜索使用了 deprecated API 的代码并建议替换方案

下一步: CLAUDE.md 配置 - 深入了解配置文件的使用。

基础使用

On this page