著者注：Claude Code v2.1.318 のリリースノートをもとに、共有ネットワーク上の home ディレクトリで Claude Code の設定が消える、「Not logged in」と表示される、ログインが期限切れになるなど、7 種類の問題の原因とトラブルシューティング手順を整理します。
大学のコンピューター室や HPC クラスター、企業の踏み台サーバーといった環境では、ユーザーの home ディレクトリが NFS などのネットワークファイルシステムにマウントされ、複数のホストで同じ ~ を共有していることがよくあります。このような環境で Claude Code を使うと、MCP サーバーの設定が翌日には消えている、ログアウトした直後に再び自動ログインする、バックグラウンドタスクで突然 Not logged in と表示される、~/.claude.json が空になる、といった問題が起こることがあります。この記事では、共有ネットワーク上の home ディレクトリにおける Claude Code の設定とログインのトラブルシューティング方法を紹介し、問題がバージョン、ファイルシステム、認証情報のどこにあるのかを見極めます。
これは経験則を寄せ集めた、根拠のないチェックリストではありません。 2026 年 11 月 4 日にリリースされた Claude Code v2.1.318 では、リリースノートに記載されているとおり、「共有ネットワーク上の home ディレクトリ」に関連する複数の問題がまとめて修正されました。この記事のトラブルシューティング手順は、すべてこのリリースノートに基づいています。
この記事でわかること：症状から共有 home での Claude Code の設定やログインの不具合を特定し、アップグレードすべきか、バックアップを復元すべきか、別の認証方法に切り替えるべきかを判断できます。
共有ネットワーク上の home ディレクトリにおける Claude Code の設定とログインの要点
まず全体像を見てみましょう。Claude Code は home ディレクトリ内で、主に3種類の状態を管理しています。グローバル設定ファイル ~/.claude.json（MCP サーバーや信頼済みディレクトリなど）、settings 設定ファイル、保存されたログイン認証情報です。共有ネットワーク上の home では、複数のプロセスやホストがこれらのファイルを同時に読み書きします。また、ネットワークファイルシステムのロック、キャッシュ、クォータの動作はローカルディスクとは異なります。次の表は、v2.1.318 でこれらに直接関係する変更点をまとめたものです。
| 要点 | 内容 | メリット |
|---|---|---|
| 書き込み失敗時に「成功」と表示されなくなった | 共有 home 上で設定を更新できない場合、/logout、claude auth logout、claude mcp remove は成功を報告しなくなった |
「ログアウトしたつもりが、実際にはできていなかった」という事態を防げる |
| 別のホストで再ログインしてもタスクが中断されなくなった | 同じ home を使う別のターミナルやホストで、同じアカウントと組織に再ログインしても、実行中のタスクが Not logged in によって終了しなくなった | 複数マシンでの並列タスクがより安定する |
| MCP 設定の書き込みをロック | claude mcp add/remove は設定のロックを待ち、ロックを取得できない場合は終了コード 1 で終了する |
同時書き込みによる設定の破損を減らせる |
| ログインの有効期限を確認可能に | claude auth status に loginExpiresAt が追加され、claude -p の JSON 結果に credential_expires_at が追加された |
期限が近いログインを早めに把握できる |
| 設定ファイルの耐障害性が向上 | 共有 home 上で ~/.claude.json、設定ファイル、ログイン認証情報を保存する際、削除、一時的な空ファイル化、古いコピーによる上書きが起きにくくなった |
設定が「突然消える」リスクを減らせる |
共有 home で Claude Code の設定に問題が起きやすい理由
ローカルディスクでは、Claude Code の設定保存は基本的にアトミックな操作と見なせます。一方、ネットワークファイルシステムでは、「一時ファイルに書き込んでから置き換える」「ファイルの存在を確認する」といった操作がクライアントのキャッシュに影響され、ファイルが実際には存在するのに存在しないと報告されることがあります。旧バージョンでは、設定が存在しないと判断され、次回起動時に MCP サーバーや信頼済みディレクトリが消えてしまうことがありました。v2.1.318 では、設定ファイルが存在しないと誤って報告された場合に再確認するようになり、空の設定で起動するケースが減っています。
もう一つの懸念点はディスククォータです。更新情報では、ネットワーク上の home にデータを書き込む空き容量がなくても、新しいファイルの作成は許可されるケースが挙げられています。この状態でログイン認証情報を保存すると、認証情報ファイルが空のファイルに置き換えられ、ユーザーがログアウトされてしまいます。この問題は新バージョンで修正されました。利用しているクラスターで home のクォータが厳しく制限されている場合は、引き続き df やクラスター付属の quota コマンドで定期的に空き容量を確認することをおすすめします。
共有 home における Claude Code ログインの並行処理の問題
ログイン状態も問題が発生しやすい領域です。同じ home を複数のホストで共有している場合、以前はマシン A で claude auth login を実行して再ログインすると、マシン B で実行中の claude -p バッチ処理が Not logged in と表示して終了することがありました。v2.1.318 では、同じアカウント・同じ組織を使用していることを前提に、この問題が修正されています。
また、以前は claude plugin 系のコマンドが、時間のかかるトークン更新の保存が完了する前に終了し、次回実行時にログアウトされていることがありました。この問題も修正されています。
さらに、少しわかりにくい問題もありました。同じマシン上の別のログインで allowedProviders リストが保存されると、セッションの起動時にそのリストによってアクセスが拒否されることがありました。これは、複数人で踏み台サーバーを共有している場合や、同じユーザーが異なる組織を切り替えてログインする場合に起きやすい問題です。新バージョンでは、このような誤った拒否は発生しなくなりました。
共有 home ディレクトリでの Claude Code トラブルシューティング入門
この記事では、コードブロックを使わず、コマンドやフィールドをインラインで表記します。トラブルシューティングは4つのステップに分けられます。順番に進めるのがおすすめです。
ステップ1：Claude Code のバージョンとログイン状態を確認する
まず、claude --version を実行してバージョンを確認します。v2.1.318 より古い場合は、claude update または元のインストール方法でアップグレードすることをおすすめします。この記事で紹介する問題の多くは、旧バージョンでは回避できても、根本的には解決できないためです。アップグレード後は claude auth status を実行し、現在のアカウントと組織に加え、新しく追加された loginExpiresAt フィールドを確認します。
主にスクリプトから claude -p を呼び出している場合は、結果を JSON 形式で出力し、パイプラインで credential_expires_at フィールドを読み取ることで、有効期限が切れる前にアラートを出せます。テキスト出力モードでは、新しいバージョンは保存済みの claude.ai ログインの有効期限が切れる10日前から、stderr に警告を1行出力します。ログを確認してください。
| コマンド/フィールド | 用途 | トラブルシューティング時の確認ポイント |
|---|---|---|
claude --version |
現在のバージョンを確認 | v2.1.318 以上か |
claude auth status |
ログイン状態を確認 | loginExpiresAt が近づいていないか |
claude -p（JSON 出力） |
無人環境での呼び出し | credential_expires_at フィールド |
claude auth login |
claude.ai アカウントに再ログイン | ログインの有効期限が切れたら案内に従って実行 |
claude setup-token |
無人環境用のトークンを生成 | CI やバッチ処理に適している |
claude mcp add / claude mcp remove |
MCP サーバーを管理 | 終了コード 1 は設定ロックを取得できなかったことを示す |
ステップ2：~/.claude.json が正常か確認する
~/.claude.json の破損は、home ディレクトリを共有している環境で「設定がすべて消えた」ように見える最も一般的な原因です。v2.1.318 では、関連する処理がいくつか変更されました。非対話モードでの起動時に、このファイルが有効な JSON ではないことを検出した場合、デフォルト値で上書きせずに起動を中止します。復元方法を案内し、元のファイルはそのまま保持します（issue #87551）。また、ファイルが空でバックアップもない場合、新バージョンでは破損と報告せず、「ファイルが存在しない」場合と同じように正常に起動します。
新バージョンが表示する復元コマンドも、より信頼できるようになりました。以前は、空または途中で切れたバックアップを復元コマンドが参照したり、ファイルが読み取り専用の場合に失敗したりすることがありましたが、いずれも修正されています。また、claude -p だけを実行する home ディレクトリでは、以前は保持期間に基づくクリーンアップ時に ~/.claude.json の最後のバックアップまで削除されることがありました。現在は、新しいバックアップを作成してから古いものを削除します。
ステップ3：ログインの無効化と認証情報の期限切れに対処する
ログイン失敗のエラーが出た場合は、まずメッセージに「保存された claude.ai ログインの有効期限が切れた」と明記されているか確認してください。新バージョンではこの点が明示され、claude -p の場合は claude auth login と claude setup-token の2つの対処方法が提示されます。対話的に使用する場合は前者を、バックグラウンドで長期間実行するタスクには一般的に後者を選ぶとよいでしょう。
forceLoginOrgUUID（指定した組織へのログインを強制する設定）が有効なマシンでは、旧バージョンに問題がありました。トークンが許可された組織に属していても、setup-token で生成したトークンを使って起動すると拒否されることがあったのです。この問題は v2.1.318 で修正されています。企業環境でこの現象に遭遇した場合は、アップグレードによって解決できることがほとんどです。
ステップ4：並行書き込みのリスクを減らす
複数のホストが同時に MCP 設定を変更することは、home を共有する環境におけるリスクです。新しいバージョンの claude mcp add と claude mcp remove は設定のロックを待機し、取得できなければ終了コード 1 で終了します。ロックなしで書き込むことはなくなりました。ただし、更新情報には、別のタスクが設定を保存した際に、直前に保存したサーバーのエントリが上書きされる可能性があるとも記載されています。MCP 設定をまとめて変更する場合は、できるだけ1台のホストで順番に実行しましょう。
また、無人実行（claude -p や SDK アプリケーション）では、設定内容に変更がなければ ~/.claude.json を毎回書き直さなくなりました。これにより、大量の並列タスクによる設定ファイルへの書き込み負荷が大幅に減ります。クラスターでまだ旧バージョンを使って大量のタスクを実行している場合は、これもアップグレードする理由の一つです。
🚀 クイックスタート：チームでクラスター上の Claude Code を使ってバッチ処理を実行していて、claude.ai アカウントのログイン期限の影響を受けたくない場合は、API 経由での接続に切り替えられます。APIYI apiyi.com は Claude シリーズのモデルへの API 呼び出しを提供し、OpenAI と Anthropic の両方のインターフェース形式に対応しています。接続方法はドキュメントセンター docs.apiyi.com をご覧ください。
home 共有環境における Claude Code のトラブル対照表
よくある症状、考えられる原因、対処方法をまとめました。トラブルシューティングの際は、症状から確認できます。
| 症状 | 考えられる原因 | 対処方法 |
|---|---|---|
/logout が成功したと表示されるが、次回起動時もログイン状態のまま |
旧バージョンでは、共有 home 上での設定書き込みに失敗しても成功と報告していた | v2.1.318 にアップグレードし、claude auth logout を実行して結果を確認する |
| バックグラウンドタスクで突然 Not logged in と表示される | 別のターミナルやホストが同じ home 上で再ログインした | アップグレードする。同じアカウント・同じ組織の場合は修正済み |
| 起動後、MCP サーバーと信頼済みディレクトリがすべて消える | ネットワークファイルシステムが設定ファイルの欠落を誤って報告した | アップグレードして再確認のロジックを有効にし、必要に応じてバックアップから復元する |
| ログイン認証情報のファイルが空になる | home の空き容量がなくなったが、新しいファイルは作成できた | 容量の上限を解消してから再ログインし、アップグレードする |
| 非対話モードでの起動が失敗し、復元を促される | ~/.claude.json が有効な JSON ではない |
表示された復元コマンドに従い、手動で上書きしない |
| 起動時に allowedProviders によって拒否される | 同じマシンでの別のログインによって保存されたリストが影響している | アップグレード後に再試行する |
| すべてのネットワーク接続に失敗する | NODE_EXTRA_CA_CERTS が空のファイルまたは PEM 形式ではないファイルを指している | 新バージョンでは読み取り可能な証明書を使用し、stderr に警告を出す。証明書ファイルも修正する |
ユーザーをまたぐシナリオについても、別途説明します。誰かが sudo claude で起動したプロセスが別のユーザーに属した状態で実行されていると、旧バージョンのバージョン整理処理が、そのプロセスを終了済みと誤認し、使用中の実行ファイルを削除することがありました。関連する問題として、更新やバージョン整理によって実行中のプロセスのバイナリが削除されると、remote-control ホスト、バックグラウンドデーモン、セルフホスト型 runner が新しいセッションを開始する際に spawn ENOENT が発生していました。どちらの問題も v2.1.318 で修正されています。共有環境では、引き続き sudo で Claude Code を実行しないことをおすすめします。
Claude Code v2.1.318 前後の比較：共有 home 環境
| 状況 | v2.1.318 より前 | v2.1.318 以降 |
|---|---|---|
| 共有 home の設定書き込みに失敗 | ログアウトや MCP の削除が成功と報告され、信頼設定や MCP 設定の変更が黙って失われる | 成功したと誤って報告されなくなる |
~/.claude.json が無効な JSON |
非対話モードでの起動時にデフォルト値で上書きされる | 起動に失敗し、復旧方法が提示される。元のファイルは保持される |
~/.claude.json が空で、バックアップもない |
破損していると報告される | ファイルが存在しないものとして正常に起動する |
| ログインの有効期限切れ | 漠然としたログイン失敗の通知のみ | 有効期限切れを明示し、claude auth login と claude setup-token を案内 |
| 有効期限の事前警告 | なし | 10 日前に stderr に警告を出力。ステータスコマンドで有効期限を確認可能 |
| 無人での実行 | 実行のたびに ~/.claude.json を書き換える |
内容に変更がなければ書き換えない |
この表からわかるように、v2.1.318 の修正方針は、失敗を正確に報告し、設定が破損した場合もユーザーデータをできる限り守ることです。運用担当者にとっては、これまでのような「正常に見えるのに、実際にはエラーが起きている」状況が大幅に減り、問題を早期に発見できるため、調査の負担も軽くなります。
共有クラスタで大規模なバッチ処理を行う場合は、対話的な開発では引き続きアカウントログインを使い、バッチ処理では setup-token で生成したトークン、または API による認証を使うとよいでしょう。こうすれば、両者の認証情報が互いに干渉せず、より安定して運用できます。
Claude Code を API 経由で利用し、共有 home でのアカウントログイン問題を回避する
共有 home で発生するログイン問題の多くは、複数の環境で同じ claude.ai のログイン認証情報を共有していることが原因です。バッチ処理を APIキー認証に切り替えれば、認証情報は環境変数から渡され、home ディレクトリに保存されたログインファイルに依存しなくなります。前述の、ホスト間で互いにログアウトさせてしまう問題やログインの有効期限切れも、基本的には発生しなくなります。Claude Code では、ANTHROPIC_BASE_URL や ANTHROPIC_AUTH_TOKEN などの環境変数を使って、API エンドポイントとキーを指定できます。具体的な変数名と対応バージョンは、公式ドキュメントを確認してください。
🎯 技術的なアドバイス：APIYI apiyi.com は Claude シリーズのモデル呼び出しを提供し、Anthropic ネイティブ形式と OpenAI 形式の両方に対応しています。Claude Code やその他のツールに共通のエンドポイントを設定する際に便利です。Base URL、キーの取得方法、各ツールの設定例については、APIYI のドキュメントセンター docs.apiyi.com を確認してください。
| 比較項目 | claude.ai アカウントでのログイン | APIキーによる接続（APIYI など） |
|---|---|---|
| 認証情報の保存先 | home ディレクトリに保存されたログイン情報 | 環境変数またはシークレット管理システム |
| 共有 home の影響 | 複数のマシンで共有するため、同時利用や有効期限の問題がある | タスクごとに個別に渡すため、互いに干渉しない |
| 有効期限の管理 | loginExpiresAt の確認が必要 | キー自体の有効期限と利用枠によって決まる |
| インターフェース形式 | Claude Code に組み込み | Anthropic 形式と OpenAI 形式に対応 |
| 課金の基準 | アカウントのサブスクリプションと使用量の規則に従う | APIYI の料金ページ docs.apiyi.com/models の実際のデータを参照 |
💰 コストについて：モデルの料金、入力・出力の単価、キャッシュ料金などの詳細は、APIYI の料金ページ docs.apiyi.com/models の最新データを確認してください。価格改定による誤解を避けるため、この記事では具体的な金額を記載していません。
よくある質問 FAQ
Q1：「共有ネットワーク上の home ディレクトリ」とは何ですか？ なぜ Claude Code で問題が起きやすいのですか？
共有ネットワーク上の home ディレクトリとは、NFS などのネットワークファイルシステムを通じてマウントされ、複数のホストで共有されるユーザーのホームディレクトリです。Claude Code はグローバル設定やログイン認証情報をすべて home 以下に保存するため、複数プロセスによる同時書き込み、ファイルシステムのキャッシュによる誤判定、クォータ上限到達時の異常な書き込みなどによって、設定の消失やログインの失効が起こる可能性があります。
Q2：v2.1.318 の前後で、共有 home 上の Claude Code はどう変わりましたか？
旧バージョンでは、書き込みに失敗してもエラーを出さずに成功と報告したり、破損した設定をデフォルト値で上書きしたりする場合がありました。v2.1.318 ではエラーを正しく報告し、元のファイルを保持して復旧方法を提示するようになりました。また、共有 home 上での設定ファイルの保存も安定性が向上し、ログインの有効期限を示すフィールドも追加されました。
Q3：これらの修正はいつリリースされましたか？
関連する修正は Claude Code v2.1.318 に含まれており、GitHub Release に記載されたリリース日は 11 月 4 日です。`claude –version` でローカルのバージョンを確認できます。これより古い場合は、問題を調査する前にアップグレードすることをおすすめします。
Q4：バックグラウンドタスクで Not logged in と繰り返し表示される場合は、どうすればよいですか？
まず、同じ home を使う別のターミナルやホストで、同じアカウントに再ログインしていないか確認してください。v2.1.318 では、同じアカウント・同じ組織でのこの問題が修正されています。組織をまたいでログインしている場合や、認証情報の有効期限が切れている場合は、長時間実行するタスクに `claude setup-token` で生成したトークンを使うか、APIキー認証に切り替えることをおすすめします。
Q5：アカウントにログインせず、Claude Code から API 経由でモデルを呼び出すにはどうすればよいですか？
環境変数で Claude Code に API エンドポイントとキーを指定できます。APIYI apiyi.com は Claude シリーズのモデルを API 経由で利用できるサービスを提供しており、Anthropic と OpenAI のインターフェース形式に対応しているため、統一エンドポイントとして利用できます。具体的な設定手順は docs.apiyi.com のドキュメント、料金は価格ページ docs.apiyi.com/models を参照してください。
Q6：~/.claude.json が壊れた場合、削除して作り直してもよいですか？
直接削除することはおすすめしません。新バージョンでは無効な JSON を検出すると起動を停止し、復旧コマンドを提示します。まずは案内に従ってバックアップから復元してください。ファイルが空でバックアップもない場合、新バージョンはファイルが存在しない場合と同様に正常に起動しますが、以前設定した MCP サーバーと信頼済みディレクトリは再度追加する必要があります。
Q7：v2.1.318 にアップグレードした後も、共有 home にはどのような既知の制限がありますか？
更新情報には、`claude mcp add/remove` にロックが追加されたものの、別のタスクが設定を保存する際に、保存したばかりのサーバー項目が上書きされる可能性があると明記されています。クォータの不足やファイルシステムの過度なキャッシュなどの問題も、一部しか緩和できません。同時実行が多い環境では、設定の変更を順番に行うか、バッチ処理と対話的な利用で認証情報を分けることをおすすめします。
共有 home ディレクトリでの Claude Code トラブルシューティングの要点 Key Takeaways
- まずバージョンを確認：トラブルシューティングの前に、Claude Code が v2.1.318 以降であることを確認しましょう。共有 home に関する問題の多くは、アップグレードで解決できます
- ログイン期限を事前に確認：
claude auth statusの loginExpiresAt フィールドで、ログインの有効期限が近づいていないか確認できます - 設定をむやみに削除しない：
~/.claude.jsonに異常がある場合は、新バージョンが提示する復旧コマンドに従い、既存の設定を維持しましょう - 並行変更は避ける：MCP の設定変更は1台のマシンでまとめて行い、ホスト間で互いの変更を上書きしないようにします
- クォータに注意：home の容量を使い切ると認証情報が消去される可能性があるため、定期的に確認しましょう
- バッチ処理の認証情報を分ける：長時間実行するタスクには setup-token で生成したトークンまたは APIキーを使い、対話的なログインと分離します
- API 接続も選択肢に：APIYI は Anthropic と OpenAI の形式に対応しています。料金は docs.apiyi.com/models を参照してください
まとめ
共有ネットワーク上の home ディレクトリで、Claude Code の設定やログインに関する問題を解決する際のポイントは次のとおりです。
- バージョンを優先的に確認：v2.1.318 では、ログアウトが成功したように見える問題や、別ホストでのログインによってタスクが中断される問題、設定が上書き・消去される問題などがまとめて修正されています。まずはアップグレードしましょう。
- 症状に応じて原因を特定：設定が失われた場合は
~/.claude.jsonとそのバックアップを、ログインが無効になった場合は有効期限と認証情報ファイルを、タスクが中断された場合は並行書き込みとディスククォータを確認します。 - 認証情報を使い分ける：対話的な開発にはアカウントログインを、バッチ処理にはトークンまたは APIキーを使い、共有 home に起因する競合を減らします。
チームが共有クラスターで Claude Code を大規模に利用する場合は、認証方式を整理しておくとよいでしょう。統一された API エンドポイントが必要なら、APIYI apiyi.com の接続ドキュメント docs.apiyi.com を参考に検討できます。料金の詳細は、価格ページ docs.apiyi.com/models の実際の情報を確認してください。
📚 参考資料
- Claude Code v2.1.318 Release Notes：本記事の修正内容に関する情報源
- リンク：
github.com/anthropics/claude-code/releases/tag/v2.1.318 -
内容：共有ネットワーク上のホームディレクトリ、ログインの有効期限切れ、
~/.claude.jsonの復元など、すべての更新内容を掲載 -
APIYI ドキュメントセンター：API 接続とツールの設定に関する説明
- リンク：
docs.apiyi.com -
内容：Base URL、APIキーの取得方法、Anthropic と OpenAI の両形式での接続方法
-
APIYI モデル料金ページ：モデル料金の公式情報源
- リンク：
docs.apiyi.com/models - 内容：入力・出力の単価やキャッシュ料金などは、このページの最新情報をご確認ください
著者：APIYI 技術チーム
技術交流：共有環境での Claude Code の導入にお困りの方は、APIYI のホームページ apiyi.com からお気軽にお問い合わせください。接続に関する詳しい資料は、docs.apiyi.com のドキュメントセンターをご覧ください。
