Claude Code Projektinitialisierung

Du kannst ein Claude Code-Projekt initialisieren, indem du Folgendes in die interaktive Oberfläche von Claude Code eingibst:

/init

Wir können in einem bestehenden Projektverzeichnis initialisieren oder ein neues erstellen.

Wir können zuerst ein Verzeichnis erstellen:

mkdir claude-example-test

Wechseln Sie in dieses Verzeichnis:

cd claude-example-test

Erstelle eine Testdatei test.py mit dem folgenden Code:

print("Hello, Example!")

Geben Sie die interaktive Claude-Code-Oberfläche ein:

claude

Verwenden Sie den/init Befehl, um das Projekt zu initialisieren:

/init

Wenn Sie VS Code verwenden, können Sie es auch in der Claude-Code-Oberfläche in VS Code eingeben/init:

Claude wird Ihre Codebasis automatisch scannen—package.json, vorhandene Dokumentation, Konfigurationsdateien und die Codestruktur lesen—und dann eine CLAUDE.md-Datei generieren, die speziell auf Ihr Projekt zugeschnitten ist.

Claude Der gesamte Prozess erfordert keine manuelle Bedienung; Claude analysiert und gibt die initiale Konfiguration selbstständig aus.

CLAUDE.md-Datei

CLAUDE.md ist eine Markdown-Datei, die im Stammverzeichnis des Projekts abgelegt wird. Claude Code liest sie automatisch zu Beginn jeder Sitzung.

CLAUDE.md wird Teil von Claudes System-Prompt, wodurch jede Konversation den Projektkontext vorab laden kann, ohne dass grundlegende Informationen wiederholt erklärt werden müssen.

Eine gute CLAUDE.md sollte drei Dimensionen abdecken:

  • WAS: Tech-Stack und Projektstruktur—bietet Claude eine globale Karte der Codebasis
  • WARUM: Der Zweck des Projekts sowie die Funktion und Positionierung jedes Moduls
  • WIE: Entwicklungspraktiken, wie die Verwendung von bun statt node, und wie Claude überprüft, ob Änderungen korrekt sind Humanlayer

Das Folgende ist ein Beispiel für eine typische CLAUDE.md-Struktur:

# 项目名称

## 项目概述
简述这个项目的目的和功能。

## 技术栈
- Frontend: React + TypeScript
- Backend: Node.js + Express
- Database: PostgreSQL

## 目录结构
- `src/components/` - React 组件
- `src/api/`        - API 层
- `tests/`          - 测试文件

## 常用命令
- 启动开发服务器：`pnpm dev`
- 运行测试：`pnpm test`
- 代码检查：`pnpm lint`

## 开发规范
- 使用 TypeScript strict 模式
- 优先使用 interface 而非 type
- 禁止使用 any，使用 unknown 替代
```

### 文件位置与层级

项目的核心文件结构如下： 
```
your-project/
├── CLAUDE.md                  # 项目主记忆文件（团队共享）
├── .claude/
│   ├── settings.json          # Hooks、权限、环境配置
│   ├── settings.local.json    # 个人配置（建议加入 .gitignore）
│   └── commands/              # 自定义斜杠命令
│       └── my-command.md
└── .mcp.json                  # MCP 服务配置
```

Best Practices nach der Initialisierung

Iterieren und verfeinern, statt es einmal zu schreiben und unverändert zu lassen.

/initDer Befehl eignet sich hervorragend für ein schnelles Onboarding, aber der wahre Wert entsteht durch kontinuierliche Iteration über die Zeit. Du kannst Inhalte hinzufügen, die Claude nicht selbst ableiten kann, wie Branch-Namenskonventionen, Deployment-Prozesse und Code-Review-Anforderungen, und gleichzeitig allgemeine Ratschläge entfernen, die nicht zutreffen.

  • In die Versionskontrolle übernehmen: Committe dieCLAUDE.mdDatei in Git, damit das gesamte Team davon profitiert. Neue Mitglieder können schnell auf den neuesten Stand kommen, indem Claude die Codebasis erklärt.

  • Halte es knapp: Inhalte sollten kurz und allgemein anwendbar sein. Übernimm das Prinzip der "progressiven Offenlegung"—stopfe nicht alles hinein, was Claude wissen soll; sag ihmstattdessen, wie es wichtige Informationen findet, und lass es sie bei Bedarf abrufen, um eine Überfüllung des Kontextfensters zu vermeiden.

  • Lass nicht zu, dass CLAUDE.md den Linter ersetzt: Codestilregeln in die Datei zu schreiben, ist einer der häufigsten Fehler. Setze niemals ein LLM für die Aufgabe eines Linters ein—Linter sind schneller, günstiger und deterministisch. Codestil-Einschränkungen blähen nur das Kontextfenster auf und verringern die Qualität, mit der Claude Anweisungen befolgt.

Nutzung#Tastenkürzel kontinuierlich aktualisiert

Verwende während einer Unterhaltung das#Präfix jederzeit, um Speicheranweisungen an Claude zu senden:

# 我们始终使用 pnpm，不用 npm
# 所有组件必须包含单元测试

Diese Ergänzungen sammeln sich allmählich an und bilden so einCLAUDE.md。

Initialisierungsergebnisse überprüfen

Nach Abschluss der Initialisierung können Sie anhand der folgenden Unterhaltungen bestätigen, ob Claude das Projekt korrekt versteht:

  • Was macht dieses Projekt?
  • Erklären Sie die Verzeichnisstruktur.
  • Welche Technologien verwendet das Projekt?
  • Wie lautet der Befehl zum Ausführen der Tests?
Andere Erweiterungen