Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE 環境変数を追加 — git pull が失敗した場合に既存のマーケットプレイスキャッシュを保持する。オフライン環境で有用。

原文（英語） ​

Added CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE env var to keep the existing marketplace cache when git pull fails, useful in offline environments

概要 ​

CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE 環境変数を設定することで、プラグインマーケットプレイスの git pull が失敗した際に既存のキャッシュを維持できます。これにより、ネットワーク接続のないオフライン環境でも、以前に取得したマーケットプレイス情報を継続して利用できます。インターネット接続が制限された企業環境や、エアギャップ環境での開発に特に有用です。

基本的な使い方 ​

環境変数を設定してClaude Codeを起動します：

bash
export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1
claude

または、.bashrc / .zshrc に追記して永続化します：

bash
echo 'export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1' >> ~/.bashrc

実践例 ​

オフライン環境での開発 ​

インターネット接続のない環境（エアギャップ環境）での使用：

bash
# オフライン環境用の設定
export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1
export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=true

# Claude Codeを起動（git pullが失敗してもキャッシュを使用）
claude

CI/CD環境での安定動作 ​

ネットワークが不安定なCI環境での使用：

yaml
# .github/workflows/claude.yml
env:
  CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE: "1"

企業プロキシ環境 ​

プロキシ経由でのアクセスが制限されている企業ネットワーク環境：

bash
# 企業環境の設定ファイルに追加
export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1

注意点 ​

  • この環境変数が設定されていない場合（デフォルト）、git pull 失敗時にマーケットプレイスキャッシュがクリアされる可能性があります
  • キャッシュが古い状態になる可能性があるため、オンライン環境に戻った際はキャッシュを更新することをおすすめします
  • この設定はオフライン環境専用であり、通常のオンライン環境では不要です

関連情報 ​