Claude Code Grundlegende Verwendung

Dieses Kapitel stellt die Kernfunktionen vor, die in der täglichen Entwicklung mit Claude Code am häufigsten verwendet werden, einschließlich der Frage, wie man mit Claude kommuniziert, Code liest und ändert, Befehle ausführt, Dateien verarbeitet und einige praktische Tipps, die die Effizienz erheblich steigern können.

Grundlegende Gesprächsmethoden

1. Interaktiver Modus (am häufigsten verwendet)

Starten Sie Claude Code im Projektverzeichnis, und sobald Sie in den interaktiven Modus wechseln, können Sie direkt Fragen oder Anweisungen eingeben:

cd /path/to/your/project
claude

Geben Sie im interaktiven Modus einfach direkt natürliche Sprache ein – keine spezielle Formatierung ist erforderlich:

What does this project do?

帮我找出 src/auth.ts 里的 bug

给 UserService 添加一个 getUserById 方法

use@Sie können auch Dateien angeben. Zum Beispiel haben wir eine test.html im Verzeichnis claude-test.

Wir können claude-test eingeben:

cd claude-test

Dann fragen Sie:

@test.html 这个文件是干嘛的

2. Einmaliger Aufgabenmodus

Wenn Sie nur eine einzelne Aufgabe ausführen müssen und nicht in den interaktiven Modus wechseln möchten, können Sie die Aufgabenbeschreibung direkt nach dem Befehl anhängen:

claude "解释一下 package.json 里的 scripts 字段"

Es wird nach der Ausführung automatisch beendet, was es für die Verwendung in Shell-Skripten oder für schnelle Abfragen geeignet macht.

3. Einzelabfrage-Modus (-p)

Verwenden Sie die-pParameter, um eine einmalige Abfrage auszuführen. Claudes Antwort wird direkt an das Terminal ausgegeben, was es für die Kombination mit anderen Befehlen geeignet macht:

claude -p "这段代码有什么问题" < src/utils.ts

# 将 Claude 的分析结果保存到文件
claude -p "分析项目依赖的安全风险" > security-report.md

4. Vorherige Konversation fortsetzen (-c)

Claude Code speichert den Gesprächsverlauf. Verwenden Sie den-cParameter, um die zuletzt unvollendete Konversation im aktuellen Verzeichnis fortzusetzen, ohne den Kontext neu aufbauen zu müssen:

claude -c

Code verstehen und analysieren

1. Die Gesamtsituation des Projekts verstehen

Wenn Sie zum ersten Mal ein unbekanntes Projekt betreten, können Sie Claude bitten, eine Gesamtanalyse durchzuführen:

What is the architecture of this project?

What main technologies and dependencies does the project use?

Please introduce the project's directory structure.

Claude Code liest automatisch Projektdateien zur Analyse.Sie müssen nicht manuell angeben, welche Dateien gelesen werden sollen.Es entscheidet selbst, welche Inhalte untersucht werden müssen.

2. Eine bestimmte Datei oder ein Modul analysieren

解释一下 src/middleware/auth.ts 的工作原理

UserRepository 类里有哪些方法？分别是做什么的？

这个 SQL 查询语句是什么意思？

3. Code-Aufrufketten nachverfolgen

When a user logs in, what is the code execution flow? List everything from the entry point to the database.

findUserByEmail 这个函数在哪里被调用？

Which database table does the data from this interface ultimately end up in?

4. Komplexe Logik verstehen

What does this recursive function mean? Can you give an example to illustrate?

为什么这里要用 useCallback？不用会怎样？

What format of strings can this regular expression match?

Code ändern

1. Eine neue Funktion hinzufügen

Beschreiben Sie die Funktion, die Sie benötigen, und Claude findet die richtige Stelle und implementiert sie:

在 UserService 里添加一个 updatePassword 方法，需要验证旧密码

给登录接口添加请求频率限制，同一 IP 每分钟最多 5 次

创建一个 formatCurrency 工具函数，支持传入货币代码参数

2. Einen Fehler beheben

Beschreiben Sie die Problemsymptome, und Claude lokalisiert die Ursache und bietet eine Lösung an:

After the user logs out, refreshing the page still shows the logged-in state. Help me find the cause and fix it.

This function errors when the input is an empty array. Fix it.

控制台报错 "Cannot read properties of undefined (reading 'map')"，帮我定位并修复

3. Code refaktorisieren

把这个 500 行的组件拆分成更小的子组件

将 callback 风格的异步代码改为 async/await

These functions contain a lot of duplicate code. Help me extract it into a common utility function.

4. Änderungen überprüfen

Claude Code zeigt vor jeder Dateiänderung den Diff zur Überprüfung an. Du kannst diskutieren, nachdem Claude Änderungen vorgeschlagen hat:

