Blog

Claude Code Onboarding: Ein einfacherer Einstieg

Oliver Kingsley

Oliver Kingsley

23 June 2025

Claude Code Onboarding: Ein einfacherer Einstieg

Wenn Sie jemals versucht haben, ein neues KI-Tool in den Workflow Ihres Teams zu integrieren, kennen Sie den Schmerz: Einarbeitungsschwierigkeiten, unklare Dokumentationsregeln und ein Überprüfungsprozess, der sich anfühlt, als wäre er dazu gedacht, Ihre Geduld auf die Probe zu stellen. Nachdem ich einige Zeit mit Cursor verbracht hatte, nutzte ich Claude Code immer häufiger – seine Ergebnisse waren einfach zu gut, um sie zu ignorieren. Aber es in einem echten Projekt zum Laufen zu bringen? Da begann die eigentliche Herausforderung.

Dieser Artikel stellt einen praktischen Prompt und Workflow vor, der die Hürde für die Einführung von Claude Code drastisch senkt und Dokumentationsaktualisierungen sowie Wissensaustausch für Ihr gesamtes Team zum Kinderspiel macht.

💡
Bevor Sie sich mit Claude Code Prompts und Einarbeitungs-Workflows befassen, optimieren Sie Ihren gesamten API-Lebenszyklus mit Apidog – einem All-in-One-Tool für die API-Entwicklung zum Designen, Testen, Dokumentieren und Mocken von APIs. Es ist der perfekte Begleiter für jeden KI-gestützten Entwicklungs-Stack.
Button

Die tatsächlichen Hürden bei der Einführung von KI-Tools

Als ich zum ersten Mal hörte, dass Claude Code „Ihre Codebasis intuitiv verstehen und die Entwicklung beschleunigen“ könnte, war ich begeistert. Aber die Realität? Die größten Hürden bestanden nicht darin, das Tool zu erlernen, sondern es in unseren tatsächlichen Workflow zu integrieren. Hier ist, was uns stolpern ließ:

1. Unklare Dateistruktur

2. Vage Aktualisierungsregeln

3. Aufwendiger Überprüfungsprozess

Als Ingenieure ist es unsere Aufgabe, diese Schwachstellen in konkrete, wiederholbare Systeme zu verwandeln.

Die Lösung: Claude Code Prompt für die Dokumentationsautomatisierung

Um diese Probleme anzugehen, habe ich einen einzigen „Initialisierungs-Prompt“ für Claude Code erstellt. Das Ergebnis? Er senkte die Einarbeitungshürde drastisch und ermutigte mehr Entwickler, das Tool tatsächlich auszuprobieren. Hier ist der Kern des Prompts und Workflows:

Schritt-für-Schritt Claude Code Prompt Workflow

Schritt 1: Bestehende Dokumentation erkunden

Schritt 2: CLAUDE.md mit Automatisierungsregeln aktualisieren

Schritt 3: Fehlende Dokumentation vorschlagen

Schritt 4: Einrichtung bestätigen und den Prozess protokollieren

Die vollständigen Prompts sehen so aus:

Claude Code Initial Setup Prompt

Please follow the steps below to set up an interactive document update system for this project.

1. Explore Existing Documentation
Start by exploring the existing documentation in the project:

- All .md files in the .cursor/rules/ directory
- The docs/ directory (if it exists)
- Any *.md files in the root directory (e.g., README.md, CONTRIBUTING.md)
- Any other project-specific documentation directories
- List the documents you find and provide a brief description of their purpose.

2. Add to CLAUDE.md
Add the following content to the CLAUDE.md file. If the file already exists, keep the existing content and append the following section.

📚 Document Auto-Update System

This project uses a system that systematically manages knowledge gained during development and reflects it in existing documentation.

### Documents to Review

Before starting work, be sure to review the following documents:

[Generate the list based on the results of the document exploration]  
Example:

- `.cursor/rules/coding-standards.md` - Coding Standards
- `.cursor/rules/architecture.md` - Architecture Design
- `docs/troubleshooting.md` - Troubleshooting Guide

### Update Rules

#### When to Propose Updates

Please propose document updates in the following situations:

1. **When resolving errors or problems**
2. **When discovering efficient implementation patterns**
3. **When establishing usage patterns for new APIs/libraries**
4. **When existing documentation is outdated or incorrect**
5. **When identifying frequently referenced information**
6. **When completing fixes from code reviews**

#### Proposal Format

💡 Document Update Proposal: [Describe the situation]  
【Update Details】[Specify additions/changes]  
【Update Candidates】  
[File Path 1] - [Reason]  
[File Path 2] - [Reason]  
New File Creation - [Reason]  
Where should this be added? (Select a number or skip)

#### Approval Process

1. User selects the target file for the update
2. Preview of the actual update is shown
3. User provides final approval (`yes` / `edit` / `no`)
4. Upon approval, the file is updated

### Coordination with Existing Documents

- Follow existing formatting and style conventions
- If related content exists, clearly reference it
- Include the date in YYYY-MM-DD format in the update history

### Important Constraints

