快速上手

第一个命令

让我们从最简单的命令开始，体验 Claude Code 的强大功能。

单次命令模式

# 基本语法
claude "你的任务描述"

# 示例 1：简单的问候
claude "Hello! How do you work?"

# 示例 2：获取帮助
claude "列出当前目录的文件"

实战演示：

$ claude "创建一个 hello.js 文件，输出 Hello World"

I'll create a hello.js file that outputs "Hello World".

✓ Creating hello.js...

File created at: /home/user/hello.js

```javascript

console.log('Hello World');

Task completed successfully!


#### 验证结果

```bash
$ ls -l hello.js
-rw-r--r-- 1 user user 28 Jan 21 10:00 hello.js

$ node hello.js
Hello World

基本工作流程

Claude Code 的典型工作流程：

1. 描述任务 → 2. Claude 分析 → 3. 规划执行 → 4. 完成任务 → 5. 验证结果

完整示例：创建一个 Web 服务器

$ claude "创建一个简单的 Express.js Web 服务器，监听 3000 端口，返回 JSON 响应"

Claude Code 的执行过程：

📋 Task: Create Express.js web server

[1/5] 📖 Reading project structure...
  ✓ No package.json found - will create new project

[2/5] 🔍 Checking if Express is installed...
  ⚠ Express not found

[3/5] 📦 Installing Express...
  $ npm init -y
  $ npm install express
  ✓ Express installed successfully

[4/5] ✍️  Creating server.js...
  ✓ File created: server.js

[5/5] ✅ Verification...
  ✓ Syntax check passed
  ✓ Dependencies resolved

Task completed! Run: node server.js

生成的 server.js:

const express = require('express');
const app = express();
const PORT = 3000;

app.get('/', (req, res) => {
  res.json({
    message: 'Hello World',
    timestamp: new Date().toISOString()
  });
});

app.listen(PORT, () => {
  console.log(`Server running on http://localhost:${PORT}`);
});

测试服务器：

$ node server.js
Server running on http://localhost:3000

# 在另一个终端测试
$ curl http://localhost:3000
{"message":"Hello World","timestamp":"2026-01-21T10:30:00.000Z"}

常用操作示例

1. 文件操作

创建文件：

claude "创建一个 README.md 文件，包含项目说明"

编辑文件：

claude "在 README.md 中添加安装说明部分"

重构文件：

claude "重构 app.js，使用 ES6 模块语法"

2. 代码生成

生成函数：

claude "创建一个函数计算斐波那契数列"

生成类：

claude "创建一个 User 类，包含 name、email 和验证方法"

生成测试：

claude "为 utils.js 中的函数生成单元测试"

3. 调试与修复

查找 Bug：

claude "检查 src/api.js 中的错误"

修复错误：

claude "修复登录功能中的验证问题"

性能优化：

claude "优化数据库查询性能"

4. 文档生成

生成注释：

claude "为 src/utils.js 中的函数添加 JSDoc 注释"

生成 README：

claude "生成项目的 README.md 文档"

生成 API 文档：

claude "为 API 路由生成 OpenAPI 文档"

小试牛刀项目

让我们通过一个完整的小项目来实践所学内容：创建一个 Todo CLI 应用

项目目标

命令行 Todo 列表管理工具
支持添加、删除、列表、完成任务
数据持久化到 JSON 文件

实现步骤

步骤 1：创建项目

mkdir todo-cli
cd todo-cli
claude "初始化一个 Node.js 项目，创建 package.json"

步骤 2：创建主文件

claude "创建 todo.js，实现以下功能：
1. 添加任务：add <task>
2. 列出任务：list
3. 完成任务：done <id>
4. 删除任务：delete <id>
使用 commander.js 处理命令行参数，数据存储到 todos.json"

步骤 3：测试功能

# 添加任务
node todo.js add "学习 Claude Code"
node todo.js add "创建第一个项目"

# 列出任务
node todo.js list

# 完成任务
node todo.js done 1

# 删除任务
node todo.js delete 2

步骤 4：优化和改进

claude "添加以下改进：
1. 彩色输出（使用 chalk）
2. 任务优先级
3. 截止日期
4. 导出为 CSV"

最终效果：

$ node todo.js list

📋 Todo List
━━━━━━━━━━━━━━━━━━━━━━
✅ 1. 学习 Claude Code [HIGH] 📅 2026-01-25
⬜ 2. 创建第一个项目 [MEDIUM]
⬜ 3. 编写测试用例 [LOW] 📅 2026-01-30
━━━━━━━━━━━━━━━━━━━━━━
Total: 3 tasks (1 completed)

提示词技巧

写好提示词能显著提高 Claude Code 的效率和准确性：

✅ 好的提示词

明确具体：

# 好
claude "创建一个 Express.js API，包含 GET /users 和 POST /users 端点，使用 MongoDB 存储"

# 差
claude "创建一个 API"

提供上下文：

# 好
claude "在现有的 React 项目中，为 UserList 组件添加分页功能，每页 10 条"

# 差
claude "添加分页"

指定技术栈：

# 好
claude "使用 TypeScript 和 Jest 为 auth.ts 创建单元测试"

# 差
claude "创建测试"

提示词模板

功能开发模板：

"在 [文件/目录] 中实现 [功能描述]，
要求：
1. [具体要求1]
2. [具体要求2]
3. [具体要求3]
使用 [技术栈/框架]"

Bug 修复模板：

"修复 [文件] 中的 [问题描述]，
症状：[具体表现]
期望行为：[预期结果]"

重构模板：

"重构 [文件/模块]，
目标：[重构目标]
保持：[需要保留的功能]
优化：[需要改进的方面]"

小结

在本章中，我们学习了：

✅ 如何执行第一个 Claude Code 命令
✅ 理解基本工作流程
✅ 掌握常用操作（文件、代码、调试、文档）
✅ 完成一个完整的 Todo CLI 项目
✅ 编写高效提示词的技巧

关键要点：

提示词要明确具体
提供足够的上下文信息
指定技术栈和框架
验证执行结果

#快速上手

#第一个命令

#单次命令模式

#基本工作流程

#完整示例：创建一个 Web 服务器

#常用操作示例

#1. 文件操作

#2. 代码生成

#3. 调试与修复

#4. 文档生成

#小试牛刀项目

#项目目标

#实现步骤

#提示词技巧

#✅ 好的提示词

#提示词模板

#小结