Claude Code на практике

В этой главе мы пройдём путь от открытия терминала до запуска полноценного Todo REST API, полностью управляемого Claude Code + DeepSeek V4.

Справочник по конфигурации Claude Code + DeepSeek V4:Конфигурация Claude Code DeepSeek

Сначала рассмотрим базовый интерфейс работы и повседневные часто используемые команды Claude Code.

Запустите свою первую сессию Claude Code

Откройте терминал, перейдите в любую рабочую директорию (или создайте новую пустую папку), затем введите:

$ mkdir example-todo-api
$ cd example-todo-api
$ claude

При первом запуске вы увидите приветственный экран, информацию о версии и конфигурацию переменных окружения DeepSeek.

Если вы не уверены, применилась ли конфигурация, сразу введите/statusи убедитесь, что Base URL указывает наhttps://api.deepseek.com/anthropic。

Краткая справка по основным слэш-командам

В диалоговом окне Claude Code команды, начинающиеся с/, являются встроенными и не отправляются модели.

КомандаНазначение
/statusПросмотреть текущую модель, Base URL, статистику сессии
/helpПоказать все доступные команды
/clearОчистить текущий контекст разговора (файлы не удаляются)
/exit или Ctrl+CВыйти из Claude Code
/undoОтменить последнее изменение файла
/diffПросмотреть git diff последнего изменения

Механизм запроса разрешения

Когда Claude Code собирается записать файл или выполнить команду, он сначала приостанавливается, перечисляет операции, которые намерен выполнить, и ждёт вашего подтверждения.

Это самый важный механизм безопасности Claude Code; новичкам не нужно беспокоиться о том, что ИИ выйдет из-под контроля и начнёт вносить произвольные изменения.

Вы увидите такое приглашение:

┌─────────────────────────────────────────────────┐
│  Claude wants to create the following files:     │
│                                                  │
│  • src/index.js                                  │
│  • src/routes/todos.js                           │
│  • package.json                                  │
│                                                  │
│  Allow? [Y/n]                                    │
└─────────────────────────────────────────────────┘

Просто нажмитеEnterили введитеyчтобы подтвердить, и введитеnчтобы пропустить.


Практический проект: создайте Todo API с нуля с помощью ИИ

Этот раздел поможет вам использовать естественный язык для управления Claude Code и создания рабочего Node.js REST API с нуля.

Цель проекта

Мы собираемся создать REST API со следующими функциями:

Конечная точкаФункция
GET /todosПолучить все элементы todo
POST /todosСоздать новый элемент todo
PUT /todos/:idОбновить элемент todo (отметить как выполненный / изменить содержимое)
DELETE /todos/:idУдалить элемент todo

Технологический стек:Node.js + Express, при этом данные временно хранятся в памяти (база данных не требуется, что снижает сложность).

Шаг 1: Опишите требования на естественном языке

Введите следующее в диалоговом окне Claude Code (можно скопировать и вставить напрямую):

请帮我从零创建一个 Node.js + Express 的 Todo REST API 项目。

要求:
- 支持 GET /todos、POST /todos、PUT /todos/:id、DELETE /todos/:id 四个接口
- 数据先存在内存数组里,不需要数据库
- 每个 todo 包含:id、title、completed(布尔值)、createdAt 字段
- 请求和响应都使用 JSON 格式
- 加上基础的错误处理(404、400 等)
- 生成一份 README.md,说明如何启动和测试接口

项目结构建议:
my-todo-api/
├── src/
│   ├── index.js       # 入口文件
│   └── routes/
│       └── todos.js   # Todo 路由
├── package.json
└── README.md

Три ключевых элемента для написания хорошего промпта:Контекст(сообщите ИИ технологический стек и контекст проекта),Ограничения(уточните, чего вы не хотите),Ожидаемый результат(Укажите конкретные требования к структуре файлов или формату).

Шаг 2: Claude Code создаёт структуру файлов

После подтверждения разрешений Claude Code создаст следующие файлы по порядку.

Во время генерации появляется много запросов на разрешения; обычно просто выберите «Да»:

После успешного завершения будет выведена следующая информация, включая сгенерированное содержимое, информацию о запуске и т. д., очень подробно:

Взгляните на сгенерированную структуру проекта:

package.json

Пример

{
  "name": "my-todo-api",
  "version": "1.0.0",
  "description": "Простой Todo REST API, созданный с помощью Express",
  "main": "src/index.js",
  "scripts": {
    "start": "node src/index.js",
    "dev": "nodemon src/index.js"
  },
  "dependencies": {
    "express": "^4.18.2"
  },
  "devDependencies": {
    "nodemon": "^3.0.1"
  }
}

src/index.js (входной файл)

Пример

// Путь к файлу: src/index.js
// Входной файл Todo API, отвечающий за конфигурацию и запуск приложения Express

const express = require('express');
const todosRouter = require('./routes/todos');

const app = express();
// Порт: сначала используйте переменную окружения PORT, по умолчанию 3000
const PORT = process.env.PORT || 3000;

// Промежуточное ПО: разобрать тело JSON-запроса (обязательно, иначе req.body не определён)
app.use(express.json());