Don't change the code yet. Just tell me how you plan to modify it.

There's a problem with your previous modification: it doesn't handle concurrency. Start over.

这个方案可以，但把函数名改成 validateUserCredentials

Claude Code zeigt die Änderungen an und fragt vor jeglichen Dateiänderungen nach deiner Bestätigung. Du kannstAkzeptieren (ja)、Ablehnen (nein)wählen oder weiter diskutieren, bevor du bestätigst. Du musst nicht alle Änderungen auf einmal akzeptieren – schau sie dir zuerst an und bestätige erst, wenn du zufrieden bist.

Ausführen von Befehlen und Tests

1. Claude Befehle ausführen lassen

Claude Code kann Befehle direkt im Terminal ausführen. Du kannst in natürlicher Sprache beschreiben, was du tun möchtest:

Run the tests and see if any fail.

安装 dayjs 这个依赖

Build the project and see if there are any errors.

Claude wird, basierend auf der Projektkonfiguration (wie zum Beispielpackage.jsondie Skripte in, oderCLAUDE.mddie Befehle in) den richtigen Befehl zum Ausführen auswählen.

2. Bestimmte Tests ausführen

运行 auth 模块的测试

Run all tests and generate a coverage report.

Why did this test fail? Help me fix it.

3. Befehlsausgabe anzeigen

Claude behandelt die Befehlsausgabe als Kontext und schlägt basierend auf der Ausgabe direkt nächste Schritte vor:

运行 npm run build，如果有报错帮我修复

跑一下 lint，把所有警告都修复掉

Dateioperationen

1. Neue Dateien erstellen

创建 src/utils/date.ts，实现日期格式化相关的工具函数

新建一个 Docker Compose 配置文件，包含 PostgreSQL 和 Redis 服务

创建 .github/workflows/ci.yml，配置 GitHub Actions 自动运行测试

2. Dateien und Inhalte finden

Is there any code in the project that handles file uploads? Where is it?

哪些地方用到了 localStorage？

找出所有使用了 console.log 的文件

3. Batch-Änderungen

把所有文件里的 http://api.example.com 替换成 https://api.example.com

把 src/components/ 下所有组件的 PropTypes 改为 TypeScript 类型定义

给 src/api/ 目录下所有接口函数添加 JSDoc 注释

Git-Operationen

Claude Code verfügt über eine tiefe Git-Integration, mit der Sie fast alle Git-Operationen in natürlicher Sprache ausführen können.

1. Änderungen anzeigen

Which files did I change?

What does this change include?

最近 10 次提交都改了什么？

2. Code committen

Commit this change.

把这次的修改提交，commit 信息说明修复了登录验证的 bug

Claude generiert automatisch eine passende Commit-Nachricht basierend auf den tatsächlichen Änderungen. Sie können auch einen Schnellbefehl verwenden:

claude commit

3. Branch-Verwaltung

新建一个 feature/user-profile 分支

切换到 develop 分支

把 main 分支的最新改动合并进来

4. Merge-Konflikte lösen

Help me resolve the merge conflict.

This file has conflicts. Help me check which version is correct.

Tipps zur Kontextverwaltung

1. Dateien manuell angeben

Verwenden Sie@file pathSyntax, um Claude explizit mitzuteilen, auf welche Datei verwiesen werden soll, und um Raten zu vermeiden:

参考 @src/types/user.ts 里的类型定义，给 UserService 添加类型注解

对照 @docs/api-spec.md 里的规范，检查接口实现是否符合要求

2. Kontext leeren

Wenn die Unterhaltung schon lange läuft oder du zu einer völlig anderen Aufgabe gewechselt hast, empfiehlt es sich, den Kontext zu leeren und neu zu beginnen:

/clear

Nach dem Leeren kehrt Claudes "Gedächtnis" in seinen Anfangszustand zurück, und die neue Sitzung wird nicht durch vorherige Gesprächsinhalte beeinflusst.

3. Kontext komprimieren

Wenn Claude frühere Inhalte zu "vergessen" beginnt oder die Unterhaltung sehr lang wird, kannst du den Kontext komprimieren:

/compact

Dies veranlasst Claude, die aktuelle Unterhaltung zu einer kompakten Zusammenfassung zu verdichten, wodurch Kontextspeicher freigegeben wird, während wichtige Informationen für die weitere Arbeit erhalten bleiben.

4. Aufgaben sinnvoll aufteilen

Beschreibe eine komplexe Aufgabe nicht auf einmal; es funktioniert besser, sie in mehrere Schritte aufzuteilen und diese nacheinander abzuarbeiten:

