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

# Claude Code Integrationsanleitung

> Claude Code mit Infercom via ccproxy für EU-souveräne KI-Inferenz konfigurieren. Anthropics CLI-Agent mit GDPR-konformer Infrastruktur nutzen.

<Warning>
  **Fortgeschrittenes Setup** - Diese Integration erfordert das Ausführen eines lokalen Proxys. Für einfachere Setups ziehen Sie [Aider](/de/agentic-coding/aider) oder [OpenCode](/de/agentic-coding/opencode) in Betracht.
</Warning>

[Claude Code](https://claude.ai/claude-code) ist Anthropics offizielle CLI für KI-gestütztes Coding. Obwohl es für Claude-Modelle konzipiert ist, können Sie Anfragen mit [ccproxy](https://github.com/ryoppippi/ccproxy), einem LiteLLM-basierten Proxy, an Infercom routen.

## Funktionsweise

ccproxy fängt Claude Codes API-Aufrufe ab und routet sie zu Ihrem konfigurierten Provider (Infercom). Dies ermöglicht die Nutzung von Claude Codes Interface während die Inferenz auf EU-souveräner Infrastruktur läuft.

```
Claude Code CLI -> ccproxy (localhost) -> Infercom API
```

## Voraussetzungen

* [Claude Code CLI](https://claude.ai/claude-code) installiert
* [Infercom API-Schlüssel](https://cloud.infercom.ai/apis)
* Node.js 18+ oder Bun

## Installation

### Schritt 1: ccproxy installieren

```bash theme={null}
# Mit npm
npm install -g ccproxy

# Oder mit Bun
bun install -g ccproxy
```

### Schritt 2: Konfiguration erstellen

`~/.ccproxy/config.yaml` erstellen:

```yaml theme={null}
model_list:
  # Sonnet-Anfragen zu Infercom MiniMax routen
  - model_name: infercom
    litellm_params:
      model: openai/MiniMax-M2.7
      api_base: https://api.infercom.ai/v1
      api_key: "ihr-infercom-api-key"

  # Claude-Modelle für komplexe Aufgaben behalten (optional)
  - model_name: claude-sonnet-4-6
    litellm_params:
      model: anthropic/claude-sonnet-4-6
      api_base: https://api.anthropic.com
      api_key: "ihr-anthropic-api-key"

litellm_settings:
  drop_params: true  # Erforderlich - verwirft nicht unterstützte Parameter wie reasoning_effort
```

`~/.ccproxy/ccproxy.yaml` für Routing-Regeln erstellen:

```yaml theme={null}
ccproxy:
  rules:
    # Sonnet zu Infercom routen
    - name: infercom
      rule: ccproxy.rules.MatchModelRule
      params:
        - model_name: claude-sonnet-4-6

litellm:
  host: 127.0.0.1
  port: 4000
```

<Tip>
  `drop_params: true` ist erforderlich weil MiniMax nicht alle Claude-Parameter wie `reasoning_effort` unterstützt.
</Tip>

<Tip>
  Mehrere Claude-Modellnamen mappen für Kompatibilität mit verschiedenen Claude Code Versionen.
</Tip>

### Schritt 3: ccproxy starten

```bash theme={null}
cd ~/.ccproxy && ccproxy start
```

Sie sollten sehen:

```
ccproxy running on http://127.0.0.1:4000
```

Dieses Terminal offen lassen während Claude Code verwendet wird.

## Verwendung

### Claude Code konfigurieren

In einem neuen Terminal den API-Endpunkt setzen:

```bash theme={null}
export ANTHROPIC_BASE_URL="http://127.0.0.1:4000"
```

### Claude Code ausführen

```bash theme={null}
claude
```

### Modelle wechseln

Den `/model`-Befehl in Claude Code verwenden um ein Modell auszuwählen. Der Modellname zeigt "Claude" aber Anfragen werden zu MiniMax-M2.7 geroutet.

## ccproxy als Service ausführen

### macOS (launchd)

`~/Library/LaunchAgents/com.ccproxy.plist` erstellen:

```xml theme={null}
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.ccproxy</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/ccproxy</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>
```

Service laden:

```bash theme={null}
launchctl load ~/Library/LaunchAgents/com.ccproxy.plist
```

### Linux (systemd)

`~/.config/systemd/user/ccproxy.service` erstellen:

```ini theme={null}
[Unit]
Description=ccproxy für Claude Code
After=network.target

[Service]
ExecStart=/usr/local/bin/ccproxy
Restart=always

[Install]
WantedBy=default.target
```

Aktivieren und starten:

```bash theme={null}
systemctl --user enable ccproxy
systemctl --user start ccproxy
```

## Einschränkungen

<Warning>
  **Bekannte Einschränkungen:**

  * Modellname zeigt "Claude" im Interface auch wenn Infercom verwendet wird
  * Einige Claude-spezifische Funktionen könnten nicht funktionieren (Vision, Computer Use)
  * Erfordert laufenden Proxy
  * VS Code Extension ist weniger zuverlässig als CLI
</Warning>

## Fehlerbehebung

### Verbindung abgelehnt

Sicherstellen dass ccproxy läuft:

```bash theme={null}
curl http://127.0.0.1:4000/health
```

### Authentifizierungsfehler

Infercom API-Schlüssel in `ccproxy.yaml` verifizieren:

```bash theme={null}
curl -s https://api.infercom.ai/v1/models \
  -H "Authorization: Bearer ihr-infercom-api-key"
```

### Modell nicht gefunden

Prüfen dass `ccproxy.yaml` die korrekten Claude-Modellnamen mappt:

```yaml theme={null}
model_name: "claude-sonnet-4-6"  # Muss zu dem passen was Claude Code anfragt
```

### Langsame Antworten

ccproxy fügt minimale Latenz hinzu. Bei langsamen Antworten prüfen:

1. Netzwerkverbindung zu `api.infercom.ai`
2. Modell-Ladezeiten (erste Anfrage kann langsamer sein)

## Sicherheitsüberlegungen

* ccproxy läuft lokal und exponiert Ihren API-Schlüssel nicht an externe Services
* Gesamter Traffic zu Infercom ist verschlüsselt (HTTPS)
* Ihr Code bleibt innerhalb der EU-Infrastruktur

## Alternative: Direkte API

Für einfachere Setups ohne Proxy-Overhead erwägen Sie:

* [Aider](/de/agentic-coding/aider) - 2 Minuten Setup
* [OpenCode](/de/agentic-coding/opencode) - Volle TUI-Erfahrung

## Nächste Schritte

* [Tool auswählen](/de/agentic-coding/choosing-a-tool) - Alle Optionen vergleichen
* [API-Referenz](/de/api-reference/overview) - Direkte API-Nutzung