// Регистрация маршрутов Todo; все запросы к путям /todos обрабатываются todosRouter
app.use('/todos', todosRouter);

// Корневой путь: вернуть приветственное сообщение и номер версии
app.get('/', (req, res) => {
  res.json({ message: 'Todo API работает!', version: '1.0.0' });
});

// Глобальное промежуточное ПО обработки ошибок (обязательно, перехватывает необработанные исключения)
app.use((err, req, res, next) => {
  console.error(err.stack);
  res.status(500).json({ error: 'Внутренняя ошибка сервера' });
});

// Запуск HTTP-сервера
app.listen(PORT, () => {
  console.log(`Сервер работает на http://localhost:${PORT}`);
});

src/routes/todos.js (основной файл маршрутов)

Пример

// Путь к файлу: src/routes/todos.js
// Модуль маршрутов Todo, содержит полную бизнес-логику CRUD

const express = require('express');
const router = express.Router();

// Хранилище в памяти: используйте массив для имитации базы данных
// Данные теряются после перезапуска сервиса; позже можно заменить на SQLite или другие решения для постоянного хранения
let todos = [];
// Счетчик ID с автоинкрементом
let nextId = 1;

// GET /todos — получить все элементы todo
router.get('/', (req, res) => {
  res.json(todos);
});

// POST /todos — создать новый элемент todo
router.post('/', (req, res) => {
  const { title } = req.body;

  // Проверка параметров: title — обязательное поле, его тип должен быть string и не пустым
  if (!title || typeof title !== 'string' || title.trim() === '') {
    return res.status(400).json({ error: 'поле title не может быть пустым' });
  }

  // Создать новый объект todo
  const newTodo = {
    id: nextId++,                         // Автоинкрементный ID
    title: title.trim(),                   // Удалить пробелы в начале и конце
    completed: false,                      // Новый todo по умолчанию не выполнен
    createdAt: new Date().toISOString(),   // Метка времени в формате ISO 8601
  };

  todos.push(newTodo);
  // 201 Created означает, что ресурс успешно создан
  res.status(201).json(newTodo);
});

// PUT /todos/:id — обновить элемент todo
router.put('/:id', (req, res) => {
  // Преобразовать параметр пути из строки в число
  const id = parseInt(req.params.id);
  const todo = todos.find(t => t.id === id);

  // 404: Ресурс не найден
  if (!todo) {
    return res.status(404).json({ error:`Задача с id ${id}не найдена`});
  }

  const { title, completed } = req.body;
  // Обновлять только переданные поля; поля, которые не переданы, сохраняют свои исходные значения
  if (title !== undefined) todo.title = title.trim();
  // Boolean() гарантирует, что completed всегда имеет логический тип
  if (completed !== undefined) todo.completed = Boolean(completed);

  res.json(todo);
});

// DELETE /todos/:id — удалить элемент todo
router.delete('/:id', (req, res) => {
  const id = parseInt(req.params.id);
  const index = todos.findIndex(t => t.id === id);

  if (index === -1) {
    return res.status(404).json({ error:`Задача с id ${id}не найдена`});
  }

  // Удалить элемент в указанной позиции из массива
  todos.splice(index, 1);
  // 204 No Content означает, что удаление выполнено успешно, тело ответа пусто
  res.status(204).send();
});

module.exports = router;

Шаг 3: Просмотрите и подтвердите изменения

После того как Claude Code сгенерирует код, не спешите сразу его запускать; выработайте привычку проверять его.

Вы можете продолжать задавать уточняющие вопросы в диалоге:

你帮我生成的代码我看了一下,有几个问题想确认:
1. POST /todos 时,如果 title 是数字类型会怎么处理?
2. PUT 接口能同时更新 title 和 completed 吗?
3. 有没有对 id 不是数字的情况做处理?

Claude Code ответит на каждый из них и сможет сразу исправить код.

Этот цикл «сгенерировать → задать вопрос → исправить» — основной ритм совместной работы с ИИ.

Шаг 4: Установите зависимости и запустите сервис

Введите следующее в диалоговом окне Claude Code:

请帮我安装依赖并启动项目,然后告诉我怎么用 curl 测试每个接口

Claude Code выполнит следующие операции (на каждом шаге он запросит у вас подтверждение).

Установите зависимости

$ npm install

Пример вывода:

added 64 packages in 2.3s

Запустите сервис

$ npm start

Вывод:

Server is running on http://localhost:3000

Команды для проверки

Откройте новое окно терминала и последовательно выполните следующие команды curl:

# 创建第一条 Todo
$ curl -X POST http://localhost:3000/todos \
  -H "Content-Type: application/json" \
  -d '{"title": "学习 Claude Code"}'

# 创建第二条 Todo
$ curl -X POST http://localhost:3000/todos \
  -H "Content-Type: application/json" \
  -d '{"title": "完成 DeepSeek 配置"}'

# 获取所有 Todos
$ curl http://localhost:3000/todos

# 把第一条标记为完成
$ curl -X PUT http://localhost:3000/todos/1 \
  -H "Content-Type: application/json" \
  -d '{"completed": true}'

