Claude Code in der Praxis

Dieses Kapitel führt vom Öffnen eines Terminals bis hin zu einer vollständig laufenden Todo-REST-API, die vollständig von Claude Code + DeepSeek V4 gesteuert wird.

Claude Code + DeepSeek V4 Konfigurationsreferenz:Claude Code DeepSeek-Konfiguration

Betrachten wir zunächst die grundlegende Bedienoberfläche und die alltäglichen, häufig verwendeten Befehle von Claude Code.

Starten Sie Ihre erste Claude Code-Session

Öffne ein Terminal, wechsle in ein beliebiges Arbeitsverzeichnis (oder erstelle einen neuen leeren Ordner) und gib dann Folgendes ein:

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

Beim ersten Start siehst du den Willkommensbildschirm, Versionsinformationen und die Konfiguration der DeepSeek-Umgebungsvariablen.

Wenn du nicht sicher bist, ob die Konfiguration wirksam geworden ist, gib sofort/statusein und bestätige, dass die Base URL aufhttps://api.deepseek.com/anthropic verweist。

Kurzübersicht über gängige Slash-Befehle

Im Claude-Code-Dialogfeld sind Befehle mit/am Anfang integrierte Befehle, die nicht an das Modell gesendet werden.

BefehlZweck
/statusAktuelles Modell, Base URL, Sitzungsstatistiken anzeigen
/helpAlle verfügbaren Befehle anzeigen
/clearAktuellen Gesprächskontext löschen (Dateien werden nicht gelöscht)
/exit oder Ctrl+CClaude Code beenden
/undoDie letzte Dateiänderung rückgängig machen
/diffGit-Diff der letzten Änderung anzeigen

Mechanismus der Berechtigungsabfrage

Wenn Claude Code dabei ist, eine Datei zu schreiben oder einen Befehl auszuführen, hält es zuerst inne, listet die Vorgänge auf, die es ausführen möchte, und wartet auf deine Bestätigung.

Dies ist der wichtigste Sicherheitsmechanismus von Claude Code; Anfänger müssen sich keine Sorgen machen, dass die KI die Kontrolle verliert und willkürliche Änderungen vornimmt.

Du siehst dann eine Aufforderung wie diese:

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

Drücke einfachEnteroder gibyein, um zu bestätigen, und gibnein, um zu überspringen.


Praxisprojekt: Eine Todo-API von Grund auf mit KI erstellen

Dieser Abschnitt führt dich durch die Verwendung natürlicher Sprache, um Claude Code zu steuern und von Grund auf eine ausführbare Node.js-REST-API zu generieren.

Projektziel

Wir werden eine REST-API mit den folgenden Funktionen erstellen:

EndpunktFunktion
GET /todosAlle Todo-Einträge abrufen
POST /todosNeuen Todo-Eintrag erstellen
PUT /todos/:idTodo-Eintrag aktualisieren (als abgeschlossen markieren / Inhalt ändern)
DELETE /todos/:idTodo-Eintrag löschen

Tech-Stack:Node.js + Express, wobei Daten vorübergehend im Speicher gehalten werden (keine Datenbank erforderlich, was die Komplexität verringert).

Schritt 1: Anforderungen in natürlicher Sprache beschreiben

Geben Sie Folgendes in das Claude Code Dialogfeld ein (Sie können direkt kopieren und einfügen):

请帮我从零创建一个 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

Drei Schlüsselelemente für das Schreiben eines guten Prompts:Kontext(teilen Sie der KI den Technologie-Stack und den Projekthintergrund mit),Einschränkungen(klären Sie, was Sie nicht möchten),Erwartete Ausgabe(Geben Sie spezifische Anforderungen an die Dateistruktur oder das Format an).

Schritt 2: Claude Code generiert die Dateistruktur

Nach der Bestätigung der Berechtigungen erstellt Claude Code die folgenden Dateien in der angegebenen Reihenfolge.

Während der Generierung gibt es viele Berechtigungsaufforderungen; wählen Sie im Allgemeinen einfach Ja:

Bei Erfolg werden die folgenden Informationen ausgegeben, einschließlich generierter Inhalte, Startinformationen usw., sehr detailliert:

Werfen Sie einen Blick auf die generierte Projektstruktur:

package.json

Beispiel

