switching-org について
Salesforce CLI のデフォルト組織を設定し、確認するスキルです。通常はプロジェクト内に設定し、明示的な依頼がある場合に限りグローバル設定を変更します。
主な機能
- 01ユーザー名または別名で組織を選択
- 02未指定時に認証済み組織を一覧表示
- 03プロジェクト単位のデフォルト組織設定
- 04依頼時のグローバル組織設定
- 05設定した組織の確認
活用シーン
- 01現在のプロジェクトで使う組織の設定
- 02別名が不明な場合の認証済み組織の選択
- 03明示的な依頼に基づくグローバル設定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ forcedotcom/ sf-skills --skill switching-orgインストール後、Claude Code で/switching-orgを入力して読み込まれたか確認します。
詳細
手順
- 組織を特定します。ユーザーからユーザー名またはエイリアス(
orgIdentifier)を受け取ります。指定されていない場合は、sf org listを実行して認証済みの組織を表示し、どれを使用するかユーザーに確認します。 - デフォルトの組織を設定します。
- ローカル(デフォルト):
sf config set target-org <orgIdentifier>- 現在のプロジェクトディレクトリ内でのみ適用されます。通常のプロジェクト作業ではこちらを使用します。
- グローバル(ユーザーから明示的に要求された場合のみ):
sf config set target-org <orgIdentifier> --global- すべてのディレクトリでシステム全体に適用されます。プロジェクト外で作業する場合や、ユーザーがグローバルスコープを求める場合に使用します。
- 失敗した場合は、エラーを報告し、組織が認証されていない可能性がある場合は
sf org login webの実行を提案します。
- ローカル(デフォルト):
- 確認します。
sf config get target-org --json- 注意:JSON 出力にはスコープ/場所のフィールドが含まれていないため、値がローカルかグローバルかは確認できません。
target-org is now set to: <value>のように、値だけを確認してください。 - 失敗した場合は、エラーを報告し、
sf config get target-orgの実行を案内します。
注意事項
- Unified CLI では、
target-orgやtarget-dev-hubのようなキーを使用します。従来の sfdx キー(defaultusername、defaultdevhubusername)は、この用途では非推奨です。 - sf CLI の
config setには--localフラグや--scopeフラグはありません。ローカルスコープがデフォルトの動作です。 - 設定後に組織が切り替わらない場合は、
SF_TARGET_ORGが設定されているか確認してください。環境変数は設定値より優先されます。 - Salesforce CLI の設定(統合版)リファレンス:https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_config_commands_unified.htm#cli_reference_config_set_unified
コメント
Markdown 対応