Claude Code konfigurieren: Nutzung in China, Proxy und API-Adresse, häufig verwendete Umgebungsvariablen

Nutzung in China: auf das Gateway verweisen, ohne VPN

# ~/.zshrc / ~/.bashrc / PowerShell 配置文件
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=你的网关密钥
claude

Claude Code liest wie das offizielle SDK diese beiden Variablen. Die Anfragen werden an das Gateway statt an api.anthropic.com gesendet, sodass eine direkte Verbindung aus chinesischen Netzwerken möglich ist. Geben Sie nur die Domain an, ohne /v1. Öffnen Sie nach der Einrichtung das Terminal erneut und prüfen Sie die Einstellungen innerhalb einer Sitzung mit /status . Die VS Code-Erweiterung und die Desktop-App lesen die Umgebungsvariablen der Shell, aus der sie gestartet wurden. Beenden Sie nach einer Konfigurationsänderung den Editor vollständig und starten Sie ihn aus einem neuen Terminal.

Wann ist ein Proxy erforderlich?

Nur wenn selbst die Verbindung zum Gateway in Ihrem Netzwerk instabil ist. Die Einrichtung erfolgt wie bei anderen Kommandozeilentools:

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

Wenn /login bei der OAuth-Anmeldung eine Zeitüberschreitung meldet („timeout of 15000ms exceeded“), liegt es meist am Proxy oder an DNS-Problemen; mit der Anmeldung per API-Schlüssel können Sie OAuth vollständig umgehen.

Modellkonfiguration

export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Claude Code arbeitet mit Stufen (Sonnet / Opus / Haiku). Diese drei Variablen bestimmen, welches konkrete Modell jeder Stufe zugeordnet ist. Die Haiku-Stufe ist wichtiger, als sie scheint: Claude Code nutzt sie für kleinere Aufgaben in jeder Sitzung. Die Zuordnung zu einem günstigen Modell kann viel sparen. Das Gateway bietet derzeit 33 Claude-Modell-IDs an, die Sie alle in/model auswählen können.

Wo befinden sich die Konfigurationsdateien?

• CLAUDE.md(im Projektstammverzeichnis) – Projektwissen: Build- und Testbefehle sowie Konventionen;CLAUDE.local.md enthält persönliche Notizen und wird nicht ins Repository aufgenommen.
• .claude/settings.json(Projekt) / ~/.claude/settings.json(global) – Berechtigungen, Hooks, Umgebungsvariablen, statusLine.
• .claude/agents/ – Definitionen von Unteragenten;.claude/skills/ und ~/.claude/skills/ – Skills.
• .mcp.json – gemeinsam genutzte MCP-Serverkonfiguration des Projekts.

Fehlerbehebung bei Konfigurationsproblemen

• 404 und im Protokoll erscheint /v1/v1/messages → bei BASE_URL wurde zusätzlich /v1。
• 401 / invalid key → Schlüssel und Adresse passen nicht zusammen: Zur Gateway-Adresse gehört ein Gateway-Schlüssel.
• Mit Max angemeldet, aber Abrechnung nach Tokens → in der Umgebung ist noch ANTHROPIC_API_KEY gesetzt; der Schlüssel hat Vorrang vor der Anmeldung. Entfernen Sie die Variable mit unset, wenn Sie ihn nicht verwenden möchten.
• Modell nicht vorhanden → diese ID steht nicht in der /v1/models Liste des aktuellen Endpunkts.
• Nach einer Änderung an settings.json wird das Programm direkt beim Start beendet → JSON-Syntaxfehler (überflüssiges Komma). Prüfen Sie die Datei mit einem Validierungstool.

Kosten

Wenn Sie die Adresse auf das Gateway setzen, ändert sich auch die Abrechnung: Guthaben wird zum 7.69231-Fachen seines Nennwerts verkauft, für $13 erhalten Sie $100 Guthaben. Für intensive Nutzung stehen unbegrenzte Tarife ab $0.80 zur Verfügung. Details finden Sie auf der Preisseite.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Häufig gestellte Fragen

AI Prime Tech ist ein unabhängiges API-Gateway und ist weder mit Anthropic verbunden noch wird es von Anthropic unterstützt oder gesponsert. „Claude“ und „Claude Code“ sind Marken von Anthropic. Die hier beschriebenen Funktionen von Claude Code entsprechen der öffentlichen Dokumentation von Anthropic zum Zeitpunkt der Erstellung und ändern sich häufig; Preise und Modelllisten auf dieser Seite werden aus den aktuellen Einstellungen dieses Gateways ausgelesen.