メインコンテンツにスキップ

Claude Code CLI ユーザーの移行

開発者が Claude Code CLI を使用している場合は、デスクトップ アプリとは別に設定してください。デスクトップ アプリは、Claude Desktop on 3P 構成からプロバイダー設定を取得します。ANTHROPIC_BASE_URL または settings.json からではなく、開始する Code セッションにそれらを渡します。CLI は環境変数、設定ファイル、および Claude Code 管理設定を読み取ります。これらは 別のポリシー キーを使用します。

このガイドは、Claude Enterprise プランの組織の管理者向けです。

この記事は Claude Enterprise からクラウド プロバイダー上の Claude Desktop への移行の一部です。ここでは、wave、overlap period、cutoff date という用語が定義されています。

CLI とローカルで実行されるすべてのものは、すべてのプロバイダーで動作します。移行後、開発者は異なる方法でサインインし、ポリシーはコンピューターに異なる方法で到達し、一部の機能は利用できなくなります。

CLI をプロバイダーに接続する

Amazon Bedrock、Google Cloud、Microsoft Foundry、または LLM ゲートウェイのプロバイダー変数を設定します。開発者は claude.ai ブラウザー ログインが不要です。ゲートウェイを使用する場合は、ベース URL とゲートウェイ認証情報の両方を設定します。ベース URL のみの場合、保存された claude.ai ログインがアクティブな認証情報のままになり、その制限と請求が引き続き適用されます。チーム ロールアウトの前に、モデル バージョンをピン留めしてください。

各デバイスにポリシーを配信する

サーバー管理設定は適用されません。サード パーティ プロバイダーまたはカスタム ベース URL が設定されている場合。これらのポリシーを デバイス上の管理設定に移動してください。managed-settings.json ファイル、com.anthropic.claudecode macOS プロファイル、または HKLM\SOFTWARE\Policies\ClaudeCode レジストリ キーとして配信できます。これらはユーザーおよびプロジェクト設定よりも優先されます。ただし、セキュリティに関連する少数のキーでは、下位レベルからのより厳密な値がカウントされます。

  • コンピューターが使用できるプロバイダーを制限する: allowedProviders を設定します (Claude Code v2.1.285 以降)。overlap period 中、["anthropic", "bedrock"] などのリストにより、開発者はどちらかを使用できます。移行後は、新しいプロバイダーのみをリストします。Claude Desktop で claude.ai にサインインしたままのユーザーがいるコンピューターでは 「anthropic」 を保持してください。Cowork セッションはそれなしでは拒否されるためです。ANTHROPIC_BASE_URL を通じて到達するゲートウェイの場合は、"customEndpoint" をリストし、ゲートウェイ URL を同じ管理ソースの env ブロックに入れます。

  • 古いログイン設定を削除する: ゲートウェイ認証情報を使用する場合、forceLoginMethod と forceLoginOrgUUID を削除してください。どちらのキーでも起動時にゲートウェイ認証情報がブロックされるためです。クラウド プロバイダーでは、これらのキーは 特定の認証情報がコンピューターにまだある間のみセッションをブロックします: ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、apiKeyHelper 認証情報、または以前の Claude Console ログインで保存された API キー。

開発者は /status を実行して、アクティブなプロバイダーと設定の出所を確認できます。テレメトリ、ネットワーク ホスト、更新については、データ使用量、エンタープライズ ネットワーク構成、および 高度なセットアップを参照してください。

コストと使用量を追跡する

Bedrock、Google Cloud、Foundry では、使用量は トークンごとにクラウド アカウントに請求され、コスト管理はクラウド請求コンソールにあります。ゲートウェイを通じて、使用量は ゲートウェイが転送する認証情報を所有する者にトークンごとに請求されます。claude.ai 分析ダッシュボードと Claude Code Analytics API はこの使用量をカバーしていません。ユーザー別のレポートについては、OpenTelemetry または LLM ゲートウェイを使用してください。

開発者に引き継がれるもの

項目

移行後

実施すること

設定、CLAUDE.md、自動メモリ、スキル、サブエージェント、コマンド、フック、プラグイン、MCP サーバー

それらは残ります。~/.claude、~/.claude.json、プロジェクト フォルダに存在します。

