垦荒学园

简体中文

English

简体中文

English

切换主题

快速上手 ​

第一个命令 ​

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

单次命令模式 ​

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

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

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

实战演示：

bash
$ 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 服务器 ​

bash
$ 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:

javascript
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}`);
});

测试服务器：

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

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

常用操作示例 ​

1. 文件操作 ​

创建文件：

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

编辑文件：

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

重构文件：

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

2. 代码生成 ​

生成函数：

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

生成类：

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

生成测试：

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

3. 调试与修复 ​

查找 Bug：

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

修复错误：

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

性能优化：

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

4. 文档生成 ​

生成注释：

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

生成 README：

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

生成 API 文档：

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

小试牛刀项目 ​

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

项目目标 ​

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

实现步骤 ​

步骤 1：创建项目

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

步骤 2：创建主文件

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

步骤 3：测试功能

bash
# 添加任务
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：优化和改进

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

最终效果：

bash
$ 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 的效率和准确性：

✅ 好的提示词 ​

明确具体：

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

# 差
claude "创建一个 API"

提供上下文：

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

# 差
claude "添加分页"

指定技术栈：

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

# 差
claude "创建测试"

提示词模板 ​

功能开发模板：

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

Bug 修复模板：

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

重构模板：

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

小结 ​

在本章中，我们学习了：

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

关键要点：

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