Skip to content

リソースセンター

CC サンドボックスへの依存:リソース管理は不要、Claude Code で使用する場合は必要

ワークスペースへのバインド:リソース使用時にワークスペースへのマウントが必要

リソースセンターは、ワークスペースで使用する外部リソースを統合管理するためのものです。例えばサーバーログイン情報、データベース接続、GitHub 認証情報、サードパーティ API Token などです。

リソースを特定のワークスペースにマウントすると、そのワークスペースの Claude Code がタスク実行時にこれらのリソースを使用できます。毎回アカウント、パスワード、接続アドレス、トークンを再送する必要がなくなります。

できること

リソースセンターは以下のコンテンツの管理に適しています:

  • サーバー SSH 接続情報
  • PostgreSQL、MySQL、Redis などのデータベース接続情報
  • GitHub CLI 認証情報
  • サードパーティサービスの API Token
  • 一般的な管理画面のアカウントパスワード
  • 複数ワークスペースで再利用する必要がある接続設定

リソースセンターに入れるべきもの

特定の一組の情報が複数のワークスペースで繰り返し使用される場合、またはホスト、ポート、ユーザー名、パスワードなど複数のフィールドを含む場合は、リソースセンターで統合管理するのが適しています。

注意

リソースセンターには機密認証情報を保存できます。対応するワークスペースでの使用を許可した情報のみを入力し、高権限の認証情報を必要としないワークスペースにマウントしないようにしてください。

エントリの場所

リソースセンターには2つのエントリがあります:

エントリ用途
左側メニュー「ワークスペース」→「リソースセンター」グローバルリソースの作成、編集、削除
ワークスペース詳細ページ「リソースマウント」タブ現在のワークスペースへのリソースのマウントまたはアンマウント

「リソースセンター」でリソースを作成しても、リソースライブラリに入るだけです。ワークスペースにマウントして初めて、Claude Code がそのワークスペースで使用できるようになります。

リソースの作成

「ワークスペース」→「リソースセンター」に入り、「新規リソース」をクリックします。

直接リソースを入力することも、まず初期化テンプレートを選択することもできます。

リソース作成時に入力する主な内容:

配置項目入力方法
リソース名何のリソースか明確に記述。例:本番サーバー SSHGitHub ボットアカウント
リソースタグカンマ区切り。例:ssh, deploy, github。検索と分類に便利
リソース備考管理者向けの説明。用途、所属プロジェクト、適用範囲など
リソースヒントClaude Code にいつこのリソースを使用でき、使用時に何に注意すべきかを伝える
フィールド設定実際の接続情報や認証情報を入力。例:ホスト、ポート、ユーザー名、パスワード、Token

リソースヒントは明確に記述することをお勧めします。例えば:

  • 「デプロイログの確認と読み取り専用の巡回に使用」
  • 「データベース状態のクエリ専用。明示的な要求がない限りデータの変更や削除は行わないこと」
  • 「GitHub PR、Issue、Actions の調査に使用」

初期化テンプレートの使用

新規リソース作成時に「テンプレートを選択」をクリックすると、よくあるリソース設定を素早く適用できます。

現在選択可能なテンプレート:

  • SSH 鍵接続
  • SSH パスワード接続
  • Root パスワード接続
  • PostgreSQL 接続
  • MySQL 接続
  • Redis 接続
  • GitHub CLI 認証情報
  • 汎用トークン認証情報
  • アカウントパスワード認証情報

テンプレートはよく使うフィールド、タグ、プロンプトを自動的に入力します。適用後も引き続き変更可能です。

フィールドの設定

各リソースは1つ以上のフィールドで構成されます。フィールドはこのリソースに保存する必要がある具体的な情報です。

一般的なフィールド例:

リソースタイプよくあるフィールド
SSH 接続ホストアドレス、ポート、ユーザー名、パスワードまたは秘密鍵
データベース接続ホストアドレス、ポート、データベース名、ユーザー名、パスワード
GitHub 認証情報アクセストークン、アカウント名
API Tokenアクセストークン、サービスアドレス
アカウントパスワードアカウント、パスワード、ログインURL

フィールドタイプ

フィールドタイプはリソースコンテンツの整理に役立ちます。よく使うタイプ:

  • テキスト
  • パスワード/トークン
  • ホストアドレス
  • ポート
  • 秘密鍵
  • ユーザー名
  • データベース名
  • JSON

機密情報

パスワード、Token、秘密鍵などのフィールドは「機密情報」をオンにすることをお勧めします。

