Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

/plugin および claude plugin update を改善しました：マーケットプレイスを更新できなかった場合、古いバージョンを表示するのではなく警告を表示するようになりました。

原文（英語） ​

Improved /plugin and claude plugin update to show a warning when the marketplace could not be refreshed, instead of silently reporting a stale version

概要 ​

以前は、プラグインマーケットプレイスへの接続に失敗した場合、古いキャッシュデータが警告なしに表示されていました。このアップデートにより、マーケットプレイスの更新に失敗した場合に明示的な警告が表示されるようになりました。ユーザーは表示されているバージョン情報が最新かどうかを明確に把握できます。

基本的な使い方 ​

bash
# プラグインの更新を確認（ネットワークに接続されている場合）
/plugin update

# マーケットプレイスに接続できない場合（改善後）
# 警告: マーケットプレイスへの接続に失敗しました。
#       表示されているバージョン情報は古い可能性があります。
#       最後の更新: 2026-04-09 15:30:00
bash
# CLIからの更新
claude plugin update

# 接続失敗時の警告
# Warning: Could not refresh marketplace. Showing cached version information.
# Last updated: 2026-04-09 15:30:00

実践例 ​

プラグイン更新スクリプトでの警告処理 ​

bash
#!/bin/bash
# プラグイン更新を自動化するスクリプト

update_plugins() {
  echo "プラグインの更新を確認中..."
  
  # 更新コマンドを実行し、出力をキャプチャ
  output=$(claude plugin update 2>&1)
  exit_code=$?
  
  # 警告の確認
  if echo "$output" | grep -q "Warning: Could not refresh marketplace"; then
    echo "⚠️  マーケットプレイスへの接続に失敗しました"
    echo "   ネットワーク接続を確認してください"
    echo "   表示される情報は古い可能性があります"
    
    # ログに記録
    echo "$(date): Marketplace refresh failed" >> plugin_update.log
    return 1
  fi
  
  echo "$output"
  echo "✅ プラグインの更新確認が完了しました"
  return 0
}

update_plugins

CI/CD環境でのプラグイン管理 ​

yaml
# .github/workflows/claude-setup.yml
name: Claude Code Setup

on: [push]

jobs:
  setup:
    runs-on: ubuntu-latest
    steps:
      - name: プラグインの更新確認
        run: |
          output=$(claude plugin update 2>&1)
          
          # 警告をチェック
          if echo "$output" | grep -q "Could not refresh marketplace"; then
            echo "::warning::プラグインマーケットプレイスへの接続に失敗しました"
            echo "::warning::キャッシュされた情報を使用します"
          else
            echo "プラグイン情報が最新です"
          fi

オフライン環境でのプラグイン管理 ​

bash
# オフライン環境では警告が表示されることが想定される
# 事前にオンライン環境でプラグインリストをキャッシュ

# オンライン時: プラグイン情報をキャッシュ
claude plugin list > ~/.claude/plugin-cache.json

# オフライン時: 警告が表示されても、キャッシュ情報を活用
claude plugin update
# Warning: Could not refresh marketplace. Using cached data.

# キャッシュから必要なプラグインを確認
cat ~/.claude/plugin-cache.json | jq '.plugins[] | select(.name | contains("search"))'

警告の活用例 ​

bash
# 定期的なプラグイン更新チェックスクリプト
#!/bin/bash

check_plugin_freshness() {
  result=$(claude plugin list 2>&1)
  
  if echo "$result" | grep -q "stale\|cached\|Could not refresh"; then
    echo "プラグイン情報が古い可能性があります"
    echo "以下の操作を試みてください:"
    echo "  1. ネットワーク接続を確認"
    echo "  2. プロキシ設定を確認"
    echo "  3. 'claude plugin update' を再実行"
  else
    echo "プラグイン情報は最新です"
  fi
}

# 毎日実行するcronジョブ
# 0 9 * * * /home/user/scripts/check_plugin_freshness.sh

注意点 ​

  • 警告が表示されてもプラグインの機能自体は影響を受けません
  • 表示されるバージョン情報はキャッシュされた情報である可能性があります
  • ネットワーク接続の問題、プロキシの設定、ファイアウォールなどが原因で更新に失敗することがあります
  • 企業のプロキシ環境では、マーケットプレイスへのアクセスが制限されている場合があります
  • 警告が継続的に表示される場合は、ネットワーク設定を確認してください

関連情報 ​