{
  "name": "my-todo-api",
  "version": "1.0.0",
  "description": "Eine einfache Todo-REST-API, die mit Express erstellt wurde",
  "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 (Einstiegsdatei)

Beispiel

// Dateipfad: src/index.js
// Einstiegsdatei der Todo-API, verantwortlich für die Konfiguration und den Start der Express-App

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

const app = express();
// Port: Zuerst Umgebungsvariable PORT verwenden, Standard ist 3000
const PORT = process.env.PORT || 3000;

// Middleware: JSON-Anfragebody parsen (erforderlich, sonst ist req.body undefined)
app.use(express.json());

// Todo-Routen registrieren; alle Anfragen an /todos-Pfade werden von todosRouter behandelt
app.use('/todos', todosRouter);

// Root-Pfad: Willkommensnachricht und Versionsnummer zurückgeben
app.get('/', (req, res) => {
  res.json({ message: 'Todo-API läuft!', version: '1.0.0' });
});

// Globale Middleware zur Fehlerbehandlung (erforderlich, fängt unbehandelte Ausnahmen ab)
app.use((err, req, res, next) => {
  console.error(err.stack);
  res.status(500).json({ error: 'Interner Serverfehler' });
});

// HTTP-Server starten
app.listen(PORT, () => {
  console.log(`Server läuft auf http://localhost:${PORT}`);
});

src/routes/todos.js (zentrale Routendatei)

Beispiel

// Dateipfad: src/routes/todos.js
// Todo-Routenmodul, enthält vollständige CRUD-Geschäftslogik

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

// In-Memory-Speicher: Verwende ein Array, um die Datenbank zu simulieren
// Daten gehen nach einem Dienstneustart verloren; später kann dies durch SQLite oder andere Persistenzlösungen ersetzt werden
let todos = [];
// Automatisch hochzählender ID-Zähler
let nextId = 1;

// GET /todos — alle Todo-Elemente abrufen
router.get('/', (req, res) => {
  res.json(todos);
});

// POST /todos — ein neues Todo-Element erstellen
router.post('/', (req, res) => {
  const { title } = req.body;

  // Parametervalidierung: title ist ein Pflichtfeld, sein Typ muss eine Zeichenkette sein und darf nicht leer sein
  if (!title || typeof title !== 'string' || title.trim() === '') {
    return res.status(400).json({ error: 'Das Feld title darf nicht leer sein' });
  }

  // Ein neues Todo-Objekt erstellen
  const newTodo = {
    id: nextId++,                         // Automatisch hochzählende ID
    title: title.trim(),                   // Führende und nachfolgende Leerzeichen entfernen
    completed: false,                      // Neu erstelltes Todo ist standardmäßig nicht abgeschlossen
    createdAt: new Date().toISOString(),   // Zeitstempel im ISO-8601-Format
  };

  todos.push(newTodo);
  // 201 Created bedeutet, dass die Ressource erfolgreich erstellt wurde
  res.status(201).json(newTodo);
});

// PUT /todos/:id — ein Todo-Element aktualisieren
router.put('/:id', (req, res) => {
  // Pfadparameter von String in Zahl umwandeln
  const id = parseInt(req.params.id);
  const todo = todos.find(t => t.id === id);

  // 404: Ressource nicht gefunden
  if (!todo) {
    return res.status(404).json({ error:`Todo mit id ${id}nicht gefunden`});
  }

  const { title, completed } = req.body;
  // Nur übergebene Felder aktualisieren; nicht übergebene Felder behalten ihre ursprünglichen Werte
  if (title !== undefined) todo.title = title.trim();
  // Boolean() stellt sicher, dass completed immer vom Typ boolean ist
  if (completed !== undefined) todo.completed = Boolean(completed);

  res.json(todo);
});

// DELETE /todos/:id — ein To-do-Element löschen
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:`Todo mit id ${id}nicht gefunden`});
  }

  // Das Element an der angegebenen Position aus dem Array entfernen
  todos.splice(index, 1);
  // 204 No Content bedeutet, dass das Löschen erfolgreich war; der Response-Body ist leer
  res.status(204).send();
});

module.exports = router;

Schritt 3: Änderungen prüfen und bestätigen

Nachdem Claude Code den Code generiert hat, solltest du ihn nicht voreilig direkt ausführen; entwickle die Angewohnheit, ihn zu überprüfen.

Du kannst im Gespräch weiterhin Rückfragen stellen:

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

