编辑 - 快速上手 - 个人运维平台

取消

## 安装

### 前置要求

- **Node.js** 18 或更高版本
- **npm** 或 **yarn** 包管理器
- 一个 **Anthropic 控制台** 账号（用于 API 密钥）

推荐使用 nvm 管理 Node.js 版本：

```bash
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# 安装 Node.js LTS
nvm install 22
nvm use 22
```

### 安装 Claude Code

```bash
npm install -g @anthropic-ai/claude-code
```

验证安装：

```bash
claude --version
```

### 配置 API 密钥

Claude Code 需要 API 密钥才能运行。有两种方式：

**方式一：环境变量**

```bash
export ANTHROPIC_API_KEY=sk-ant-xxxxx
```

**方式二：配置文件**

在 `~/.claude.json` 中配置：

```json
{
  "apiKey": "sk-ant-xxxxx"
}
```

API 密钥可以在 [console.anthropic.com](https://console.anthropic.com) 获取。

## 第一次启动

在项目目录中运行：

```bash
cd your-project
claude
```

首次启动会：

1. **身份验证**：检查 API 密钥是否有效
2. **项目索引**：扫描项目文件结构
3. **检测 CLAUDE.md**：如果有则自动加载
4. **进入交互模式**：等待你的第一条指令

启动成功后，你会看到：

```
┌─ Claude Code ──────────────────────────┐
│                                        │
│  你好！我是 Claude，已准备好帮助你。    │
│                                        │
│  项目：my-project                      │
│  文件数：127                           │
│                                        │
│  请输入你的需求...                      │
└────────────────────────────────────────┘
```

## 基础工作流

### 场景一：日常开发

```
你：帮我添加一个用户注册的 API 接口
Claude：我来看看现有的代码结构...
       （读取相关文件）
       我建议这样实现：
       1. 在 routes/ 下创建 register.ts
       2. 添加验证逻辑
       3. 连接数据库保存用户
       开始编码...
       （创建文件、编辑代码）
       实现完成，运行测试检查...
       测试通过 ✅
```

### 场景二：快速理解代码

```
你：src/auth.ts 里的 login 函数是怎么工作的？
Claude：读取文件...
       这个函数的工作流程是：
       1. 接收 email 和 password
       2. 从数据库查找用户
       3. 用 bcrypt 比对密码
       4. 生成 JWT token
       5. 返回 token 和用户信息
```

### 场景三：修复 Bug

```
你：测试报错了，帮我看看
Claude：运行测试...
       报错信息：Cannot read properties of undefined
       定位到 src/user.ts:45
       原因是 user.profile 可能为 null
       修复方案：添加可选链操作符 user.profile?.name
       修复完成，重新运行测试...
       全部通过 ✅
```

### 场景四：代码审查

```
你：审查一下我刚提交的改动
Claude：读取 diff...
       发现 3 个问题：
       1. ❌ 密码没有哈希处理
       2. ⚠️ 缺少输入验证
       3. ℹ️ 建议添加错误处理
       是否需要我修复这些问题？
```

## 常用命令速查

### 启动相关

| 命令 | 说明 |
|------|------|
| `claude` | 启动交互式会话 |
| `claude "写一个单元测试"` | 直接执行任务后退出 |
| `claude -p "分析代码"` | 同上，短参数形式 |
| `claude --help` | 查看所有启动参数 |

### 会话内命令

| 命令 | 说明 |
|------|------|
| `/help` | 查看所有可用命令和说明 |
| `/clear` | 清空当前对话历史 |
| `/cost` | 查看当前会话的 Token 消耗 |
| `/doctor` | 诊断环境是否正确配置 |
| `/memory` | 查看和管理记忆 |
| `/config` | 修改 Claude Code 设置 |

### 中断与退出

| 操作 | 说明 |
|------|------|
| `Ctrl+C` | 中断当前正在执行的操作 |
| `Ctrl+D` | 退出 Claude Code 会话 |
| `Ctrl+L` | 清屏 |
| `↑/↓` | 浏览历史命令 |

## 使用技巧

### 1. 引用文件和行号

直接输入文件路径和行号，Claude 会精确定位：

```
src/app.ts:42
src/models/user.ts:15-30
```

### 2. 分步提需求

复杂需求先讨论方案再执行，效果更好：

```
你：我想添加用户模块，先分析一下现有的代码结构
Claude：...分析...
你：好，先创建数据模型
Claude：...创建...
你：再添加注册 API
Claude：...实现...
```

### 3. 中英文混合

Claude Code 完全支持中文，怎么舒服怎么来：

```
分析一下 database schema，然后帮我 optimize 一下查询性能
```

### 4. 明确约束条件

避免 Claude 做出不符合预期的修改：

```
帮我重构这个函数，但不要修改它的接口签名
保持现有的错误处理风格
测试覆盖率不能低于 80%
```

## 常见问题

| 问题 | 解决方法 |
|------|---------|
| API 密钥无效 | 检查环境变量和 ~/.claude.json 配置 |
| 启动报错 | 运行 `/doctor` 诊断 |
| Claude 理解错误 | 补充上下文，重新描述需求 |
| 操作被拒绝 | 确认权限设置，或手动允许 |
| 输出被截断 | 使用 `/clear` 清空对话历史 |

## 💡 实际使用场景

### 场景一：第一次使用 Claude Code
前端新手小陈在项目目录输入 `claude`，面对空白的命令行有点茫然。他输入：
```
我第一次用 Claude Code，帮我介绍一下这个项目的情况
```
Claude 扫描了项目后回答："这是一个 React + TypeScript 项目，有 3 个主要页面、12 个组件、使用 Vite 构建。" 小陈接着尝试：
```
我想在首页加一个公告栏组件，帮我实现
```
Claude 读取了首页代码，创建了新组件，集成到了页面中，小陈第一次感受到了 AI 编程的效率。

### 场景二：快速修复紧急 Bug
周五下班前，线上反馈用户登录后页面白屏。全栈老李运行：
```
claude "紧急！用户登录后白屏，帮我排查 login 相关的代码"
```
Claude 读取了 login 流程相关文件，发现是最近重构时一个状态变量名没同步更新，Claude 自动修复并验证了测试通过。

### 场景三：学习新框架
后端小周要学习 NestJS，他把官方示例项目拉到本地，运行 claude：
```
我是一个 Express 开发者，请用 NestJS 的概念对比 Express 的方式，帮我理解这个示例项目
```
Claude 逐模块对比解释，小周对照着自己的 Express 经验，一小时就掌握了 NestJS 的核心概念。

预览

编辑内容后实时预览...