dx-org-switch について
Salesforce 統合 `sf` CLI のデフォルト組織を設定・確認するスキルです。Salesforce 開発者がプロジェクト単位の設定を選び、明示的な依頼があればグローバル設定も行えます。
主な機能
- 01ユーザー名またはエイリアスで組織を選択
- 02未指定時に認証済み組織を一覧表示
- 03プロジェクト単位のデフォルト組織を設定
- 04依頼に応じてグローバル組織を設定
- 05設定済みの対象組織を確認
活用シーン
- 01Salesforce プロジェクトで使う組織の切り替え
- 02プロジェクト外の作業用組織の設定
- 03CLI の接続先組織の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ forcedotcom/ sf-skills --skill dx-org-switchインストール後、Claude Code で/dx-org-switchを入力して読み込まれたか確認します。
詳細
手順
- 組織を特定します。ユーザーからユーザー名またはエイリアス(
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 対応