# 快速上手

> ⚡ 还没接入？一条命令完成全部配置：`curl -fsSL https://qcode.cc/install/claude-code.sh | bash`（Windows：`irm https://qcode.cc/install/claude-code.ps1 | iex`）。详见 [一键配置脚本](/docs/getting-started/one-click-install)。

完成安装和环境变量配置后，让我们用 5 分钟掌握 Claude Code 的核心用法。

## 启动 Claude Code

在终端中进入你的项目目录，然后运行：

```bash
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 进行分析：

```bash
# 解释 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 会自动：

1. 分析所有变更

2. 生成规范的 commit message

3. 完成提交

## 高效使用技巧

1. **明确意图**：描述清楚你想要什么，包括约束条件

2. **分步执行**：复杂任务拆分成小步骤

3. **及时中断**：输出不符合预期时立即按 `Esc`

4. **善用引用**：用 `@` 指定文件避免 AI 猜测

5. **保持上下文**：同一会话中 Claude 会记住之前的对话

## 下一步

恭喜你已经掌握了 Claude Code 的核心用法！接下来：

1. 探索 [命令行技巧](/docs/usage/cli-tips) 了解 34 条实用技巧

2. 学习 [工作流技巧](/docs/usage/workflow-tips) 提升开发效率

3. 查看 [Codex 集成](/docs/ide/codex) 使用另一个 AI 工具