首次使用
安装完成后,让我们来启动 Claude Code 并了解它的基本使用方法。
启动 Claude Code
基本启动命令
在终端中运行以下命令来启动 Claude Code:
# 在当前目录启动
claude
# 或者在指定目录启动
claude /path/to/your/project
# 使用特定模型启动
claude --model sonnet
# 启动时显示详细模式(可以看到思考过程)
claude --verbose
启动界面
启动后,你会看到一个简洁的欢迎界面:
╭────────────────────────────────────────────────────────╮
│ Welcome to Claude Code! 🎉 │
│ │
│ Type your message and press Enter to start │
│ Use /help to see available commands │
│ │
│ Current directory: /Users/yourname/project │
╰────────────────────────────────────────────────────────╯
Claude>
首次配置
首次启动时,Claude Code 会引导你完成基本配置:
-
身份验证
# 系统会提示你登录 Anthropic 账户
# 按照提示在浏览器中完成授权 -
设置偏好
# 选择默认模型(Sonnet 推荐用于日常开发)
# 配置编辑器偏好(VS Code、Vim 等)
# 设置自动保存偏好
基本交互方式
1. 自然语言对话
直接输入你的需求,就像与人交谈一样:
Claude> 帮我查看这个项目的结构
Claude> 这个项目是做什么的?
Claude> 找到所有的配置文件
Claude> 解释 src/utils.js 中的工具函数
2. 使用斜杠命令
Claude Code 提供了一系列强大的斜杠命令:
Claude> /help # 查看帮助信息
Claude> /clear # 清空对话历史
Claude> /exit # 退出程序
Claude> /status # 查看当前状态
Claude> /context # 查看上下文使用情况
Claude> /compact # 压缩对话历史
Claude> /memory # 管理记忆功能
Claude> /usage # 查看使用限制和配额
3. 快捷键操作
Ctrl+R # 搜索命令历史
Ctrl+O # 切换详细模式(查看 AI 思考过程)
Tab # 命令自动补全
Ctrl+C # 中断当前操作
第一个实际操作
让我们通过一个简单的例子来体验 Claude Code 的能力:
场景:了解一个新项目
-
查看项目结构
Claude> 这个项目的结构是怎样的? -
理解代码功能
Claude> src/main.py 是做什么的? -
运行项目
Claude> 如何运行这个项目?
实际例子演示
假设你有一个简单的 Python 项目:
Claude> 分析这个项目
正在分析你的项目...
📁 项目结构:
├── src/
│ ├── __init__.py
│ ├── main.py
│ └── utils.py
├── requirements.txt
├── README.md
└── tests/
📋 项目信息:
- 类型:Python 应用
- 主要功能:Web 应用(基于 Flask)
- 依赖:Flask, requests, pytest
💡 建议:
这是一个简单的 Flask Web 应用。你可以运行:
python src/main.py
来启动应用。
上下文感知功能
Claude Code 的强大之处在于其上下文感知能力:
自动上下文加载
# 使用 @-mention 自动包含目录
Claude> 检查 @src/components 中的所有组件
# Claude 会自动添加相关文件到对话上下文
# 无需手动指定每个文件
上下文管理
# 查看当前上下文使用情况
Claude> /context
# 添加目录到上下文
Claude> /add-dir src/utils
# 压缩对话历史以节省上下文
Claude> /compact
常用操作示例
代码相关操作
Claude> 读取 package.json 文件
Claude> 找到所有包含 "TODO" 的代码
Claude> 这个函数是做什么用的?
Claude> 帮我优化这段代码
Claude> 重构这个组件,使用 TypeScript
文件系统操作
Claude> 创建一个新的组件文件
Claude> 删除测试文件
Claude> 重命名这个目录
Claude> 查找所有 .json 文件
Claude> 在 @src 目录中搜索配置文件
Git 操作
Claude> 查看当前的 git 状态
Claude> 提交当前的更改
Claude> 创建一个新的分支
Claude> 查看最近的提交历史
Claude> 生成有意义的提交信息
实用技巧
1. 上下文感知
Claude Code 会记住:
- 当前工作目录
- 项目的文件结构
- 之前的对话内容
- 项目的语言和技术栈
- CLAUDE.md 文件中的项目配置
2. 多步骤任务
对于复杂的任务,Claude Code 会自动分解:
Claude> 为这个项目添加用户认证功能
我来帮你添加用户认证功能。让我先了解项目结构,
然后制定实施计划。
步骤 1: 分析现有项目结构...
步骤 2: 设计认证方案...
步骤 3: 实现认证代码...
3. 错误处理
如果遇到错误,Claude Code 会:
Claude> 修复这个 bug
看起来有个类型错误。让我检查代码并修复它...
发现的问题:
- 变量类型不匹配
修复方案:
✓ 已更新类型定义
✓ 添加了错误处理
✓ 验证修复结果
4. 扩展思考模式
使用思考模式让 AI 展示推理过程:
# 在请求中添加"think"触发扩展思考
Claude> 分析这个性能问题,think hard
# 使用 Ctrl+O 切换详细模式查看思考过程
# 思考内容会以灰色斜体显示
5. 集成外部工具
Claude Code 支持 MCP (Model Context Protocol) 扩展:
# 与 GitHub 交互
Claude> @github 创建一个新 issue
# 使用数据库
Claude> @database 查询用户表
# 浏览器自动化
Claude> @playwright 访问网站并截图
下一步
现在你已经了解了 Claude Code 的基本使用方法。接下来:
开始你的 Claude Code 之旅吧!