# 删除第二条
$ curl -X DELETE http://localhost:3000/todos/2

# 再次查看列表,确认删除成功
$ curl http://localhost:3000/todos

Ожидаемый вывод (итоговый результат GET /todos)

[
  {
    "id": 1,
    "title": "学习 Claude Code",
    "completed": true,
    "createdAt": "2026-05-20T10:30:00.000Z"
  }
]

Поздравляем, ваш первый API, созданный с помощью ИИ, запущен и работает.

Продвинутая задача: попросите Claude Code добавить для вас новые функции

Когда API запущен, попробуйте с помощью естественного языка попросить Claude Code расширить его функциональность:

请给 Todo API 加上以下功能:
1. GET /todos 支持 ?completed=true/false 的查询参数过滤
2. GET /todos 支持 ?sort=createdAt&order=desc 的排序参数
3. 同时更新 README.md 里的接口文档

Обратите внимание, как Claude Code понимает существующую структуру кода и точно вставляет новую логику в нужное место, а не переписывает весь файл.

Именно здесь он превосходит обычные инструменты генерации кода.


CLAUDE.md: файл памяти проекта

CLAUDE.md — это файл памяти проекта Claude Code, позволяющий ИИ автоматически понимать соглашения проекта при каждом запуске.

Зачем он нужен?

Claude Code каждый раз начинает с чистого листа — он не помнит, что говорилось в предыдущих сессиях.

Но если в корне проекта находится файлCLAUDE.md, Claude Code будет автоматически читать его при каждом запуске, фактически служа «руководством по проекту» для ИИ.

Проблемы без CLAUDE.md:

  • Приходится каждый раз объяснять заново: «Мы используем Express, а не Koa»
  • ИИ забывает ваши соглашения об именовании и снова создаёт файлы в camelCase
  • Каждый член команды сообщает ИИ разные соглашения, что приводит к хаотичному стилю кода

Шаблон CLAUDE.md

Создайте в корневом каталоге проектаCLAUDE.md, и для его содержимого используйте следующий шаблон:

# 项目说明(CLAUDE.md)

## 项目概述
这是一个 Node.js + Express 的 Todo REST API 项目。
当前阶段:数据存在内存中,下一步会迁移到 SQLite。

## 技术栈
- 运行时:Node.js 18+
- 框架:Express 4.x
- 测试:(暂无,后续加 Jest)
- 代码风格:ESLint + Prettier(配置见 .eslintrc)

## 目录结构
src/
├── index.js        # 入口,只做 app 配置和监听
└── routes/
    └── todos.js    # Todo 业务逻辑全在这里

## 命名规范
- 文件名:kebab-case(如 todo-service.js)
- 变量/函数:camelCase
- 常量:UPPER_SNAKE_CASE
- 路由文件按资源名命名(如 users.js、products.js)

## 重要约定
- 所有接口返回 JSON,错误统一格式:{ "error": "错误描述" }
- HTTP 状态码语义要准确:创建成功用 201,删除成功用 204
- 禁止在路由文件里直接操作数据库(现在是内存数组,将来是 DB)
- 每个路由文件只处理一种资源

## 禁止事项
- 不要用 var,只用 const/let
- 不要用回调风格,统一用 async/await
- 不要在代码里写中文注释(英文注释即可)
- 不要安装 lodash,原生 JS 方法够用

## 启动方式
npm start          # 生产模式
npm run dev        # 开发模式(nodemon 热重载)

## 测试接口
见 README.md 的 curl 示例

Позвольте Claude Code автоматически сгенерировать CLAUDE.md

Не хотите писать это вручную? Просто позвольте ИИ сгенерировать это за вас:

请根据当前项目的代码结构和我们的对话记录,
帮我生成一份 CLAUDE.md 文件,
内容包括项目概述、技术栈、目录结构、命名规范和重要约定。

Claude Code проанализирует все сгенерированные файлы и автоматически составит CLAUDE.md, подходящий для этого проекта.

Периодичность сопровождения CLAUDE.md

КогдаЧто сделать
При добавлении новых зависимостейОбновите раздел «Tech Stack»
Изменение структуры файловОбновите раздел «Структура каталогов»
Установление новых соглашений по кодированиюДобавьте в раздел «Важные соглашения»
Обнаружение того, что ИИ повторяет одну и ту же ошибкуДобавьте в раздел «Запрещённые пункты»

Закоммитьте CLAUDE.md в Git, чтобы все члены команды и ИИ использовали один и тот же набор соглашений.

Это инфраструктура для командной работы с поддержкой ИИ.


Итоги главы

Что вы узналиСоответствующее содержимое
Запустите Claude Code и подтвердите конфигурацию DeepSeekЗапуск сеанса и /status
Описание требований с помощью промпта из трёх элементовШаг 1: описание на естественном языке
Проверка кода, сгенерированного ИИШаг 3: проверка и вопросы
Установка зависимостей, запуск сервера и тестирование API с помощью curlШаг 4: запуск и тестирование
Управление памятью проекта с помощью CLAUDE.mdКонфигурация CLAUDE.md
Другие расширения