リソースセンター
CC サンドボックスへの依存:リソース管理は不要、Claude Code で使用する場合は必要
ワークスペースへのバインド:リソース使用時にワークスペースへのマウントが必要
リソースセンターは、ワークスペースで使用する外部リソースを統合管理するためのものです。例えばサーバーログイン情報、データベース接続、GitHub 認証情報、サードパーティ API Token などです。
リソースを特定のワークスペースにマウントすると、そのワークスペースの Claude Code がタスク実行時にこれらのリソースを使用できます。毎回アカウント、パスワード、接続アドレス、トークンを再送する必要がなくなります。
できること
リソースセンターは以下のコンテンツの管理に適しています:
- サーバー SSH 接続情報
- PostgreSQL、MySQL、Redis などのデータベース接続情報
- GitHub CLI 認証情報
- サードパーティサービスの API Token
- 一般的な管理画面のアカウントパスワード
- 複数ワークスペースで再利用する必要がある接続設定
リソースセンターに入れるべきもの
特定の一組の情報が複数のワークスペースで繰り返し使用される場合、またはホスト、ポート、ユーザー名、パスワードなど複数のフィールドを含む場合は、リソースセンターで統合管理するのが適しています。
注意
リソースセンターには機密認証情報を保存できます。対応するワークスペースでの使用を許可した情報のみを入力し、高権限の認証情報を必要としないワークスペースにマウントしないようにしてください。
エントリの場所
リソースセンターには2つのエントリがあります:
| エントリ | 用途 |
|---|---|
| 左側メニュー「ワークスペース」→「リソースセンター」 | グローバルリソースの作成、編集、削除 |
| ワークスペース詳細ページ「リソースマウント」タブ | 現在のワークスペースへのリソースのマウントまたはアンマウント |
「リソースセンター」でリソースを作成しても、リソースライブラリに入るだけです。ワークスペースにマウントして初めて、Claude Code がそのワークスペースで使用できるようになります。
リソースの作成
「ワークスペース」→「リソースセンター」に入り、「新規リソース」をクリックします。
直接リソースを入力することも、まず初期化テンプレートを選択することもできます。
リソース作成時に入力する主な内容:
| 配置項目 | 入力方法 |
|---|---|
| リソース名 | 何のリソースか明確に記述。例:本番サーバー SSH、GitHub ボットアカウント |
| リソースタグ | カンマ区切り。例: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 CLI | GH_TOKEN, GITHUB_TOKEN |
| カスタム API Token | ツールの要件に応じて入力。例:API_TOKEN |
重複を避ける
同じワークスペース内では、複数のリソースが同じ互換環境変数名を使用しないでください。マウント時に競合が発生した場合、システムが処理を求めます。
リソースのワークスペースへのマウント
リソースを作成した後、ワークスペースにマウントして初めて使用できます。
操作手順:
- 対象ワークスペースの詳細ページに入る
- 「リソースマウント」タブを開く
- リソースライブラリから必要なリソースを見つける
- 「マウント」をクリック
マウント完了後、そのワークスペースにバインドされたチャンネルでタスクを委任できます。例えば:
- 「サーバーリソースを使って最近のデプロイログを確認して」
- 「GitHub 認証情報でこのリポジトリの Actions 失敗原因を調べて」
- 「データベースに接続して、直近24時間の注文統計を確認して」
マウント済みリソースの管理
ワークスペースの「リソースマウント」ページで、以下が可能です:
- 現在のワークスペースにマウント済みのリソースを確認
- ワークスペースからリソースをアンマウント
- ドラッグでリソースの順序を調整
- リソースタグの確認
- リソースがどのワークスペースから参照されているかを確認
リソースのアンマウントは現在のワークスペースの使用権限を解除するだけで、リソース自体は削除されません。
リソースの削除
グローバル「リソースセンター」でリソースを削除できます。
リソースがすでにワークスペースにマウントされている場合、削除前にシステムが影響を受けるワークスペースを通知します。削除を確認すると、これらのマウント関係も一併に削除されます。
削除には注意
リソースの削除は取り消しできません。削除後、そのリソースに依存するワークスペースのタスクは対応するサーバー、データベース、外部サービスへのアクセスを継続できなくなる可能性があります。
代表的な設定例
GitHub CLI 認証情報
Claude Code に PR、Issue、Actions の確認や GitHub リポジトリタスクの支援を行わせる場合に適しています。
設定のヒント:
- 新規リソースを作成し、「GitHub CLI 認証情報」テンプレートを選択
- アクセストークンを入力
- トークンフィールドで「機密情報」がオンになっていることを確認
GH_TOKEN、GITHUB_TOKENなどの互換変数名を保持- GitHub を操作する必要があるワークスペースにマウント
サーバー SSH 接続
デプロイ確認、ログ調査、サーバー巡回などのタスクに適しています。
設定のヒント:
- 新規リソースを作成し、SSH 鍵接続または SSH パスワード接続テンプレートを選択
- ホストアドレス、ポート、ユーザー名、認証情報を入力
- パスワード、秘密鍵、パスフレーズを機密情報としてマーク
- リソースヒントに許可された操作範囲を記述
- 運用またはプロジェクトワークスペースにマウント
データベース接続
データクエリ、接続状態の確認、構造情報のエクスポートなどのタスクに適しています。
設定のヒント:
- 新規リソースを作成し、PostgreSQL、MySQL、または Redis テンプレートを選択
- ホストアドレス、ポート、データベース名、ユーザー名、パスワードを入力
- パスワードを機密情報としてマーク
- リソースヒントでデフォルトで読み取り専用であることを明記
- データ分析または運用ワークスペースにマウント
ワークスペース環境変数との違い
ワークスペース設定ページでも直接環境変数を設定できますが、リソースセンターは一組の再利用可能な情報の管理に適しています。
| 機能 | 適用シーン |
|---|---|
| ワークスペース環境変数 | 現在のワークスペースだけに属するシンプルな設定 |
| リソースセンター | 再利用可能、分類可能、複数フィールドを含み、複数ワークスペースにマウントする必要があるリソース |
特定のワークスペースだけに属する1〜2つのシンプルな変数の場合は、ワークスペース環境変数に配置できます。
サーバー、データベース、アカウント、トークンなど再利用可能なリソースの場合は、リソースセンターに配置することをお勧めします。
次のステップ
- ワークスペース概要 — ワークスペースの機能構成を理解
- Claude Code サンドボックス — Claude Code がワークスペースでタスクを実行する仕組みを理解
- MCP サービス管理 — 外部ツールやサービスに接続
- ワークスペースタイマー — リソースと連携した自動化巡回の実現
