基本使用方法
本节介绍Claude Code的基本使用方法和核心功能。
启动交互式会话
在项目目录中启动
bash
cd your-project
claude你会看到交互式提示符：
╭────────────────────────────────────────╮
│ Claude Code │
│ Type your message and press Enter │
╭────────────────────────────────────────╯
>指定模型
bash
# 使用默认模型
claude
# 指定模型
claude --model claude-opus-4
# 使用别名
claude -m opus一行命令执行
bash
# 直接执行任务，不进入交互模式
claude "帮我添加一个用户登录的API接口"
# 分析项目
claude "这个项目的架构是什么？"
# 修复bug
claude "修复src/auth.py中的TypeError问题"内置Slash命令
Claude Code提供了丰富的内置命令：
| 命令 | 功能 |
|---|---|
/help | 查看帮助信息 |
/clear | 清除会话历史 |
/compact | 压缩会话（节省Token） |
/cost | 查看本次会话的API消耗 |
/config | 查看或修改配置 |
/permissions | 管理权限规则 |
/doctor | 运行诊断检查 |
/init | 初始化CLAUDE.md文件 |
/mcp | 管理MCP服务器 |
/hooks | 管理Hooks |
/bug | 报告bug |
使用示例
bash
# 查看帮助
/help
# 查看成本
/cost
本次会话消耗：
- 输入: 12,345 tokens
- 输出: 3,456 tokens
- 预估费用: $0.15
# 压缩长会话
/compact
已压缩会话，保留了关键上下文。
# 运行诊断
/doctor
✓ Node.js version: 20.10.0
✓ Git installed: 2.43.0
✓ Claude authenticated
✓ MCP servers: 3 configured核心功能
功能一：代码库理解
Claude Code能在几秒内理解整个项目：
你：这个项目的结构是什么？
Claude：我来分析一下这个项目...
项目结构概览：
├── src/
│ ├── api/ # API路由层
│ │ ├── users.py # 用户相关API
│ │ └── auth.py # 认证相关API
│ ├── services/ # 业务逻辑层
│ ├── models/ # 数据模型
│ └── utils/ # 工具函数
├── tests/ # 测试文件
├── config/ # 配置文件
└── requirements.txt # 依赖列表
这是一个FastAPI项目，采用经典的三层架构...功能二：多文件编辑
你：把所有print语句改成logging
Claude：我会修改以下文件：
- src/main.py (3处)
- src/utils.py (2处)
- tests/test_main.py (1处)
正在执行修改...
[显示每个文件的具体修改]
修改完成！共修改了6处。功能三：执行Shell命令
你：运行测试并修复失败的用例
Claude：正在运行测试...
$ pytest
FAILED tests/test_user.py::test_create_user - AssertionError
FAILED tests/test_auth.py::test_login - TypeError
发现2个失败的测试，让我分析并修复...
[分析并修复代码]
修复完成，重新运行测试...
$ pytest
All tests passed! ✓功能四：Git集成
你：帮我处理GitHub上的Issue #42
Claude：让我查看Issue #42的内容...
Issue #42: 用户注册时邮箱验证失败
分析问题：
- 问题出在 src/services/email.py
- 验证链接生成逻辑有误
修复方案：
1. 修改链接生成逻辑
2. 添加单元测试
正在创建新分支 fix-email-verification...
正在修改代码...
正在运行测试...
正在创建commit...
正在创建Pull Request...
PR已创建：https://github.com/xxx/project/pull/43快捷键
| 快捷键 | 功能 |
|---|---|
Enter | 发送消息 |
Shift + Enter | 换行（多行输入） |
Ctrl + C | 中断当前操作 |
Ctrl + D | 退出会话 |
↑ / ↓ | 浏览历史消息 |
Tab | 文件路径补全 |
任务类型示例
代码编写
实现一个用户注册API，包含：
- 邮箱验证
- 密码加密
- 重复注册检查Bug修复
修复这个TypeError：'NoneType' object has no attribute 'split'
出现在 src/parser.py 第42行代码审查
审查最近提交的代码，检查：
- 安全问题
- 性能问题
- 代码规范测试编写
为 UserService 写单元测试，覆盖以下场景：
- 正常注册流程
- 邮箱重复
- 无效邮箱格式文档生成
为这个API生成文档，包含：
- 接口说明
- 参数列表
- 返回值格式
- 示例请求会话管理
保存会话上下文
Claude Code会自动保存会话上下文，下次启动时可以继续：
bash
# 会话历史保存在
~/.claude/sessions/清除会话
bash
# 清除当前会话历史
/clear
# 开始全新的会话
claude --new-session下一步
掌握了基本使用后，继续学习：
- MCP工具集成 - 连接外部工具扩展能力
- Hooks自动化机制 - 自动化开发流程