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 (входной файл)
Пример
// Входной файл 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 (основной файл маршрутов)
Пример
// Модуль маршрутов 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 |