❌ Schlechte Praxis: zu viele Anforderungen auf einmal an Claude stellen:

Help me refactor the entire user module, including adding type annotations, splitting files, optimizing database queries, adding caching, writing tests, and updating documentation.

✅ Gute Praxis: in logischer Reihenfolge in unabhängige Schritte aufteilen:

第一步："分析 src/user/ 目录的现有结构，告诉我有哪些问题"
第二步："先给所有函数添加 TypeScript 类型注解"
第三步："把超过 200 行的文件拆分成更小的模块"
第四步："优化数据库查询，添加必要的索引"

Gängige Slash-Befehle

Tippe im interaktiven Modus/um eine Liste aller verfügbaren Befehle aufzurufen. Hier sind die am häufigsten verwendeten Slash-Befehle:

Praktische Tipps

1. Claude zuerst analysieren lassen, dann handeln

Bei komplexen Problemen bitten Sie Claude, zuerst seinen Ansatz zu erklären, und fahren Sie erst fort, nachdem Sie bestätigt haben, dass die Richtung stimmt.

Don't modify the code. First analyze the possible causes of login failure and list your troubleshooting approach.

How do you plan to implement this feature? Describe the approach first, and I'll confirm before you write the code.

2. Fehlermeldungen und Logs bereitstellen

Wenn du auf einen Fehler stößt, füge die Fehlermeldung direkt in die Unterhaltung ein. Claude lokalisiert das Problem anhand des Fehlerinhalts:

运行时报了这个错误，帮我分析原因：
TypeError: Cannot read properties of null (reading 'userId')
    at getUserProfile (src/services/user.ts:42:18)
    at async ProfileController.getProfile (src/controllers/profile.ts:15:20)

3. Beschreibe UI-Probleme mit Screenshots

Claude Code unterstützt multimodale Eingaben. Du kannst Screenshots direkt in die Unterhaltung einfügen, um UI-bezogene Probleme zu beschreiben:

[Paste screenshot] This button does not respond when clicked, but there are no errors in the console. Help me investigate.

[粘贴设计稿截图] 按照这个设计实现 Header 组件

4. Nutze "Continue" richtig

Wenn Claudes Antwort abgeschnitten ist oder du das Gefühl hast, dass sie noch nicht fertig ist, sag einfach "continue":

Continue.

Anything else?

Implement the remaining parts as well.

5. Erklärungen zu Änderungen anfordern

Bei wichtigen Codeänderungen kannst du Claude bitten, den Grund für jede Änderung zu erklären:

After making the changes, explain the purpose of each change to me.

这里为什么要用 Promise.allSettled 而不是 Promise.all？

6. Den Operationsbereich von Claude einschränken

Wenn du nicht möchtest, dass Claude andere Dateien willkürlich ändert, kannst du den Bereich explizit einschränken:

只修改 src/auth.ts 这一个文件，不要改其他地方

Only read the code, don't modify it. Help me analyze the performance bottleneck of this module.

Gängige Workflow-Beispiele

Workflow 1: Ein neues Projekt schnell verstehen

Workflow 2: Einen Bug beheben

Workflow 3: Eine neue Funktion hinzufügen

Workflow 4: Code Review

# 审查特定文件
> 帮我审查 src/payment/processor.ts 这个文件，
> 重点关注错误处理、边界情况和安全风险

# 审查 git 改动
> 审查我这次的所有改动，看看有没有明显的问题

# 针对性检查
> 这段代码有没有 SQL 注入的风险？

Hinweise

Zu Dateiänderungen:Claude Code zeigt den Diff an und fordert eine Bestätigung an, bevor Änderungen vorgenommen werden.Nicht alles blind akzeptieren, insbesondere bei Änderungen, die die Kernlogik betreffen. Bitte lesen Sie den Diff-Inhalt sorgfältig, bevor Sie entscheiden, ob Sie akzeptieren.

Zu sensiblen Dateien: InCLAUDE.mdoder.claude/settings.jsonDateien, die Claude nicht lesen oder ändern darf, klar kennzeichnen (z. B..env, Schlüsseldateien) zur Vermeidung versehentlicher Offenlegung.

Zu großen Aufgaben: Nicht zu viele unerledigte Aufgaben in einer Konversation anhäufen; das kann leicht dazu führen, dass Claude den Fokus verliert. Eine Aufgabe abschließen, bevor eine neue begonnen wird, oder verwenden Sie/clearzum Neustart.

Zur Codequalität: Von Claude generierter Code ist nicht immer die optimale Lösung. Bei wichtigen Modulen wird nach der Ausführung eine Runde Code-Review empfohlen, um den Zweck jeder Änderung zu verstehen und sicherzustellen, dass sie den Designprinzipien des Projekts entspricht.