Claude Code CLIの移行手順 — 管理設定の配布と使えなくなる機能
Claude Code CLIの利用者をClaude Enterpriseからクラウドへ移す管理者向けガイドが公開。接続設定、端末への管理設定、移行後も残るものと使えなくなる機能を解説します。
ヘルプセンターに「Move Claude Code CLI users」が公開されました。Claude EnterpriseからClaude Desktop on 3P(デスクトップアプリの推論先を自社契約のクラウドに切り替える構成)へ移る組織で、Claude Code CLIを使う開発者をどう移すかを扱う管理者向けのページです。移行全体の進め方はClaude Desktop on 3Pへの移行ガイドで整理済みなので、ここではCLI側だけを掘り下げます。
要点
- デスクトップアプリとCLIは別々に設定する。アプリはClaude Desktop on 3Pの構成からプロバイダー設定を受け取り、起動するCodeセッションに渡す。CLIは環境変数・設定ファイル・Claude Codeの管理設定を読む
- Bedrock、Google Cloud、Microsoft Foundry、LLMゲートウェイのどれでも、CLIとローカルで動くものは使える。開発者にclaude.aiのブラウザログインは要らない
- サーバー管理設定は、サードパーティープロバイダーやカスタムのベースURLを設定した環境では効かない。ポリシーは端末の管理設定へ移す
- ローカルの設定・CLAUDE.md・スキル・hooks・MCPサーバーとセッション記録は残る。クラウドセッションとclaude.aiのコネクタは使えなくなる。Bedrock・Google Cloud・Foundryでは、claude.aiとの同期は止まり、以前に同期したスキルは
~/.claude/skills/synced/に残るが、同期プラグインは読み込まれない - 重複期間は、サーバー管理設定と端末の管理設定のどちらが効くかが利用者ごとに分かれる
CLIはほぼそのまま動き、手当てが要るのはログイン・ポリシー配布・claude.ai依存機能の3点です。
CLI利用者の選択肢と手順はどう変わるか
接続:プロバイダー変数とゲートウェイの資格情報
CLIにはAmazon Bedrock、Google Cloud、Microsoft Foundry、LLMゲートウェイのプロバイダー変数を設定します。claude.aiのブラウザログインは要りません。モデルのバージョンは、チームに展開する前に固定します。
ゲートウェイでは、ベースURLとゲートウェイの資格情報の両方が必要です。ベースURLだけを設定すると、保存済みのclaude.aiログインが有効な資格情報のまま残ります。そのログインの上限と課金が引き続き適用されるので、使用量がclaude.ai側の契約に計上され続けます。
ポリシー配布:サーバー管理設定から端末の管理設定へ
サードパーティープロバイダーまたはカスタムのベースURLが設定されていると、サーバー管理設定は適用されません。Claude Codeのドキュメントも、プロバイダー変数をシェルでエクスポートした利用者ではサーバー管理設定の取得を飛ばすと説明しています。配布先は端末上の管理設定に移します。
届け方は3通りです。
| 配布方法 | 対象 |
|---|---|
managed-settings.jsonファイル | 対象ファイルの配置 |
com.anthropic.claudecodeプロファイル | 対象macOS |
HKLM\SOFTWARE\Policies\ClaudeCodeレジストリキー | 対象Windows |
端末の管理設定はユーザー設定とプロジェクト設定より優先されます。例外は一部のセキュリティ上重要なキーで、下位の階層がより厳しい値を持つ場合はその値が有効です。
allowedProvidersで接続先を絞る
allowedProvidersはClaude Code v2.1.285以降で使えます。キーの仕様はallowedProvidersの解説にあります。移行では時期ごとに値を変えます。
- 重複期間:
["anthropic", "bedrock"]のように2つを並べ、どちらでも使えるようにする - 移行後:新しいプロバイダーだけを残す
- Claude Desktopでclaude.aiにサインインしたままの端末:
"anthropic"を外さない。外すとCoworkのセッションが拒否される ANTHROPIC_BASE_URL経由のゲートウェイ:"customEndpoint"を指定し、ゲートウェイのURLを同じ管理ソースのenvブロックに書く
重複期間にBedrockを足す場合は、たとえば次のように書きます。
{
"allowedProviders": ["anthropic", "bedrock"]
}ゲートウェイの場合は、envのURLと組にします。
{
"allowedProviders": ["customEndpoint"],
"env": {
"ANTHROPIC_BASE_URL": "https://gateway.example.com"
}
}古いログイン設定を外す
ANTHROPIC_BASE_URL経由のLLMゲートウェイの資格情報を使うなら、forceLoginMethodとforceLoginOrgUUIDを削除します。どちらのキーも、起動時にゲートウェイの資格情報を拒否します。Claude apps gatewayへ誘導するforceLoginMethod: "gateway"は別の仕組みで、こちらはforceLoginGatewayUrlの解説にあります。
クラウドプロバイダーの場合は事情が違います。この2つのキーがセッションを止めるのは、端末に次の資格情報が残っている間だけです。
ANTHROPIC_API_KEYANTHROPIC_AUTH_TOKENapiKeyHelperの資格情報- 以前のClaude Consoleログインで保存されたAPIキー
開発者は/statusで、有効なプロバイダーと設定の出どころを確かめられます。
費用と利用状況の見え方
Bedrock、Google Cloud、Foundryでは、使用量はトークン単位でクラウドアカウントに課金されます。コストの管理画面はクラウド側の請求コンソールです。ゲートウェイでは、ゲートウェイが転送する資格情報の持ち主に課金されます。
claude.aiの分析ダッシュボードとClaude Code Analytics APIは、この使用量を数えません。ユーザー別のレポートが要るなら、OpenTelemetryかLLMゲートウェイを使います。
移行後に残るもの・残らないもの
| 項目 | 移行後 | 対応 |
|---|---|---|
| 設定、CLAUDE.md、自動メモリ、スキル、サブエージェント、コマンド、hooks、プラグイン、MCPサーバー | 移行後残る(~/.claude、~/.claude.json、プロジェクトフォルダー) | 対応ログアウトしない限り不要。片付けでも触らない |
| ローカルのセッション記録 | 移行後~/.claude/projects/に残る(cleanupPeriodDaysで消えるまで。既定30日) | 対応claude --continueとclaude --resumeで再開できる。パイロットで再開を試す |
| クラウドセッション | 移行後Anthropicがclaude.aiアカウントの下に保存 | 対応移行前に--teleportで端末に引き込む |
| claude.aiのコネクタ | 移行後サードパーティープロバイダーでは読み込まれない | 対応MCPサーバーとして追加するか、管理されたMCP設定で配る |
| claude.aiから同期したスキル | 移行後Bedrock・Google Cloud・Foundry、またはゲートウェイの資格情報を使う場合は同期しない。以前に同期した分は~/.claude/skills/synced/に残る | 対応必要なスキルを~/.claude/skills/へコピーする |
| claude.aiから同期したプラグイン | 移行後Bedrock・Google Cloud・Foundry、またはANTHROPIC_AUTH_TOKEN・apiKeyHelperで認証する場合は、ダウンロードも読み込みもされない | 対応マーケットプレイスにあれば再インストールする |
再開できるセッションの落とし穴
セッション記録は残りますが、Bedrock、Google Cloud、Foundryではセッションの以前のモデルが復元されません。ゲートウェイの上流が以前のthinkingシグネチャを拒否した場合、Claude Codeは以前のthinkingブロックを落として再試行します。再開の挙動はプロバイダーごとに違うので、パイロットで実際に開いて確かめる項目です。
クラウドセッションを引き込む条件
クラウドセッションは、サードパーティープロバイダーに設定したClaude Codeでは--cloudが使えず、--resumeの一覧にも出ません。移行前に--teleportで引き込むと、ローカルのコピーができます。
条件は4つです。claude.aiへのサインイン、クリーンな作業ツリー、同じリポジトリのチェックアウト、セッションのブランチがリモートへプッシュ済みであること。失敗時の切り分けはteleportの「Failed to fetch session」が参考になります。
自前のサーバーではサインインできないコネクタ
Anthropicがホストするコネクタの一部(Microsoft 365、Gmail、Google Calendarなど)は、自分で追加したサーバーからのサインインに対応していません。これらは別のMCPサーバーを用意して置き換えます。
claude.aiのサインインが要る機能
プロバイダー経由では届かない機能があります。
- 全プロバイダー共通:クラウドセッション、Routines、マネージドのCode Review、Ultrareview、Remote Control、Chrome拡張機能、音声入力
- Bedrock、Google Cloud、Foundry:Channels、分析ダッシュボード、Advisor、Code Mode
- Bedrockのみ:CLIのWeb検索
- fast mode:BedrockとFoundryでは使えない。Google CloudではClaude Fable 5.2に限る
代わりに、スケジュールには/loop、クラウド実行にはGitHub ActionsかGitLab CI/CD(Foundryの場合はGitHub Actionsのみ)、レビューにはローカルの/code-reviewを使います。経路別の対応表はBedrock・Vertex・Foundryで使えない機能一覧にあります。使えなくなる機能を踏まえて、Team・Enterpriseのシートを残すかどうかも判断項目です。
重複期間に起きやすいつまずき
サーバー管理設定が端末の管理設定に勝つ
claude.aiで認証しているセッションでは、サーバー管理設定が優先されます。既定では、Claude Codeはサーバー管理設定を使い、端末の管理設定を読み飛ばします。envブロックとallowedProvidersなど、一部は例外です。
claude.aiに残る開発者がいるなら、その人たちにはサーバー管理設定、それ以外の全員にはファイルかOSのポリシーを使います。配布経路が二重になるため、利用者グループごとに「どちらが効いているか」を台帳に書いておくと切り分けが早くなります。
保存済みのclaude.aiログインは残る
claude.aiのログインは端末に残ります。クラウドプロバイダーの資格情報はそのログインより優先され、クラウドプロバイダーが有効になると/logoutは使えなくなります。ログインを消したいなら、プロバイダー設定を配る前にログアウトさせます。
ログアウトすると、保存済みのMCPサーバーのログインとプラグインの秘密情報も消えるため、再承認が要ります。ゲートウェイの資格情報なら/logoutは使えるままなので、実行して保存済みログインを消せます。
CLIのポリシーがデスクトップのポリシーを上書きする
端末にClaude Codeの管理設定があると、既定ではデスクトップのCodeセッションは、デスクトップアプリが供給する管理ポリシーの値を無視します。両方を効かせたいときは、管理設定の展開ガイドにあるparentSettingsBehaviorを使います。デスクトップ側で組んだ制限が、CLI用の管理設定を置いた端末だけで消える形になるため、パイロットで両方の経路を試しておきます。
開発者向けのチェックリスト
移行前に開発者がすること
- 1
Claude Codeを更新する
管理者が指定したバージョンへ上げます。
allowedProvidersはv2.1.285以降です。 - 2
クラウドセッションを引き込む
セッションのブランチをリモートへプッシュし、作業ツリーをきれいにしてから
claude --teleportを実行します。 - 3
使うコネクタを書き出す
claude.aiのコネクタを一覧にして、MCPサーバーとして追加できるようにします。
- 4
同期済みのスキルとプラグインを控える
必要なスキルは
~/.claude/skills/synced/から出し、再インストールが要る同期済みプラグインを一覧にします。
当日は、まずプロバイダーにサインインします。例として、次のようなコマンドがあります。
aws sso login
gcloud auth application-default login
az loginそのあとClaude Codeを起動し、/statusでプロバイダー、モデル、設定の出どころを確認します。最近のセッションをclaude --resumeで開いて応答することを確かめ、足りないツールやコネクタは管理者へ伝えます。
CLIの移行は「設定の置き場所」の移行になる
デスクトップアプリはClaude Desktop on 3Pの構成からプロバイダー設定を受け取る一方、CLIでは環境変数、設定ファイル、管理設定、claude.aiのサーバー側設定が重なって効きます。今回のページはその重なりを、利用者の手元に何が残るかと、ポリシーがどこから届くかの2軸でほどいています。
実務で効くのは、claude.aiログインを残すか消すかを、設定配布より前に決める順序です。クラウドプロバイダーへ移る端末では/logoutが使えなくなるため、この順序は入れ替えがききません(ゲートウェイの資格情報なら後からでも/logoutできます)。
まとめ
- 管理者:サーバー管理設定を端末の管理設定へ移し、
allowedProvidersを重複期間用と移行後用の2段で用意する。ゲートウェイは資格情報とベースURLをセットで配る - 開発者:
--teleport、コネクタの書き出し、同期スキルの退避を、プロバイダー設定が届く前に終える。移行後は/statusで接続先を確かめる - ガバナンス担当:コスト管理を、claude.aiのダッシュボードからクラウドの請求コンソール、OpenTelemetry、ゲートウェイへ付け替える
- 移行全体の段取りは親ガイドの解説で確認できる
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。