Lewati ke konten utama

Pindahkan pengguna Claude Code CLI

Jika pengembang Anda menggunakan Claude Code CLI, atur secara terpisah dari aplikasi desktop. Aplikasi desktop mengambil pengaturan penyedia dari konfigurasi Claude Desktop 3P-nya, bukan dari ANTHROPIC_BASE_URL atau settings.json, dan meneruskannya ke sesi Code yang dimulainya. CLI membaca variabel lingkungan, file pengaturan, dan pengaturan terkelola Claude Code, yang menggunakan kunci kebijakan terpisah.

Panduan ini untuk admin organisasi dengan paket Claude Enterprise.

Artikel ini adalah bagian dari Pindah dari Claude Enterprise ke Claude Desktop di penyedia cloud, yang mendefinisikan istilah gelombang, periode tumpang tindih, dan tanggal cutoff.

CLI dan semua yang berjalan secara lokal bekerja di setiap penyedia. Setelah pindah, pengembang masuk dengan cara berbeda, kebijakan Anda mencapai komputer mereka dengan cara berbeda, dan beberapa fitur tidak tersedia.

Hubungkan CLI ke penyedia Anda

Atur variabel penyedia untuk Amazon Bedrock, Google Cloud, Microsoft Foundry, atau gateway LLM. Pengembang tidak memerlukan login browser claude.ai. Dengan gateway, atur URL dasar dan kredensial gateway. Dengan hanya URL dasar, login claude.ai yang disimpan tetap menjadi kredensial aktif, jadi batas dan penagihan masih berlaku. Sebelum peluncuran tim, pin versi model Anda.

Berikan kebijakan ke setiap perangkat

Pengaturan terkelola server tidak berlaku ketika penyedia pihak ketiga atau URL dasar khusus diatur. Pindahkan kebijakan tersebut ke pengaturan terkelola di perangkat. Anda dapat mengirimkannya sebagai file managed-settings.json, profil macOS com.anthropic.claudecode, atau kunci registri HKLM\SOFTWARE\Policies\ClaudeCode. Mereka memiliki prioritas atas pengaturan pengguna dan proyek, kecuali beberapa kunci sensitif keamanan di mana nilai yang lebih ketat dari level yang lebih rendah masih berlaku.

  • Batasi penyedia mana yang dapat digunakan komputer: Atur allowedProviders (Claude Code v2.1.285 atau lebih baru). Selama periode tumpang tindih, daftar seperti ["anthropic", "bedrock"] memungkinkan pengembang menggunakan salah satu. Setelah pindah, cantumkan hanya penyedia baru. Pertahankan “anthropic” di komputer tempat pengguna tetap masuk ke claude.ai di Claude Desktop, karena sesi Cowork mereka ditolak tanpanya. Untuk gateway yang dicapai melalui ANTHROPIC_BASE_URL, cantumkan "customEndpoint" dan masukkan URL gateway di blok env dari sumber terkelola yang sama.

  • Hapus pengaturan login lama: Dengan kredensial gateway, hapus forceLoginMethod dan forceLoginOrgUUID, karena kunci apa pun memblokir kredensial gateway saat startup. Di penyedia cloud, kunci tersebut memblokir sesi hanya saat kredensial tertentu masih ada di komputer: ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, kredensial apiKeyHelper, atau kunci API yang disimpan oleh login Claude Console sebelumnya.

Pengembang dapat menjalankan /status untuk melihat penyedia aktif dan tempat pengaturan mereka berasal. Untuk telemetri, host jaringan, dan pembaruan, lihat Penggunaan data, Konfigurasi jaringan Enterprise, dan Pengaturan lanjutan.

Lacak biaya dan penggunaan

Di Bedrock, Google Cloud, dan Foundry, penggunaan ditagihkan per token ke akun cloud Anda, dan kontrol biaya ada di konsol penagihan cloud Anda. Melalui gateway, penggunaan ditagihkan per token kepada siapa pun yang memiliki kredensial yang diteruskan gateway. Dashboard analitik claude.ai dan API Analytics Claude Code tidak mencakup penggunaan ini. Untuk pelaporan berdasarkan pengguna, gunakan OpenTelemetry atau gateway LLM.

Apa yang berlanjut untuk pengembang

Item

Setelah pindah

Yang harus dilakukan

Pengaturan, CLAUDE.md, memori otomatis, keterampilan, subagen, perintah, hook, plugin, dan server MCP

Mereka tetap. Mereka berada di ~/.claude, ~/.claude.json, dan folder proyek.

Tidak ada, kecuali Anda logout (lihat di bawah). Biarkan folder ini tetap ada selama pembersihan apa pun.