機密情報としてマークすべきコンテンツ:

  • ログインパスワード
  • API Token
  • SSH 秘密鍵
  • データベースパスワード
  • Cookie またはセッション認証情報

環境変数名の互換性

一部のツールは固定名の変数をデフォルトで読み取ります。「互換環境変数名」にこれらの名前を入力すると、Claude Code が対応するツールをより使いやすくなります。

一般的な例:

シーン入力可能な互換変数名
GitHub CLIGH_TOKEN, GITHUB_TOKEN
カスタム API Tokenツールの要件に応じて入力。例:API_TOKEN

重複を避ける

同じワークスペース内では、複数のリソースが同じ互換環境変数名を使用しないでください。マウント時に競合が発生した場合、システムが処理を求めます。

リソースのワークスペースへのマウント

リソースを作成した後、ワークスペースにマウントして初めて使用できます。

操作手順:

  1. 対象ワークスペースの詳細ページに入る
  2. 「リソースマウント」タブを開く
  3. リソースライブラリから必要なリソースを見つける
  4. 「マウント」をクリック

マウント完了後、そのワークスペースにバインドされたチャンネルでタスクを委任できます。例えば:

  • 「サーバーリソースを使って最近のデプロイログを確認して」
  • 「GitHub 認証情報でこのリポジトリの Actions 失敗原因を調べて」
  • 「データベースに接続して、直近24時間の注文統計を確認して」

マウント済みリソースの管理

ワークスペースの「リソースマウント」ページで、以下が可能です:

  • 現在のワークスペースにマウント済みのリソースを確認
  • ワークスペースからリソースをアンマウント
  • ドラッグでリソースの順序を調整
  • リソースタグの確認
  • リソースがどのワークスペースから参照されているかを確認

リソースのアンマウントは現在のワークスペースの使用権限を解除するだけで、リソース自体は削除されません。

リソースの削除

グローバル「リソースセンター」でリソースを削除できます。

リソースがすでにワークスペースにマウントされている場合、削除前にシステムが影響を受けるワークスペースを通知します。削除を確認すると、これらのマウント関係も一併に削除されます。

削除には注意

リソースの削除は取り消しできません。削除後、そのリソースに依存するワークスペースのタスクは対応するサーバー、データベース、外部サービスへのアクセスを継続できなくなる可能性があります。

代表的な設定例

GitHub CLI 認証情報

Claude Code に PR、Issue、Actions の確認や GitHub リポジトリタスクの支援を行わせる場合に適しています。

設定のヒント:

  1. 新規リソースを作成し、「GitHub CLI 認証情報」テンプレートを選択
  2. アクセストークンを入力
  3. トークンフィールドで「機密情報」がオンになっていることを確認
  4. GH_TOKENGITHUB_TOKEN などの互換変数名を保持
  5. GitHub を操作する必要があるワークスペースにマウント

サーバー SSH 接続

デプロイ確認、ログ調査、サーバー巡回などのタスクに適しています。

設定のヒント:

  1. 新規リソースを作成し、SSH 鍵接続または SSH パスワード接続テンプレートを選択
  2. ホストアドレス、ポート、ユーザー名、認証情報を入力
  3. パスワード、秘密鍵、パスフレーズを機密情報としてマーク
  4. リソースヒントに許可された操作範囲を記述
  5. 運用またはプロジェクトワークスペースにマウント

データベース接続

データクエリ、接続状態の確認、構造情報のエクスポートなどのタスクに適しています。

設定のヒント:

  1. 新規リソースを作成し、PostgreSQL、MySQL、または Redis テンプレートを選択
  2. ホストアドレス、ポート、データベース名、ユーザー名、パスワードを入力
  3. パスワードを機密情報としてマーク
  4. リソースヒントでデフォルトで読み取り専用であることを明記
  5. データ分析または運用ワークスペースにマウント

ワークスペース環境変数との違い

ワークスペース設定ページでも直接環境変数を設定できますが、リソースセンターは一組の再利用可能な情報の管理に適しています。

機能適用シーン
ワークスペース環境変数現在のワークスペースだけに属するシンプルな設定
リソースセンター再利用可能、分類可能、複数フィールドを含み、複数ワークスペースにマウントする必要があるリソース

特定のワークスペースだけに属する1〜2つのシンプルな変数の場合は、ワークスペース環境変数に配置できます。

サーバー、データベース、アカウント、トークンなど再利用可能なリソースの場合は、リソースセンターに配置することをお勧めします。

次のステップ