Anmerkung des Autors: Auf Grundlage der Versionshinweise zu Claude Code v2.1.318 beleuchtet dieser Artikel die Ursachen und Lösungswege für sieben Problemtypen bei gemeinsam genutzten Home-Verzeichnissen im Netzwerk – darunter verlorene Konfigurationen, „Not logged in“ und abgelaufene Anmeldungen.
In Hochschulrechenräumen, HPC-Clustern oder auf Jump-Hosts in Unternehmen liegen Home-Verzeichnisse häufig auf NFS oder einem anderen Netzwerkdateisystem. Mehrere Hosts teilen sich dort dasselbe ~. Bei der Nutzung von Claude Code treten in solchen Umgebungen immer wieder Probleme auf: Die Konfiguration eines MCP-Servers ist am nächsten Tag verschwunden, nach dem Abmelden ist man plötzlich wieder angemeldet, Hintergrundaufgaben melden unerwartet „Not logged in“ oder ~/.claude.json ist leer. Dieser Artikel zeigt, wie Sie Konfigurations- und Anmeldeprobleme von Claude Code bei gemeinsam genutzten Home-Verzeichnissen im Netzwerk beheben. So finden Sie heraus, ob die Ursache in der Version, im Dateisystem oder bei den Anmeldedaten selbst liegt.
Das ist keine aus Erfahrungswerten zusammengewürfelte Liste von Vermutungen. Claude Code v2.1.318 wurde am 4. November 2026 veröffentlicht und behebt laut Versionshinweisen eine Reihe von Problemen im Zusammenhang mit gemeinsam genutzten Home-Verzeichnissen im Netzwerk. Die Schritte zur Fehlerbehebung in diesem Artikel basieren auf diesen Versionshinweisen.
Das bringt Ihnen der Artikel: Sie können anhand der Symptome Konfigurations- und Anmeldefehler von Claude Code in einem gemeinsam genutzten Home-Verzeichnis eingrenzen und entscheiden, ob ein Update, die Wiederherstellung eines Backups oder eine andere Authentifizierungsmethode sinnvoll ist.
Claude Code: Konfiguration und Anmeldung bei gemeinsam genutzten Netzwerk-Home-Verzeichnissen
Zunächst der Überblick: Claude Code verwaltet im Home-Verzeichnis vor allem drei Arten von Daten: die globale Konfigurationsdatei ~/.claude.json für MCP-Server, vertrauenswürdige Verzeichnisse und Ähnliches, die Settings-Dateien sowie gespeicherte Anmeldedaten. Bei einem gemeinsam genutzten Netzwerk-Home-Verzeichnis lesen und schreiben mehrere Prozesse auf mehreren Hosts gleichzeitig diese Dateien. Zudem unterscheiden sich Sperren, Caches und Quotas auf Netzwerkdateisystemen von denen lokaler Datenträger. Die folgende Tabelle zeigt die direkt relevanten Änderungen in v2.1.318:
| Punkt | Beschreibung | Ihr Vorteil |
|---|---|---|
| Schreibfehler melden keinen falschen Erfolg mehr | Wenn sich die Konfiguration im gemeinsam genutzten Home-Verzeichnis nicht aktualisieren lässt, melden /logout, claude auth logout und claude mcp remove keinen Erfolg mehr |
Sie wissen zuverlässig, ob Sie tatsächlich abgemeldet wurden |
| Erneute Anmeldung auf einem anderen Host unterbricht keine Aufgaben mehr | Meldet sich ein anderes Terminal oder ein anderer Host mit demselben Home-Verzeichnis erneut bei demselben Konto und derselben Organisation an, werden laufende Aufgaben nicht mehr mit „Not logged in“ beendet | Stabilere parallele Aufgaben auf mehreren Rechnern |
| Sperre beim Schreiben der MCP-Konfiguration | claude mcp add/remove wartet auf die Konfigurationssperre und endet mit Exit-Code 1, wenn sie nicht verfügbar ist |
Weniger Konfigurationsschäden durch gleichzeitige Schreibzugriffe |
| Ablaufzeit der Anmeldung sichtbar | claude auth status zeigt zusätzlich loginExpiresAt, das JSON-Ergebnis von claude -p enthält zusätzlich credential_expires_at |
Bald ablaufende Anmeldungen frühzeitig erkennen |
| Konfigurationsdateien robuster | Beim Speichern von ~/.claude.json, Settings-Dateien und Anmeldedaten im gemeinsam genutzten Home-Verzeichnis kommt es seltener vor, dass diese gelöscht, kurzzeitig geleert oder durch alte Kopien überschrieben werden |
Geringeres Risiko, dass Konfigurationen scheinbar grundlos verschwinden |
Warum die Claude-Code-Konfiguration bei einem gemeinsam genutzten Home-Verzeichnis Probleme machen kann
Auf einer lokalen Festplatte lässt sich das Speichern der Claude-Code-Konfiguration im Grunde als atomare Operation betrachten. Auf einem Netzwerkdateisystem können Vorgänge wie „temporäre Datei schreiben und anschließend ersetzen“ oder „prüfen, ob eine Datei existiert“ durch den Client-Cache in die Irre geführt werden: Eine vorhandene Datei wird dann etwa als fehlend gemeldet. Ältere Versionen gingen in diesem Fall möglicherweise davon aus, dass keine Konfiguration existiert. Beim nächsten Start fehlten dann die MCP-Server und vertrauenswürdigen Verzeichnisse. Seit v2.1.318 wird erneut geprüft, wenn eine Konfigurationsdatei fälschlich als fehlend gemeldet wird. Dadurch startet Claude Code seltener mit einer leeren Konfiguration.
Ein weiteres Risiko sind Festplattenquoten. In den Versionshinweisen wird ein Fall beschrieben, bei dem im Netzwerk-Home kein Platz mehr zum Schreiben von Daten vorhanden ist, das Anlegen neuer Dateien aber noch erlaubt wird. Beim Speichern der Zugangsdaten wurde die vorhandene Datei dann durch eine leere Datei ersetzt und der Nutzer abgemeldet. Das Problem ist in der neuen Version behoben. Wenn das Home-Verzeichnis auf Ihrem Cluster einer strengen Quote unterliegt, empfiehlt es sich trotzdem, den freien Platz regelmässig mit df oder dem Quota-Befehl des Clusters zu prüfen.
Probleme bei gleichzeitigen Claude-Code-Anmeldungen im gemeinsamen Home-Verzeichnis
Auch der Anmeldestatus ist häufig betroffen. Wird dasselbe Home-Verzeichnis von mehreren Rechnern genutzt und auf Rechner A mit claude auth login eine erneute Anmeldung durchgeführt, konnte ein laufender claude -p-Batch-Job auf Rechner B früher direkt mit „Not logged in“ beendet werden. v2.1.318 behebt dieses Problem, sofern dasselbe Konto und dieselbe Organisation verwendet werden. Ausserdem konnten Befehle der claude plugin-Reihe früher beendet werden, bevor eine langsamere Token-Aktualisierung vollständig gespeichert war. Beim nächsten Aufruf war man dann abgemeldet. Auch das wurde behoben.
Ein weiteres Problem ist weniger offensichtlich: Eine andere Anmeldung auf demselben Rechner hat eine allowedProviders-Liste gespeichert, und Ihre Sitzung wird beim Start aufgrund dieser Liste abgewiesen. Das konnte vorkommen, wenn mehrere Personen denselben Jump-Host nutzen oder ein Nutzer bei der Anmeldung zwischen verschiedenen Organisationen wechselt. In der neuen Version tritt diese fehlerhafte Ablehnung nicht mehr auf.
Claude Code bei gemeinsam genutztem Home-Verzeichnis: schneller Einstieg in die Fehlerbehebung
Die Fehlerbehebung lässt sich in vier Schritte aufteilen, die Sie am besten der Reihe nach ausführen. Gemäss der Konvention dieses Artikels stehen Befehle und Felder inline statt in Codeblöcken.
Schritt 1: Claude-Code-Version und Anmeldestatus prüfen
Führen Sie zunächst claude --version aus, um die Versionsnummer zu prüfen. Bei einer Version unter v2.1.318 empfiehlt sich ein Upgrade mit claude update oder über Ihre ursprüngliche Installationsmethode. Viele der hier beschriebenen Probleme lassen sich in älteren Versionen nur umgehen, aber nicht vollständig beheben. Führen Sie nach dem Upgrade claude auth status aus und prüfen Sie das aktuelle Konto, die Organisation und das neue Feld loginExpiresAt.
Wenn Sie claude -p hauptsächlich in Skripten aufrufen, können Sie das Ergebnis als JSON ausgeben lassen und in der Pipeline das Feld credential_expires_at auslesen. So können Sie rechtzeitig vor Ablauf eine Warnung auslösen. Im Textausgabemodus gibt die neue Version ab 10 Tagen vor Ablauf einer gespeicherten claude.ai-Anmeldung eine Warnzeile auf stderr aus. Achten Sie darauf in den Logs.
| Befehl/Feld | Zweck | Worauf bei der Fehlerbehebung achten? |
|---|---|---|
claude --version |
Aktuelle Version anzeigen | Ist sie ≥ v2.1.318? |
claude auth status |
Anmeldestatus anzeigen | Steht der Zeitpunkt in loginExpiresAt kurz bevor? |
claude -p (JSON-Ausgabe) |
Unbeaufsichtigter Aufruf | Feld credential_expires_at |
claude auth login |
Erneut beim claude.ai-Konto anmelden | Nach Ablauf der Anmeldung den Anweisungen folgen |
claude setup-token |
Token für unbeaufsichtigte Anwendungen erzeugen | Geeignet für CI und Stapelverarbeitung |
claude mcp add / claude mcp remove |
MCP-Server verwalten | Exit-Code 1 bedeutet, dass die Konfigurationssperre nicht erlangt wurde |
Schritt 2: Prüfen, ob ~/.claude.json intakt ist
Eine beschädigte Datei ~/.claude.json ist bei gemeinsam genutzten Home-Verzeichnissen die häufigste Ursache dafür, dass scheinbar die gesamte Konfiguration verloren geht. v2.1.318 ändert das Verhalten an mehreren Stellen: Enthält die Datei beim nicht interaktiven Start kein gültiges JSON, wird sie nicht mehr mit Standardwerten überschrieben. Stattdessen schlägt der Start fehl, und ein Hinweis erklärt, wie sich die Datei wiederherstellen lässt. Die Originaldatei bleibt unverändert (siehe Issue #87551). Ist die Datei leer und kein Backup vorhanden, startet die neue Version normal, als wäre die Datei nicht vorhanden, statt sie als beschädigt zu melden.
Auch der ausgegebene Wiederherstellungsbefehl ist zuverlässiger. Früher konnte er auf ein leeres oder abgeschnittenes Backup verweisen oder bei schreibgeschützten Dateien fehlschlagen. Beides wurde behoben. In Home-Verzeichnissen, in denen nur claude -p ausgeführt wird, konnte bei der Bereinigung nach Ablauf der Aufbewahrungsfrist zudem das letzte Backup von ~/.claude.json gelöscht werden. Jetzt wird zuerst ein neues Backup erstellt, bevor die alten gelöscht werden.
Schritt 3: Fehlgeschlagene Anmeldung und abgelaufene Zugangsdaten beheben
Wenn die Anmeldung fehlschlägt, prüfen Sie zuerst, ob die Meldung besagt, dass die gespeicherte claude.ai-Anmeldung abgelaufen ist. Die neue Version weist direkt darauf hin und nennt bei claude -p zwei Möglichkeiten: claude auth login und claude setup-token. Für die interaktive Nutzung eignet sich die erste Option, für dauerhaft im Hintergrund laufende Aufgaben in der Regel die zweite.
Auf Maschinen mit aktiviertem forceLoginOrgUUID, das die Anmeldung bei einer bestimmten Organisation erzwingt, gab es in älteren Versionen ein Problem: Mit setup-token erzeugte Tokens wurden beim Start abgelehnt, obwohl sie zur erlaubten Organisation gehörten. v2.1.318 behebt diesen Fehler. Wenn dieses Problem in einer Unternehmensumgebung auftritt, hilft in der Regel ein Update.
Schritt 4: Risiken durch gleichzeitige Schreibzugriffe verringern
Wenn mehrere Hosts gleichzeitig die MCP-Konfiguration ändern, ist das bei einem gemeinsamen Home-Verzeichnis ein grundsätzliches Risiko. Die aktuellen Versionen von claude mcp add und claude mcp remove warten auf die Konfigurationssperre. Können sie diese nicht erhalten, beenden sie sich mit dem Exit-Code 1, statt ohne Sperre zu schreiben. Allerdings weisen die Versionshinweise auch darauf hin, dass ein anderer Task beim Speichern der Konfiguration gerade gespeicherte Servereinträge weiterhin überschreiben kann. Führen Sie umfangreiche Änderungen an der MCP-Konfiguration daher möglichst sequenziell auf einem einzigen Host aus.
Außerdem wird bei unbeaufsichtigten Läufen (claude -p und SDK-Anwendungen) die Datei ~/.claude.json nicht mehr jedes Mal neu geschrieben, wenn sich die Konfiguration nicht geändert hat. Das reduziert die Schreiblast auf die Konfigurationsdatei bei vielen parallelen Tasks deutlich. Wenn Ihr Cluster für umfangreiche Jobs noch eine ältere Version verwendet, ist auch das ein Grund für ein Update.
🚀 Schnellstart: Wenn Ihr Team Claude Code für Stapelverarbeitung auf einem Cluster nutzt und nicht vom Ablauf einer claude.ai-Anmeldung betroffen sein möchte, können Sie stattdessen eine API verwenden. APIYI apiyi.com bietet API-Aufrufe für Modelle der Claude-Familie und unterstützt sowohl das OpenAI- als auch das Anthropic-Schnittstellenformat. Informationen zur Anbindung finden Sie im Dokumentationszentrum unter docs.apiyi.com.
Häufige Probleme mit Claude Code bei gemeinsam genutztem Home-Verzeichnis
Die folgende Tabelle fasst typische Symptome, mögliche Ursachen und Lösungsvorschläge zusammen. Bei der Fehlersuche können Sie direkt nach dem Symptom suchen.
| Symptom | Mögliche Ursache | Lösungsvorschlag |
|---|---|---|
/logout meldet Erfolg, beim nächsten Start besteht die Anmeldung aber weiterhin |
Ältere Versionen meldeten Erfolg, obwohl das Schreiben der Konfiguration im gemeinsam genutzten Home-Verzeichnis fehlgeschlagen war | Auf v2.1.318 aktualisieren, claude auth logout ausführen und das Ergebnis prüfen |
| Hintergrundaufgaben melden plötzlich Not logged in | Ein anderes Terminal oder ein anderer Host hat sich im selben Home-Verzeichnis erneut angemeldet | Aktualisieren; das Problem wurde für dasselbe Konto und dieselbe Organisation behoben |
| Nach dem Start fehlen alle MCP-Server und vertrauenswürdigen Verzeichnisse | Das Netzwerkdateisystem meldet fälschlich, dass die Konfigurationsdatei fehlt | Aktualisieren, um die erneute Prüfung zu aktivieren; bei Bedarf aus einem Backup wiederherstellen |
| Die Datei mit den Anmeldedaten ist leer | Das Home-Verzeichnis hat keinen Speicherplatz mehr, neue Dateien können aber noch erstellt werden | Speicherplatz freigeben, erneut anmelden und aktualisieren |
| Der nicht interaktive Start schlägt sofort fehl und weist auf eine Wiederherstellung hin | ~/.claude.json enthält kein gültiges JSON |
Den angegebenen Wiederherstellungsbefehl ausführen und die Datei nicht manuell überschreiben |
| Der Start wird durch allowedProviders abgelehnt | Eine Liste, die bei einer anderen Anmeldung auf demselben Rechner gespeichert wurde, verursacht einen Konflikt | Nach dem Update erneut versuchen |
| Alle Netzwerkverbindungen schlagen fehl | NODE_EXTRA_CA_CERTS verweist auf eine leere Datei oder eine Datei, die nicht im PEM-Format vorliegt | Die neue Version verwendet lesbare Zertifikate und gibt eine Warnung auf stderr aus; zusätzlich die Zertifikatsdatei korrigieren |
Ein benutzerübergreifendes Szenario verdient besondere Aufmerksamkeit: Wenn jemand mit sudo claude einen laufenden Prozess gestartet hat, der einem anderen Benutzer gehört, konnte die Versionsbereinigung älterer Versionen diesen Prozess fälschlich als beendet einstufen und die von ihm verwendete ausführbare Datei löschen. Ein verwandtes Problem tritt auf, wenn ein Update oder die Versionsbereinigung die Binärdatei eines noch laufenden Prozesses löscht: Remote-Control-Hosts, Hintergrund-Daemons und selbst gehostete Runner melden beim Start neuer Sitzungen spawn ENOENT. Beide Probleme wurden in v2.1.318 behoben. In gemeinsam genutzten Umgebungen empfiehlt es sich dennoch, Claude Code nicht mit sudo auszuführen.
Claude Code v2.1.318 im Vergleich: gemeinsames Home-Verzeichnis
| Szenario | Vor v2.1.318 | Ab v2.1.318 |
|---|---|---|
| Schreiben der Konfiguration im gemeinsamen Home-Verzeichnis schlägt fehl | Abmeldung und Entfernung von MCP werden weiterhin als erfolgreich gemeldet; Änderungen an Vertrauens- und MCP-Einstellungen gehen stillschweigend verloren | Erfolg wird nicht mehr fälschlich gemeldet |
Ungültiges JSON in ~/.claude.json |
Beim nicht interaktiven Start durch Standardwerte überschrieben | Start schlägt fehl, Wiederherstellungshinweise werden angezeigt und die Originaldatei bleibt erhalten |
Leere ~/.claude.json ohne Backup |
Wird als beschädigt gemeldet | Normaler Start wie bei einer fehlenden Datei |
| Anmeldung abgelaufen | Nur eine allgemeine Meldung über die fehlgeschlagene Anmeldung | Klarer Hinweis auf den Ablauf sowie auf claude auth login und claude setup-token |
| Ablaufwarnung | Keine | Warnung über stderr 10 Tage im Voraus; Ablaufzeit über den Statusbefehl abrufbar |
| Unbeaufsichtigter Betrieb | ~/.claude.json wird bei jedem Lauf neu geschrieben |
Keine erneute Schreiboperation, wenn sich der Inhalt nicht geändert hat |
Die Tabelle zeigt den Ansatz hinter den Korrekturen in v2.1.318: Fehler werden wahrheitsgemäß gemeldet, und bei beschädigten Konfigurationen bleiben die Nutzerdaten nach Möglichkeit erhalten. Für den Betrieb bedeutet das: Situationen, in denen alles normal aussieht, obwohl bereits etwas schiefgelaufen ist, treten seltener auf. Probleme werden früher sichtbar und lassen sich leichter untersuchen.
Für umfangreiche Batch-Verarbeitung auf einem gemeinsam genutzten Cluster ist ein Ansatz: Für die interaktive Entwicklung weiterhin die Kontoanmeldung verwenden, für Batch-Jobs dagegen ein mit setup-token erzeugtes Token oder direkt die API-Authentifizierung. So kommen sich die jeweiligen Zugangsdaten nicht in die Quere.
Claude Code per API anbinden und Login-Probleme bei gemeinsamem Home-Verzeichnis umgehen
Viele Login-Probleme bei einem gemeinsam genutzten Home-Verzeichnis haben dieselbe Ursache: Mehrere Stellen verwenden dieselben claude.ai-Zugangsdaten. Wenn Batch-Aufträge stattdessen per API-Schlüssel authentifiziert werden, lassen sich die Zugangsdaten über Umgebungsvariablen bereitstellen. Sie sind dann nicht mehr von den im Home-Verzeichnis gespeicherten Login-Dateien abhängig. Die zuvor beschriebenen Probleme mit gegenseitigen Abmeldungen auf verschiedenen Hosts und ablaufenden Logins treten damit praktisch nicht mehr auf. Claude Code unterstützt Umgebungsvariablen wie ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN, um API-Endpunkt und Schlüssel festzulegen. Welche Variablennamen für welche Version gelten, steht in der offiziellen Dokumentation.
🎯 Technischer Tipp: APIYI apiyi.com bietet API-Aufrufe für Modelle der Claude-Familie und unterstützt sowohl das native Anthropic- als auch das OpenAI-Schnittstellenformat. So lässt sich ein einheitlicher Endpunkt für Claude Code und andere Tools konfigurieren. Informationen zur Base URL, zum Erstellen eines Schlüssels und Konfigurationsbeispiele für einzelne Tools finden Sie im Dokumentationszentrum von APIYI unter docs.apiyi.com.
| Vergleichskriterium | Anmeldung mit claude.ai-Konto | API-Zugang per Schlüssel (z. B. APIYI) |
|---|---|---|
| Speicherung der Zugangsdaten | Gespeicherter Login im Home-Verzeichnis | Umgebungsvariablen oder Schlüsselverwaltungssystem |
| Auswirkungen eines gemeinsamen Home-Verzeichnisses | Gemeinsame Nutzung durch mehrere Rechner; Probleme bei paralleler Nutzung und ablaufenden Logins | Für jeden Auftrag separat bereitgestellt, keine gegenseitige Beeinträchtigung |
| Verwaltung der Gültigkeit | loginExpiresAt muss beachtet werden | Abhängig von Gültigkeitsdauer und Kontingent des Schlüssels |
| Schnittstellenformat | In Claude Code integriert | Kompatibel mit Anthropic- und OpenAI-Format |
| Abrechnung | Nach Abonnement und Nutzungsregeln des Kontos | Massgeblich sind die aktuellen Angaben auf der APIYI-Preisseite docs.apiyi.com/models |
💰 Hinweis zu den Kosten: Für Abrechnungsdetails wie Modellpreise, Preise für Ein- und Ausgaben sowie Cache-Preise gelten die aktuellen Angaben auf der APIYI-Preisseite docs.apiyi.com/models. Dieser Artikel nennt keine konkreten Zahlen, um durch Preisänderungen keine falschen Angaben zu machen.
Häufige Fragen (FAQ)
Q1: Was ist ein „gemeinsam genutztes Home-Verzeichnis im Netzwerk“ und warum treten dort bei Claude Code häufiger Probleme auf?
Ein gemeinsam genutztes Home-Verzeichnis wird über ein Netzwerkdateisystem wie NFS eingebunden und von mehreren Hosts verwendet. Claude Code speichert globale Konfigurationen, Einstellungen und Anmeldedaten im Home-Verzeichnis. Gleichzeitige Schreibzugriffe mehrerer Prozesse, irreführende Meldungen des Dateisystem-Caches oder ungewöhnliches Schreibverhalten bei ausgeschöpftem Speicherplatzkontingent können dazu führen, dass Konfigurationen verloren gehen oder Anmeldungen ungültig werden.
Q2: Was hat sich für Claude Code in gemeinsam genutzten Home-Verzeichnissen mit v2.1.318 geändert?
Ältere Versionen meldeten bei fehlgeschlagenen Schreibvorgängen unter Umständen trotzdem Erfolg oder überschrieben beschädigte Konfigurationen mit Standardwerten. Ab v2.1.318 werden Fehler korrekt gemeldet, die Originaldatei bleibt erhalten und es gibt Hinweise zur Wiederherstellung. Zudem wurde das Speichern von Konfigurationsdateien in gemeinsam genutzten Home-Verzeichnissen stabiler gemacht und ein Feld für den Ablaufzeitpunkt der Anmeldung hinzugefügt.
Q3: Wann wurden diese Fehlerkorrekturen veröffentlicht?
Die Korrekturen sind in Claude Code v2.1.318 enthalten. Als Veröffentlichungsdatum ist im GitHub Release der 4. November angegeben. Mit `claude –version` können Sie Ihre lokale Version prüfen. Bei einer älteren Version empfiehlt sich vor der Fehlersuche ein Upgrade.
Q4: Hintergrundaufgaben melden ständig „Not logged in“. Was kann ich tun?
Prüfen Sie zuerst, ob sich jemand an einem anderen Terminal oder Host mit demselben Konto und Home-Verzeichnis erneut angemeldet hat. Ab v2.1.318 ist dieses Problem bei demselben Konto und derselben Organisation behoben. Bei Anmeldungen über Organisationsgrenzen hinweg oder abgelaufenen Anmeldedaten empfiehlt sich für lang laufende Aufgaben ein mit `claude setup-token` erzeugtes Token oder die Authentifizierung per API-Schlüssel.
Q5: Wie kann Claude Code Modelle per API aufrufen, ohne sich über ein Konto anzumelden?
Sie können für Claude Code einen API-Endpunkt und einen Schlüssel über Umgebungsvariablen festlegen. APIYI apiyi.com bietet API-Aufrufe für Modelle der Claude-Reihe und unterstützt die Schnittstellenformate von Anthropic und OpenAI. Der Dienst kann als einheitlicher Endpunkt verwendet werden. Die konkreten Einrichtungsschritte finden Sie in der Dokumentation unter docs.apiyi.com; für die Abrechnung gilt die Preisseite unter docs.apiyi.com/models.
Q6: ~/.claude.json ist beschädigt. Kann ich die Datei einfach löschen und neu erstellen?
Davon ist abzuraten. Bei ungültigem JSON bricht die neue Version den Start ab und zeigt einen Wiederherstellungsbefehl an. Stellen Sie die Datei möglichst anhand dieser Hinweise aus einem Backup wieder her. Ist die Datei leer und kein Backup vorhanden, startet die neue Version so, als würde die Datei fehlen. Zuvor konfigurierte MCP-Server und vertrauenswürdige Verzeichnisse müssen Sie dann erneut hinzufügen.
Q7: Welche bekannten Einschränkungen bestehen nach dem Upgrade auf v2.1.318 in gemeinsam genutzten Home-Verzeichnissen noch?
Die Versionshinweise weisen ausdrücklich darauf hin: Obwohl `claude mcp add/remove` inzwischen eine Sperre verwendet, kann eine andere Aufgabe beim Speichern der Konfiguration einen gerade gespeicherten Servereintrag weiterhin überschreiben. Auch Probleme durch knappen Speicherplatz oder aggressives Caching des Dateisystems lassen sich nur teilweise entschärfen. Bei vielen gleichzeitigen Zugriffen empfiehlt es sich, Konfigurationsänderungen nacheinander vorzunehmen oder getrennte Anmeldedaten für Stapelverarbeitung und interaktive Nutzung zu verwenden.
Claude Code im gemeinsam genutzten Home-Verzeichnis: Das Wichtigste zur Fehlerbehebung
- Zuerst die Version prüfen: Claude Code sollte mindestens v2.1.318 verwenden. Viele Probleme mit gemeinsam genutzten Home-Verzeichnissen lassen sich durch ein Upgrade beheben.
- Ablauf der Anmeldung frühzeitig erkennen: Das Feld
loginExpiresAtinclaude auth statuszeigt an, wann die Anmeldung abläuft. - Konfiguration nicht vorschnell löschen: Bei Problemen mit
~/.claude.jsonden Wiederherstellungsbefehl der neueren Version verwenden, um die bestehende Konfiguration zu erhalten. - Änderungen nacheinander ausführen: MCP-Konfigurationen zentral auf einem Rechner ändern, damit sich Hosts nicht gegenseitig überschreiben.
- Speicherplatz im Blick behalten: Ist das Home-Verzeichnis voll, können Zugangsdaten geleert werden. Deshalb das Kontingent regelmässig prüfen.
- Zugangsdaten für Batch-Jobs trennen: Für lang laufende Aufgaben ein mit setup-token erzeugtes Token oder einen API-Schlüssel verwenden, getrennt von der interaktiven Anmeldung.
- API-Zugang als Option: APIYI unterstützt die Formate von Anthropic und OpenAI. Für die Abrechnung gelten die Angaben auf docs.apiyi.com/models.
Zusammenfassung
Die wichtigsten Punkte zur Fehlerbehebung bei Konfiguration und Anmeldung von Claude Code in einem gemeinsam genutzten Netzwerk-Home-Verzeichnis:
- Version hat Vorrang: v2.1.318 behebt mehrere Probleme, darunter fälschlich als erfolgreich gemeldete Abmeldungen, durch Anmeldungen auf anderen Hosts unterbrochene Aufgaben sowie überschriebene oder geleerte Konfigurationen. Ein Upgrade ist daher der erste Schritt.
- Anhand der Symptome eingrenzen: Bei verlorenen Konfigurationen zuerst
~/.claude.jsonund die zugehörigen Backups prüfen. Bei ungültigen Anmeldungen das Ablaufdatum und die Datei mit den Zugangsdaten kontrollieren. Bei unterbrochenen Aufgaben auf gleichzeitige Schreibzugriffe und das Speicherkontingent achten. - Zugangsdaten nach Einsatzzweck trennen: Für die interaktive Entwicklung die Kontoanmeldung nutzen, für Batch-Jobs ein Token oder einen API-Schlüssel. So lassen sich Konflikte durch das gemeinsam genutzte Home-Verzeichnis von vornherein reduzieren.
Wenn Teams Claude Code in grossem Umfang auf einem gemeinsam genutzten Cluster einsetzen, lohnt es sich, die Authentifizierung klar zu planen. Wer einen einheitlichen API-Endpunkt benötigt, kann die Integrationsdokumentation von APIYI unter apiyi.com beziehungsweise docs.apiyi.com zur Bewertung heranziehen. Für die Abrechnung gelten die aktuellen Angaben auf docs.apiyi.com/models.
📚 Referenzen
- Claude Code v2.1.318 Release Notes: Quelle für alle in diesem Artikel beschriebenen Korrekturen
- Link:
github.com/anthropics/claude-code/releases/tag/v2.1.318 -
Inhalt: Vollständige Versionshinweise, unter anderem zu gemeinsamen Home-Verzeichnissen im Netzwerk, abgelaufenen Anmeldungen und der Wiederherstellung von
~/.claude.json -
APIYI Dokumentationszentrum: Informationen zur API-Anbindung und Tool-Konfiguration
- Link:
docs.apiyi.com -
Inhalt: Base URL, Beschaffung von API-Schlüsseln und Anbindung im Anthropic- oder OpenAI-Format
-
APIYI Modellpreisseite: Maßgebliche Quelle für die Modellpreise
- Link:
docs.apiyi.com/models - Inhalt: Die aktuellen Angaben auf dieser Seite sind für Eingabe- und Ausgabepreise, Cache-Preise und weitere Abrechnungsdetails maßgeblich
Autor: APIYI Technikteam
Technischer Austausch: Bei Fragen zur Bereitstellung von Claude Code in gemeinsam genutzten Umgebungen können Sie uns über die APIYI-Startseite apiyi.com kontaktieren. Weitere Informationen zur Anbindung finden Sie im Dokumentationszentrum unter docs.apiyi.com.
