> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Verwenden Sie TokenLab mit Anthropics Claude Code CLI

## Überblick

<Note>
  **Typ**: Coding-Tool

  **Primärer Pfad**: Anthropic-native

  **Support-Niveau**: Starker nativer Pfad
</Note>

[Claude Code](https://docs.anthropic.com/en/docs/claude-code) ist Anthropics offizielles CLI-Tool für KI-gestütztes Coding. Sie können es so konfigurieren, dass TokenLab als API-Provider verwendet wird.

## Installation

Anthropic empfiehlt jetzt das native Installationsprogramm. Die npm-Installation existiert weiterhin aus Kompatibilitätsgründen, ist upstream jedoch veraltet.

```bash theme={null}
curl -fsSL https://claude.ai/install.sh | bash
```

Wenn Sie speziell das npm-Paket benötigen, verwenden Sie:

```bash theme={null}
npm install -g @anthropic-ai/claude-code
```

<Warning>
  Verwenden Sie nicht `sudo npm install -g` für Claude Code.
</Warning>

## Konfiguration

### Umgebungsvariablen

Setzen Sie die folgenden Umgebungsvariablen:

```bash theme={null}
export ANTHROPIC_API_KEY="sk-your-tokenlab-key"
export ANTHROPIC_BASE_URL="https://api.tokenlab.sh"
```

Fügen Sie diese Ihrem Shell-Profil (`~/.bashrc`, `~/.zshrc` usw.) hinzu, damit sie dauerhaft erhalten bleiben.

<Note>
  Für TokenLab lassen Sie `ANTHROPIC_BASE_URL` auf `https://api.tokenlab.sh` ohne ein `/v1`-Suffix. Dies entspricht der Endpunkt-Struktur im Anthropic-Stil und dem von Claude Code dokumentierten Muster eines einheitlichen Gateways.
</Note>

### Konfigurationsdatei

Alternativ können Sie `~/.claude/settings.json` erstellen oder bearbeiten:

```json theme={null}
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-tokenlab-key",
    "ANTHROPIC_BASE_URL": "https://api.tokenlab.sh"
  }
}
```

## Verwendung

Nach der Konfiguration verwenden Sie Claude Code wie gewohnt:

```bash theme={null}
# Start an interactive session
claude

# Run a single command
claude "Explain this code" < main.py

# Chat mode
claude chat
```

Überprüfen Sie bei Bedarf die Installation:

```bash theme={null}
claude --version
claude doctor
```

## Verfügbare Modelle

TokenLab unterstützt alle Claude-Modelle:

| Modell              | Beschreibung                                    |
| ------------------- | ----------------------------------------------- |
| `claude-opus-4-6`   | Am leistungsfähigsten, komplexes Schlussfolgern |
| `claude-sonnet-4-6` | Ausgewogene Leistung, hervorragend für Coding   |
| `claude-haiku-4-5`  | Am schnellsten, kosteneffizient                 |

## Modellauswahl

Geben Sie ein Modell mit dem Flag `--model` an:

```bash theme={null}
claude --model claude-sonnet-4-6 "Review this PR"
```

Oder setzen Sie in Ihrer Konfiguration ein Standardmodell:

```json theme={null}
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-tokenlab-key",
    "ANTHROPIC_BASE_URL": "https://api.tokenlab.sh"
  },
  "model": "claude-sonnet-4-6"
}
```

## Erweitertes Denken

Für Aufgaben mit komplexem Schlussfolgern verwenden Sie Modelle mit erweitertem Denken:

```bash theme={null}
claude --model claude-opus-4-6 "Design a microservices architecture for..."
```

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Verbindungsfehler">
    Vergewissern Sie sich, dass die Base-URL exakt `https://api.tokenlab.sh` ist (kein `/v1`-Suffix für Anfragen im Anthropic-Stil).
  </Accordion>

  <Accordion title="Ungültiger API key">
    Stellen Sie sicher, dass Ihr TokenLab API key mit `sk-` beginnt und über ausreichendes Guthaben verfügt.
  </Accordion>

  <Accordion title="Gateway erfordert Authorization bearer token">
    Der Gateway-Modus von Claude Code unterstützt auch `ANTHROPIC_AUTH_TOKEN`. Verwenden Sie weiterhin `ANTHROPIC_API_KEY` für das standardmäßige TokenLab-Setup, es sei denn, Sie haben das Auth-Verhalten Ihres Gateways absichtlich geändert.
  </Accordion>

  <Accordion title="Modell nicht gefunden">
    Prüfen Sie, ob der Modellname korrekt ist. Verwenden Sie das Format `claude-sonnet-4-6`.
  </Accordion>
</AccordionGroup>