# Anleitung: Claude über SSH aus TaskMate starten

## Voraussetzungen
- SSH-Client auf dem eigenen Computer
- Zugang zu TaskMate

## Schritt 1: SSH-Schlüsselpaar erstellen

### Windows (PowerShell/Terminal):
```
ssh-keygen -t rsa -b 4096 -f %USERPROFILE%\.ssh\taskmate_claude
```

### Mac/Linux:
```
ssh-keygen -t rsa -b 4096 -f ~/.ssh/taskmate_claude
```

**Wichtig:** 
- Bei der Frage nach einem Passwort ein sicheres Passwort vergeben und merken
- Es werden zwei Dateien erstellt:
  - `taskmate_claude` (privater Schlüssel - GEHEIM HALTEN!)
  - `taskmate_claude.pub` (öffentlicher Schlüssel)

## Schritt 2: Öffentlichen Schlüssel übermitteln

Den Inhalt der Datei `taskmate_claude.pub` an den Administrator senden:

### Windows:
```
type %USERPROFILE%\.ssh\taskmate_claude.pub
```

### Mac/Linux:
```
cat ~/.ssh/taskmate_claude.pub
```

Der Administrator muss diesen öffentlichen Schlüssel auf dem Server hinterlegen.

## Schritt 3: SSH-Konfiguration einrichten

Eine Konfigurationsdatei erstellen für einfacheren Zugriff:

### Windows:
Datei `%USERPROFILE%\.ssh\config` bearbeiten

### Mac/Linux:
Datei `~/.ssh/config` bearbeiten

Folgenden Inhalt hinzufügen:
```
Host taskmate-claude
    HostName [SERVER-IP oder DOMAIN]
    User [BENUTZERNAME]
    Port [SSH-PORT, standard 22]
    IdentityFile ~/.ssh/taskmate_claude
```

**Hinweis:** Die Werte in eckigen Klammern müssen vom Administrator bereitgestellt werden.

## Schritt 4: Verbindung testen

```
ssh taskmate-claude
```

Bei der ersten Verbindung:
1. Die Fingerprint-Warnung mit "yes" bestätigen
2. Das beim Erstellen des Schlüssels vergebene Passwort eingeben

## Schritt 5: Integration in TaskMate

Nach erfolgreicher SSH-Konfiguration:
1. In TaskMate einloggen
2. Zur Kachel "TaskMate -> Claude starten" navigieren
3. Die Funktion sollte nun verfügbar sein

## Sicherheitshinweise

- **Privaten Schlüssel niemals weitergeben!** (Datei ohne .pub Endung)
- Das Passwort für den SSH-Schlüssel sicher aufbewahren
- Bei Verlust des privaten Schlüssels muss ein neues Schlüsselpaar erstellt werden

## Fehlerbehebung

### "Permission denied"
- Prüfen ob der richtige Schlüssel verwendet wird
- Prüfen ob das Passwort korrekt ist

### "Connection refused"
- Server-IP/Domain und Port prüfen
- Firewall-Einstellungen prüfen

### "Host key verification failed"
- Die Datei `~/.ssh/known_hosts` prüfen
- Ggf. alten Eintrag für den Server entfernen

## Benötigte Informationen vom Administrator

Der Administrator muss folgende Daten bereitstellen:
1. Server-IP oder Domain
2. SSH-Port (falls nicht Standard 22)
3. Benutzername für SSH-Zugang
4. Bestätigung dass der öffentliche Schlüssel hinterlegt wurde