Transkrip sesi lokal

Mereka tetap di ~/.claude/projects/ sampai cleanupPeriodDays menghapusnya. Default adalah 30 hari. claude --continue dan claude --resume membuka kembali mereka.

Uji melanjutkan sesi di pilot Anda. Di Bedrock, Google Cloud, dan Foundry, model sebelumnya sesi tidak dipulihkan. Jika upstream gateway menolak tanda tangan pemikiran sebelumnya, Claude Code menghapus blok pemikiran sebelumnya dan mencoba lagi.

Sesi cloud

Anthropic menyimpannya di bawah akun Claude. --cloud tidak tersedia ketika Claude Code dikonfigurasi untuk penyedia pihak ketiga, dan --resume tidak mencantumkan sesi cloud.

Sebelum pindah, tarik setiap sesi yang Anda butuhkan ke terminal dengan --teleport. Ini membuat salinan lokal. Ini memerlukan login claude.ai, pohon kerja yang bersih, checkout repositori yang sama, dan cabang sesi didorong ke remote.

Konektor dari claude.ai

Tidak dimuat ketika penyedia pihak ketiga aktif.

Tambahkan sebagai server MCP di cakupan pengguna atau proyek, atau sebarkan melalui konfigurasi MCP terkelola. Beberapa konektor yang dihosting Anthropic, seperti Microsoft 365, Gmail, dan Google Calendar, tidak mendukung login dari server yang Anda tambahkan sendiri, jadi rencanakan server berbeda untuk yang tersebut.

Keterampilan disinkronkan dari claude.ai

Sinkronisasi keterampilan tidak berjalan dalam sesi di Bedrock, Google Cloud, atau Foundry, atau ketika kredensial gateway menggantikan login claude.ai. Keterampilan yang disinkronkan sebelumnya tetap di disk di ~/.claude/skills/synced/.

Salin keterampilan apa pun yang Anda andalkan dari ~/.claude/skills/synced/ ke ~/.claude/skills/.

Plugin disinkronkan dari claude.ai

Tidak diunduh atau dimuat dalam sesi di Bedrock, Google Cloud, atau Foundry, karena sesi tersebut tidak mengambil bendera fitur dari Anthropic. Hal yang sama berlaku ketika ANTHROPIC_AUTH_TOKEN atau apiKeyHelper menyediakan kredensial.

Instal ulang dari marketplace, jika ada yang membawanya.

Fitur yang memerlukan login claude.ai

Tidak dapat diakses dari penyedia. Ini termasuk sesi cloud, Rutinitas, Tinjauan Kode terkelola, Ultrareview, Kontrol Jarak Jauh, ekstensi Chrome, dan dikte suara. Saluran dan dashboard analitik juga tidak tersedia di Bedrock, Google Cloud, dan Foundry. Begitu juga Advisor dan Code Mode. Pencarian web CLI tidak tersedia di Bedrock. Mode cepat tidak tersedia di Bedrock dan Foundry, dan di Google Cloud terbatas pada Claude Fable 5.2.

Gunakan /loop untuk penjadwalan, GitHub Actions atau GitLab CI/CD untuk menjalankan cloud (hanya GitHub Actions di Foundry), dan /code-review lokal. Putuskan apakah pengembang masih memerlukan kursi Team atau Enterprise.

Apa yang harus diperhatikan selama periode tumpang tindih

Daftar periksa untuk pengembang

Sebelum pindah

  • Perbarui Claude Code ke versi yang ditentukan admin Anda.

  • Tarik sesi cloud apa pun yang Anda butuhkan ke terminal dengan claude --teleport. Pertama pastikan cabang sesi didorong ke remote, dan bersihkan pohon kerja Anda.

  • Cantumkan konektor claude.ai yang Anda gunakan, sehingga dapat ditambahkan sebagai server MCP.

  • Salin keterampilan apa pun yang Anda andalkan dari ~/.claude/skills/synced/, dan cantumkan plugin yang disinkronkan yang perlu Anda instal ulang.

Pada hari Anda pindah

  1. Masuk ke penyedia cloud Anda dengan cara yang dijelaskan admin Anda, misalnya dengan aws sso login, gcloud auth application-default login, atau az login.

  2. Mulai claude dan jalankan /status. Periksa penyedia, model, dan sumber pengaturan.

  3. Buka kembali sesi terbaru dengan claude --resume dan konfirmasi bahwa sesi merespons.

  4. Beritahu admin Anda tentang alat atau konektor apa pun yang hilang.

Apakah pertanyaan Anda terjawab?