Claude Code beantwortet jede einzelne und kann den Code direkt korrigieren.

Dieser Zyklus aus "Generieren → Nachfragen → Korrigieren" ist der zentrale Rhythmus der Zusammenarbeit mit KI.

Schritt 4: Abhängigkeiten installieren und den Dienst starten

Gib Folgendes in den Dialog von Claude Code ein:

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

Claude Code wird die folgenden Operationen ausführen (bei jedem Schritt wird deine Bestätigung angefordert).

Abhängigkeiten installieren

$ npm install

Beispielausgabe:

added 64 packages in 2.3s

Dienst starten

$ npm start

Ausgabe:

Server is running on http://localhost:3000

Testbefehle

Öffne ein neues Terminalfenster und führe die folgenden curl-Befehle nacheinander aus:

# 创建第一条 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

Erwartete Ausgabe (Endergebnis von GET /todos)

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

Herzlichen Glückwunsch, Ihre erste KI-gestützte API läuft.

Fortgeschrittene Herausforderung: Lassen Sie Claude Code neue Funktionen für Sie hinzufügen

Sobald die API läuft, versuchen Sie, mithilfe natürlicher Sprache Claude Code dazu zu bringen, seine Funktionalität zu erweitern:

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

Beobachten Sie, wie Claude Code die vorhandene Codestruktur versteht und neue Logik präzise an der richtigen Stelle einfügt, anstatt die gesamte Datei neu zu schreiben.

Genau hier übertrifft es gewöhnliche Codegenerierungswerkzeuge.


CLAUDE.md: Projektgedächtnisdatei

CLAUDE.md ist die Projektgedächtnisdatei von Claude Code, die es der KI ermöglicht, bei jedem Start automatisch die Projektkonventionen zu verstehen.

Warum benötigen Sie es?

Claude Code startet jedes Mal von vorn — es erinnert sich nicht daran, was in vorherigen Sitzungen gesagt wurde.

Aber wenn das Projektstammverzeichnis eineCLAUDE.md-Datei enthält, liest Claude Code sie bei jedem Start automatisch, was effektiv als "Projekthandbuch" für die KI dient.

Schmerzpunkte ohne CLAUDE.md:

  • Jedes Mal erneut erklären zu müssen: "Wir verwenden Express, nicht Koa"
  • Die KI vergisst deine Namenskonventionen und generiert erneut camelCase-Dateien
  • Teammitglieder nennen der KI jeweils unterschiedliche Konventionen, was zu einem chaotischen Code-Stil führt

CLAUDE.md-Vorlage

Erstelle im Projekt-StammverzeichnisCLAUDE.mdund orientiere dich für den Inhalt an der folgenden Vorlage:

# 项目说明(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 示例

Lasse Claude Code CLAUDE.md automatisch generieren

Du möchtest es nicht von Hand schreiben? Lass es einfach von der KI für dich generieren:

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

Claude Code analysiert alle generierten Dateien und erstellt automatisch eine für dieses Projekt geeignete CLAUDE.md.

Wartungsrhythmus für CLAUDE.md

WannWas zu tun ist
Einführung neuer AbhängigkeitenAktualisiere den Abschnitt "Tech Stack"
Ändern der DateistrukturAktualisieren Sie den Abschnitt "Verzeichnisstruktur"
Neue Coding-Konventionen festlegenAn "Wichtige Konventionen" anhängen
Bemerken, dass die KI wiederholt denselben Fehler machtZu "Verbotene Elemente" hinzufügen

Committen Sie CLAUDE.md in Git, damit alle Teammitglieder und die KI denselben Satz von Konventionen verwenden.

Dies ist die Infrastruktur für KI-gestützte Teamzusammenarbeit.


Kapitelzusammenfassung

Was Sie gelernt habenEntsprechender Inhalt
Starten Sie Claude Code und bestätigen Sie die DeepSeek-KonfigurationEine Sitzung starten und /status
Anforderungen mit dem Drei-Elemente-Prompt beschreibenSchritt 1: Beschreibung in natürlicher Sprache
KI-generierten Code überprüfenSchritt 3: Überprüfen und hinterfragen
Abhängigkeiten installieren, den Server starten und die API mit curl testenSchritt 4: Ausführen und testen
Projektgedächtnis mit CLAUDE.md verwaltenCLAUDE.md-Konfiguration
Weitere Erweiterungen