何もありません。ただし、ログアウトした場合は除きます (下記を参照)。クリーンアップ中にこれらのフォルダをそのままにしておいてください。

ローカル セッション トランスクリプト

~/.claude/projects/ に残ります。cleanupPeriodDays が削除するまで。デフォルトは 30 日です。claude --continue と claude --resume がそれらを再度開きます。

パイロットでセッションの再開をテストしてください。Bedrock、Google Cloud、Foundry では、セッションの以前のモデルは復元されません。ゲートウェイのアップストリームが以前の thinking signature を拒否する場合、Claude Code は 以前の thinking ブロックをドロップして再試行します。

クラウド セッション

Anthropic はそれらを Claude アカウントの下に保存します。--cloud は利用できません。Claude Code がサード パーティ プロバイダー用に構成されている場合、--resume はクラウド セッションをリストしません。

移行前に、--teleport を使用して必要な各セッションをターミナルにプルしてください。ローカル コピーを作成します。claude.ai サインイン、クリーンな作業ツリー、同じリポジトリのチェックアウト、およびセッションのブランチがリモートにプッシュされていることが必要です。

claude.ai からのコネクタ

読み込まれません。サード パーティ プロバイダーがアクティブな場合。

ユーザーまたはプロジェクト スコープで MCP サーバーとして追加するか、管理 MCP 構成を通じてデプロイしてください。Microsoft 365、Gmail、Google Calendar などの一部の Anthropic ホスト型コネクタは、自分で追加したサーバーからのサインインをサポートしていません。そのため、これらのために別のサーバーを計画してください。

claude.ai から同期されたスキル

スキル同期は実行されません。Bedrock、Google Cloud、Foundry のセッション、またはゲートウェイ認証情報が claude.ai サインインを置き換える場合。以前に同期されたスキルは ~/.claude/skills/synced/ のディスクに残ります。

~/.claude/skills/synced/ から依存するスキルを ~/.claude/skills/ にコピーしてください。

claude.ai から同期されたプラグイン

ダウンロードも読み込みもされません。Bedrock、Google Cloud、Foundry のセッション。これらのセッションは Anthropic からフィーチャー フラグをフェッチしません。ANTHROPIC_AUTH_TOKEN または apiKeyHelper が認証情報を提供する場合も同じです。

マーケットプレイスから再インストールしてください (それらを提供している場合)。

claude.ai サインインが必要な機能

プロバイダーから到達できません。これらには、クラウド セッション、Routines、管理 Code Review、Ultrareview、Remote Control、Chrome 拡張機能、音声ディクテーションが含まれます。Channels と分析ダッシュボードも Bedrock、Google Cloud、Foundry では利用できません。Advisor と Code Mode も同様です。CLI の Web 検索は Bedrock では利用できません。Fast mode は Bedrock と Foundry では利用できず、Google Cloud では Claude Fable 5.2 に限定されています。

スケジューリングには /loop を、クラウド実行には GitHub Actions または GitLab CI/CD を使用してください (Foundry では GitHub Actions のみ)。ローカル /code-review を使用してください。開発者がまだ Team または Enterprise シートが必要かどうかを決定してください。

overlap period 中に注意すること

開発者向けチェックリスト

移行前

  • Claude Code を管理者が指定したバージョンに更新してください。

  • claude --teleport を使用して、必要なクラウド セッションをターミナルにプルしてください。まず、セッションのブランチがリモートにプッシュされていることを確認し、作業ツリーをクリーンにしてください。

  • 使用する claude.ai コネクタをリストして、MCP サーバーとして追加できるようにしてください。

  • ~/.claude/skills/synced/ から依存するスキルをコピーし、再インストールする必要がある同期プラグインをリストしてください。

移行当日

  1. 管理者が説明する方法でクラウド プロバイダーにサインインしてください。例えば、aws sso login、gcloud auth application-default login、または az login を使用します。

  2. claude を開始して /status を実行してください。プロバイダー、モデル、設定ソースを確認してください。

  3. claude --resume で最近のセッションを再度開き、応答することを確認してください。

  4. 不足しているツールまたはコネクタについて管理者に報告してください。

こちらの回答で解決しましたか?