第一次对话
启动 Claude Code 并完成第一次 AI 对话，验证配置成功
快速上手¶
验证配置：运行
claude命令，输入一条消息，收到回复就说明一切就绪。本文带你完成第一次对话，并介绍最常用的基本操作。
完成安装和环境变量配置后，让我们用 5 分钟掌握 Claude Code 的核心用法。
启动 Claude Code¶
在终端中进入你的项目目录，然后运行：
cd /path/to/your/project
claude
你会看到 Claude Code 的交互界面，现在可以开始对话了。
核心交互方式¶
1. 理解代码¶
> 这个项目的架构是怎样的？
> 解释一下 src/auth/login.ts 的工作原理
> 找出所有调用数据库的地方
2. 生成代码¶
> 写一个用户注册的 API 端点
> 为 UserService 类添加单元测试
> 创建一个 React 登录表单组件
3. 编辑现有代码¶
> 重构 utils.js，提高代码可读性
> 修复 handleSubmit 函数中的内存泄漏
> 给所有公共函数添加 TypeScript 类型
4. 调试问题¶
> 为什么用户登录后会被重定向到 404？
> 分析这个报错：TypeError: Cannot read property 'id' of undefined
> 检查 API 响应慢的原因
5. Git 操作¶
> 查看我修改了哪些文件
> 帮我提交这些更改，写一个好的 commit message
> 创建一个 PR 描述
使用 @ 引用文件¶
使用 @ 符号可以精确引用特定文件，让 Claude 直接读取内容：
> 查看 @src/components/Header.tsx 并优化性能
> 对比 @src/v1/api.js 和 @src/v2/api.js 的区别
> 根据 @package.json 分析项目依赖
技巧：输入 @ 后按 Tab 键可以自动补全文件路径。
管道输入¶
可以将其他命令的输出传递给 Claude Code 进行分析：
# 解释 git 变更
git diff | claude "解释这些代码更改"
# 分析日志错误
cat error.log | claude "分析这些错误并提供解决方案"
# 审查 PR 变更
gh pr diff 123 | claude "审查这个 PR 的代码质量"
常用斜杠命令¶
在会话中使用 / 开头的命令：
| 命令 | 说明 |
|---|---|
/help |
显示帮助信息和所有可用命令 |
/clear |
清空当前对话历史 |
/compact |
压缩对话历史以节省 token |
/model |
查看或切换模型（如 opus、sonnet） |
/memory |
编辑项目记忆文件 CLAUDE.md |
/init |
自动生成项目配置文件 |
/commit |
智能生成 commit 并提交 |
/review |
代码审查 |
/cost |
查看当前会话费用和 token 用量 |
/doctor |
诊断配置问题 |
/config |
打开设置配置 |
/mcp |
管理 MCP 服务器连接 |
/loop |
自主循环执行任务 |
/bug |
报告问题 |
键盘快捷键¶
| 快捷键 | 功能 |
|---|---|
Tab |
自动补全文件路径 |
Esc |
中断当前输出 |
Ctrl+C |
取消当前操作 |
↑ / ↓ |
浏览历史命令 |
初始化项目配置¶
首次使用时，运行 /init 让 Claude 自动分析项目并生成配置：
> /init
这会创建 CLAUDE.md 文件，包含：
-
项目技术栈和架构说明
-
常用构建和测试命令
-
代码风格规范
-
项目特定的约定
CLAUDE.md 的作用：每次启动 Claude Code 时会自动读取这个文件，让 AI 更好地理解你的项目上下文。
实战示例¶
示例 1：添加新功能¶
> 我需要添加一个用户头像上传功能，要求：
1. 支持 JPG/PNG 格式
2. 图片大小限制 2MB
3. 上传后自动裁剪为 200x200
4. 存储到 S3
示例 2：修复 Bug¶
> 用户反馈：点击"保存"按钮后页面卡住
> 请帮我排查 @src/pages/EditProfile.tsx 中的问题
示例 3：代码审查¶
> /review
> 重点关注安全性问题和性能瓶颈
示例 4：智能提交¶
> /commit
Claude 会自动：
-
分析所有变更
-
生成规范的 commit message
-
完成提交
高效使用技巧¶
-
明确意图：描述清楚你想要什么，包括约束条件
-
分步执行：复杂任务拆分成小步骤
-
及时中断：输出不符合预期时立即按
Esc -
善用引用：用
@指定文件避免 AI 猜测 -
保持上下文：同一会话中 Claude 会记住之前的对话
下一步¶
恭喜你已经掌握了 Claude Code 的核心用法！接下来：