1. **Do not update files without user approval**
2. **Do not delete or modify existing content—additions only**
3. **Do not record sensitive information (API keys, passwords, etc.)**
4. **Follow project-specific conventions and style guides**

### Document Splitting Strategy

To prevent `CLAUDE.md` from becoming too large, split files using the following guidelines:

- **If it exceeds 100 lines**: Suggest splitting related content into separate files
- **Recommended Splits**:
  - `.cursor/rules/update-system.md` - Rules for the update system
  - `.cursor/rules/project-specific.md` - Project-specific configurations
  - `.cursor/rules/references.md` - List of documents to reference
- **Leave only a summary and links in `CLAUDE.md`**; place details in individual files

---

#### 3. Propose Recommended Document Structure

Based on analysis of the current document structure, suggest potentially missing documents:

📁 **Proposed Document Structure**  
We recommend adding the following documents to this project:

[Suggest missing documentation based on the exploration results]  
Example:

1. `.cursor/rules/patterns.md` - Implementation Patterns & Best Practices  
  → Collect efficient code patterns

2. `.cursor/rules/troubleshooting.md` - Troubleshooting Guide  
  → Systematize errors and solutions

3. `.cursor/rules/dependencies.md` - Dependencies & API Usage  
  → Document usage of external libraries

4. `.cursor/rules/remote-integration.md` - Remote Repository Integration  
  → Record best practices for Git workflows, branching strategy, PR/MR templates, CI/CD settings, etc.


Do you want to create these files? (Select numbers: "1,2" or "all" or "skip")  
For the selected files, please create an initial template.

---

#### 4. Operation Confirmation

After completing setup, display the following message:

✅ Document auto-update system setup is complete!

**【Setup Details】**

- Added operational rules to `CLAUDE.md`
- [List of created documents]

**【Future Operation】**

1. When new insights arise during work, update proposals will be made
2. Updates will be made only after your approval
3. Existing documentation formats will be followed, and knowledge will be accumulated systematically

Would you like to run a test? (Trigger a test error to verify the proposal flow)

---

#### 5. Log the Initial Setup

Finally, create a `setup-log.md` file under `.cursor/rules/` (or another appropriate location) to log the initial setup:

# Document Auto-Update System Setup Log

## Setup Date

[YYYY-MM-DD HH:MM]

## Actions Taken

1. Explored existing documentation
  - [List of discovered files]

2. Added to `CLAUDE.md`
  - Document reference list
  - Update rules
  - Approval process

3. Newly created documents
  - [List of created files]

## Notes

[Include any special notes if necessary]


Please follow the steps above and confirm with the user at each stage.

Claude Code mit Apidog MCP Server verbinden: Der ultimative API-Workflow

Nachdem Ihr Team nun mit Claude Code Prompts vertraut ist, ist es an der Zeit, Ihren API-Workflow mit Apidog MCP Server auf die nächste Stufe zu heben. Hier erfahren Sie, warum diese Kombination bahnbrechend ist:

Schritt-für-Schritt: So verwenden Sie Apidog MCP Server mit Claude Code

Voraussetzungen

Schritt 1: Datenquelle wählen

Schritt 2: MCP in Cursor konfigurieren

Beispiel für die Verbindung von KI mit einem Apidog-Projekt in Cursor:

{
  "mcpServers": {
    "API specification": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--project=<project-id>"
      ],
      "env": {
        "APIDOG_ACCESS_TOKEN": "<access-token>"
      }
    }
  }
}

Beispiel für die Verbindung von KI mit der OpenAPI-Datei in Cursor:

{
  "mcpServers": {
    "API specification": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--oas=<oas-url-or-path>"
      ]
    }
  }
}

Schritt 3: Verbindung überprüfen

Wechseln Sie in Cursor zu Claude Code und fragen Sie:

Please fetch API documentation via MCP and tell me how many endpoints exist in the project.

Wenn die KI Ihre API-Informationen zurückgibt, sind Sie startklar!

Warum Entwickler zu Claude Code & Apidog MCP Server wechseln

In der sich schnell verändernden Welt der API-Entwicklung sind Claude Code und Apidog MCP Server die Tools, mit denen Sie sich auf das Wesentliche konzentrieren können – die Entwicklung großartiger Software.

Button

Fazit: Intelligenter einarbeiten, schneller entwickeln

Die Herausforderung der Einarbeitung ist real, aber mit dem richtigen Claude Code Prompt und der Leistungsfähigkeit des Apidog MCP Servers können Sie die Dokumentation von einem Engpass in einen Wettbewerbsvorteil verwandeln. Teams, die die Einarbeitung automatisieren und ihre API-Workflows mit KI verbinden, sind diejenigen, die am schnellsten vorankommen, Wissen teilen und bessere Produkte entwickeln.

Melden Sie sich noch heute bei Apidog an und erleben Sie die nächste Stufe der API-Entwicklung. Die Zukunft ist da – verpassen Sie sie nicht.

Button

Praktizieren Sie API Design-First in Apidog

Entdecken Sie eine einfachere Möglichkeit, APIs zu erstellen und zu nutzen

Kostenlos registrierenDownload