SpyBara
Go Premium

authentication.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 57 additions and 57 deletions.

2026
Thu 1 23:59 Wed 7 23:59 Thu 8 22:58 Sat 10 23:01 Sun 11 23:57 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Wed 28 23:57 Thu 29 23:57 Fri 30 23:01

Autentikasi

Masuk ke Claude Code dan konfigurasikan autentikasi untuk individu, tim, dan organisasi.

Claude Code mendukung berbagai metode autentikasi tergantung pada pengaturan Anda. Pengguna individual dapat masuk dengan akun claude.ai, sementara tim dapat menggunakan Claude for Teams atau Enterprise, Claude Console, atau penyedia cloud seperti Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry.

Masuk ke Claude Code

Setelah memasang Claude Code, jalankan claude di terminal Anda. Pada peluncuran pertama, Claude Code membuka jendela browser untuk Anda masuk, kecuali dalam kasus seperti berikut, di mana Claude Code dapat melewati prompt login:

  • Kunci API: Anda telah menetapkan environment variable ANTHROPIC_API_KEY dan Anda menyetujui kunci tersebut ketika Claude Code menanyakan apakah akan menggunakannya
  • Login sebelumnya: Anda menjalankan claude auth login di shell Anda sebelum sesi pertama Anda, atau Anda membangun ulang dev container yang menyimpan kredensial Anda di dalam volume. Jika Anda tetap melihat prompt login, periksa apa yang dapat menyebabkannya.

Jika browser tidak terbuka secara otomatis, tekan c untuk menyalin URL login ke clipboard Anda, kemudian tempel ke browser Anda.

Jika browser Anda menampilkan kode login alih-alih pengalihan kembali setelah Anda masuk, tempel ke terminal di prompt Paste code here if prompted. Ini terjadi ketika browser tidak dapat menjangkau server callback lokal Claude Code, yang umum terjadi di WSL2, sesi SSH, dan kontainer.

Ketika login selesai, terminal menampilkan Login successful dan meminta Anda menekan Enter untuk melanjutkan.

Anda dapat melakukan autentikasi dengan salah satu jenis akun berikut:

  • Langganan Claude Pro atau Max: masuk dengan akun claude.ai Anda. Berlangganan di claude.com/pricing.
  • Claude for Teams atau Enterprise: masuk dengan akun claude.ai yang diundang oleh admin tim Anda.
  • Claude Console: masuk dengan kredensial Console Anda. Admin Anda harus telah mengundang Anda terlebih dahulu. Anda dapat masuk dengan atau tanpa membuat kunci API.
  • Penyedia cloud: jika organisasi Anda menggunakan Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry, atur variabel lingkungan yang diperlukan sebelum menjalankan claude, atau pilih 3rd-party platform di prompt login, yang meluncurkan wizard pengaturan interaktif untuk Bedrock dan Vertex AI. Tidak diperlukan login browser.
  • Gateway cloud: jika organisasi Anda menjalankan gateway aplikasi Claude yang di-host sendiri, masuk dengan SSO perusahaan melalui /login. Token yang dikeluarkan gateway adalah satu-satunya kredensial sesi.

Admin dapat mengarahkan metode login mana yang digunakan pengembang dan memerlukan login claude.ai untuk milik organisasi tertentu; lihat Batasi login ke organisasi Anda.

Untuk keluar dan melakukan autentikasi ulang, ketik /logout di prompt Claude Code. Keluar juga mengatur ulang status pengaturan peluncuran pertama Anda, jadi lain kali Anda menjalankan claude akan memandu Anda melalui login dan pengaturan lagi.

Jika Anda mengalami kesulitan masuk, lihat pemecahan masalah autentikasi.

Prompt login masih muncul setelah login sebelumnya

Jika Anda sudah masuk sebelumnya dan pengaturan peluncuran pertama menampilkan prompt login alih-alih melewatinya, periksa penyebab seperti berikut:

  • Login kedaluwarsa: login Anda sebelumnya telah kedaluwarsa dan Claude Code tidak dapat memperbaruinya. Masuk lagi di prompt.
  • Login dibatasi ke suatu organisasi: administrator menetapkan forceLoginOrgUUID di pengaturan terkelola untuk mewajibkan login dari organisasi tertentu. Prompt muncul terlepas dari apakah akun Anda termasuk dalam salah satu organisasi tersebut atau tidak. Masuk dengan akun di organisasi yang diwajibkan. Jika Anda tidak memilikinya, minta administrator Anda untuk menambahkan Anda.
  • Metode login yang diwajibkan: login Anda bukan jenis yang diwajibkan oleh forceLoginMethod di file pengaturan. Dengan "claudeai", kunci API dari login Claude Console sebelumnya tidak dihitung sebagai login yang sudah ada. Dengan "console", akun claude.ai tidak dihitung. Masuk dengan jenis akun yang disebutkan oleh pengaturan tersebut.
  • Versi lama: sebelum v2.1.290, prompt muncul selama pengaturan terlepas dari apakah Anda sudah masuk atau belum. Perbarui Claude Code untuk melewatinya.

Masuk dengan beberapa akun

Untuk tetap masuk ke beberapa akun sekaligus, seperti akun kerja dan pribadi, berikan setiap akun direktori konfigurasi sendiri. Ketika Anda memulai claude, atur variabel lingkungan CLAUDE_CONFIG_DIR ke direktori untuk akun yang ingin Anda gunakan. Setiap direktori memiliki pengaturan sendiri, riwayat sesi, dan login claude.ai atau kunci API. Misalnya, di Bash atau Zsh, tambahkan alias ini ke ~/.bashrc atau ~/.zshrc sehingga claude-work menggunakan akun kerja Anda sementara claude menyimpan akun pribadi Anda:

alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

Setelah Anda membuka terminal baru dan menjalankan claude-work untuk pertama kalinya, Claude Code memandu Anda melalui login dan pengaturan untuk direktori baru. Direktori terpisah tidak menjaga dua login Claude Console tanpa kunci API terpisah, karena Claude Code menyimpan jenis login itu di luar direktori konfigurasi.

Atur autentikasi tim

Untuk tim dan organisasi, Anda dapat mengonfigurasi akses Claude Code dengan salah satu cara berikut:

Claude for Teams atau Enterprise

Claude for Teams dan Claude for Enterprise memberikan pengalaman terbaik bagi organisasi yang menggunakan Claude Code. Anggota tim mendapatkan akses ke Claude Code dan Claude di web dengan penagihan terpusat dan manajemen tim.

  • Claude for Teams: paket layanan mandiri dengan fitur kolaborasi, alat admin, SSO, manajemen penagihan, dan pengaturan yang dikelola server untuk konfigurasi Claude Code di seluruh organisasi. Terbaik untuk tim yang lebih kecil.
  • Claude for Enterprise: menambahkan penangkapan domain, izin berbasis peran, dan API kepatuhan. Terbaik untuk organisasi yang lebih besar dengan persyaratan keamanan dan kepatuhan.

1. Berlangganan

Berlangganan Claude for Teams atau hubungi penjualan untuk Claude for Enterprise.

2. Undang anggota tim

Undang anggota tim dari dasbor admin.

3. Pasang dan masuk

Anggota tim memasang Claude Code dan masuk dengan akun claude.ai mereka.

Autentikasi Claude Console

Untuk organisasi yang lebih suka penagihan berbasis API, Anda dapat menyiapkan akses melalui Claude Console.

1. Buat atau gunakan akun Console

Gunakan akun Claude Console yang sudah ada atau buat yang baru.

2. Tambahkan pengguna

Anda dapat menambahkan pengguna melalui salah satu metode:

3. Tetapkan peran

Saat mengundang pengguna, tetapkan salah satu dari:

  • Peran Claude Code: pengguna hanya dapat membuat kunci API Claude Code
  • Peran Developer: pengguna dapat membuat jenis kunci API apa pun

4. Pengguna menyelesaikan pengaturan

Setiap pengguna yang diundang perlu:

Masuk tanpa kunci API

Anda dapat masuk ke akun Console Anda tanpa membuat kunci API, bahkan ketika organisasi Anda tidak membiarkan pengembang membuatnya. Pilih akun Anthropic Console di prompt /login dan Claude Code menanyakan bagaimana Anda ingin masuk. Memerlukan Claude Code v2.1.242 atau lebih baru. Kedua rute menandatangani Anda ke Console di browser dan berbeda dalam apa yang Claude Code simpan setelahnya:

  • Masuk dengan akun Console Anda, berlabel (recommended): Claude Code menyimpan token OAuth dari masuk itu dan menyimpannya sebagai profil Anthropic. Ini tidak membuat kunci API
  • Buat kunci API, berlabel (legacy): Claude Code membuat kunci API Console untuk Anda dan menyimpannya dengan kredensial lainnya

Dalam praktiknya, profil menyimpan login OAuth sementara kunci API adalah kredensial statis. Claude Code menyegarkan login profil secara otomatis, dan ketika penyegaran gagal, permintaan gagal dengan kesalahan login profil kedaluwarsa sampai Anda masuk lagi.

Anda tidak mendapatkan pilihan di setiap mesin. Claude Code membuat kunci API tanpa bertanya dalam kasus-kasus ini:

Batalkan ANTHROPIC_API_KEY sebelum Anda masuk tanpa kunci.

Setelah Anda masuk tanpa kunci, Anda memiliki profil alih-alih kunci API yang disimpan:

  • Profil mana yang ditulis: Claude Code menulis profil yang dinamai oleh ANTHROPIC_PROFILE, atau profil aktif Anda, atau default. Jika profil itu adalah profil federasi, Claude Code menolak masuk alih-alih menimpanya
  • Apa yang ditandatangani keluar: Claude Code menandatangani Anda keluar dari login claude.ai apa pun yang disimpan di mesin
  • Cara membatalkannya: jalankan /logout, yang menghapus dan mencabut kredensial yang ditulis masuk ini

Semuanya tentang profil berlaku untuk masuk ini, termasuk di mana peringkatnya terhadap kredensial lainnya, baris Profile yang Anda dapatkan di /status, dan fitur yang memerlukan login claude.ai. Lihat profil Anthropic dan kredensial federasi.

Autentikasi penyedia cloud

Untuk tim yang menggunakan Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry:

1. Ikuti pengaturan penyedia

Ikuti dokumen Amazon Bedrock, dokumen Google Cloud's Agent Platform, atau dokumen Microsoft Foundry.

2. Distribusikan konfigurasi

Distribusikan variabel lingkungan dan instruksi untuk menghasilkan kredensial cloud kepada pengguna Anda. Baca lebih lanjut tentang cara mengelola konfigurasi di sini.

3. Pasang Claude Code

Pengguna dapat memasang Claude Code.

Batasi login ke organisasi Anda

Untuk memerlukan bahwa login claude.ai pengembang milik organisasi Anthropic tertentu, atur forceLoginMethod dan forceLoginOrgUUID dalam pengaturan terkelola. Atur forceLoginOrgUUID ke ID organisasi Anda, ditampilkan dalam pengaturan admin claude.ai untuk organisasi Claude for Teams atau Enterprise. Claude Code melaporkan kesalahan untuk login claude.ai ke organisasi lain dan keluar saat startup jika kredensial claude.ai yang digunakan milik organisasi yang tidak terdaftar.

Untuk login Claude Console, Claude Code menggunakan forceLoginOrgUUID untuk pra-pilih organisasi di halaman masuk Console ketika Anda menetapkannya ke ID organisasi Console tunggal, ditampilkan di platform.claude.com/settings/organization. Ini tidak memeriksa organisasi mana yang dimiliki kredensial Console yang dihasilkan, saat login atau saat startup. Pengembang yang masuk dengan akun Console sebelum Anda menerapkan kunci tetap masuk, dan kunci yang disimpan itu diblokir di mesin yang juga memerlukan masuk gateway atau dalam sesi yang memilih penyedia cloud.

Jika Anda menetapkan forceLoginOrgUUID dalam file pengaturan apa pun, Claude Code berhenti menawarkan masuk Console tanpa kunci dalam sesi yang berlaku file itu dan membuat kunci API sebagai gantinya. Untuk mengarahkan pengembang ke masuk claude.ai sebagai gantinya, atur forceLoginMethod ke "claudeai".

Pada Claude Code v2.1.212 atau lebih baru, setiap jalur login yang terdaftar di sini menerapkan forceLoginMethod. Di layar login interaktif terminal, dicapai oleh /login atau onboarding pertama kali, Claude Code pra-pilih metode claudeai atau console tanpa memberlakukannya, jadi bahkan dengan forceLoginMethod diatur ke "claudeai", pengembang masih dapat menyelesaikan login Console di sana.

Jalur berbeda pada forceLoginOrgUUID:

  • Login terminal, ekstensi VS Code, dan Agent SDK: verifikasi forceLoginOrgUUID untuk login akun claude.ai
  • claude setup-token dan /install-github-app: hanya berlakukan forceLoginMethod, jadi mereka dapat membuat token di organisasi yang berbeda
  • Masuk gateway: dipilih oleh forceLoginMethod: "gateway" daripada dibatasi olehnya, dan tidak mengautentikasi terhadap organisasi Anthropic, jadi forceLoginOrgUUID tidak berlaku; gunakan penyedia identitas gateway Anda untuk membatasi akses

Terapkan kunci melalui alat manajemen perangkat Anda. Pengaturan terkelola server hanya menjangkau akun yang sudah diautentikasi ke organisasi Anda, jadi mereka tidak dapat mengarahkan login pertama pengembang. Jika organisasi Anda juga mendistribusikan pengaturan terkelola server, atur kunci di kedua tempat: sumber pengaturan terkelola tidak bergabung, dan pengaturan terkelola server yang di-cache menggantikan file yang dikelola perangkat, dengan beberapa pengecualian per-kunci. forceLoginOrgUUID dan nilai "claudeai" dan "console" dari forceLoginMethod bukan di antara pengecualian tersebut, jadi simpan di kedua tempat.

Dalam penerapan gateway, juga simpan forceLoginMethod dan forceLoginOrgUUID di luar pengaturan yang disajikan gateway.

Kunci juga memutuskan apakah sesi yang tidak menggunakan kredensial login dapat dimulai. Lihat forceLoginOrgUUID dalam referensi pengaturan untuk perilaku lengkap.

  • ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, atau apiKeyHelper: diblokir saat startup. Di bawah forceLoginOrgUUID, keanggotaan organisasi tidak dapat diverifikasi untuk kredensial lingkungan, dan di bawah forceLoginMethod kredensial akan berdiri untuk masuk yang diperlukan. Ketika pengaturan terkelola juga memerlukan masuk gateway, Claude Code memblokir kunci API yang disimpan oleh login Claude Console sebelumnya dengan cara yang sama. Lihat Kebijakan administrator memerlukan masuk gateway Cloud
  • Sesi penyedia cloud seperti Amazon Bedrock: diblokir hanya saat kredensial ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, atau apiKeyHelper, atau kunci API yang disimpan oleh login Claude Console sebelumnya, masih ada di mesin. Hapusnya dan sesi dimulai. Sesi ini mengautentikasi terhadap penyedia cloud Anda, yang kebijakan akses mereka mengaturnya
  • Profil Anthropic atau kredensial federasi: tidak diblokir kecuali kredensial ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, atau apiKeyHelper, atau kunci API yang disimpan oleh login Claude Console sebelumnya, juga ada di mesin. Kunci tidak memeriksa organisasi mana yang dimiliki profil

Batasi penyedia API mana yang dapat digunakan mesin

allowedProviders dalam pengaturan terkelola mencantumkan layanan mana yang dapat dijangkau mesin terkelola melalui Claude, seperti API Anthropic, Amazon Bedrock, atau gateway LLM. Ini melengkapi forceLoginMethod dan forceLoginOrgUUID, yang mengatur akun mana yang digunakan sesi ketika berbicara dengan Anthropic. Memerlukan Claude Code v2.1.285 atau lebih baru.

{
  "forceLoginMethod": "claudeai",
  "forceLoginOrgUUID": ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"],
  "allowedProviders": ["anthropic", "bedrock"]
}

Dengan file ini, pengembang yang masuk ke organisasi claude.ai Anda atau dikonfigurasi untuk Amazon Bedrock dimulai secara normal. Sesi yang disiapkan untuk penyedia lain ditolak saat startup, dan sesi yang berjalan yang beralih ke satu ditolak pada permintaan berikutnya. Pengaturan terkelola tidak mengizinkan penyedia API ini menampilkan setiap pesan.

  • Izinkan gateway LLM atau proxy: cantumkan "customEndpoint" dan atur URL gateway dalam blok env terkelola dari sumber yang sama. Referensi pengaturan mencantumkan setiap nilai dan mengatakan variabel endpoint mana yang memerlukan pin env terkelola.
  • Terapkan pada mesin terkelola: letakkan daftar dalam sumber terkelola yang membawa sisa kebijakan Anda. Catatan Scope entri mengatakan bagaimana daftar yang dikelola server menggabungkan dengannya.
  • Hanya pengaturan terkelola server: daftar yang Anda atur hanya dalam pengaturan terkelola server hanya menjangkau sesi yang mengambil pengaturan organisasi Anda, jadi perlakukan sebagai kenyamanan untuk mesin yang tidak dapat Anda jangkau dengan manajemen perangkat, bukan sebagai penegakan. Ketersediaan platform mencantumkan sesi mana yang mengambilnya.

Manajemen kredensial

Claude Code mengelola kredensial autentikasi Anda dengan aman:

  • Lokasi penyimpanan:
    • Di macOS, kredensial disimpan di Keychain macOS yang terenkripsi. Ketika Keychain menolak penulisan, seperti ketika terkunci dalam sesi SSH, Claude Code menyimpan login Anda di ~/.claude/.credentials.json dengan mode file 0600 sebagai gantinya, penyimpanan yang sama yang digunakannya di Linux. Login Console yang membuat kunci API gagal sampai Keychain dapat ditulis. Untuk memindahkan login Anda kembali ke Keychain, ikuti langkah pemulihan.
    • Di Linux, kredensial disimpan di ~/.claude/.credentials.json dengan mode file 0600.
    • Di Windows, kredensial disimpan di %USERPROFILE%\.claude\.credentials.json dan mewarisi kontrol akses dari direktori profil pengguna Anda, yang membatasi file ke akun pengguna Anda secara default.
    • Jika Anda telah menetapkan variabel lingkungan CLAUDE_CONFIG_DIR, Claude Code menyimpan file .credentials.json di bawah direktori tersebut sebagai gantinya, termasuk file yang ditulis fallback macOS, dan memberi kunci entri Keychain macOS ke direktori tersebut juga, sehingga sesi dengan CLAUDE_CONFIG_DIR yang berbeda membaca entri yang berbeda.
    • Claude Code mengelola .credentials.json melalui /login dan /logout. Untuk merutekan permintaan melalui titik akhir API kustom, atur variabel lingkungan ANTHROPIC_BASE_URL sebagai gantinya.
  • Jenis autentikasi yang didukung: kredensial claude.ai, kredensial API Claude, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth, kredensial profil Anthropic dan Workload Identity Federation, dan token sesi gateway aplikasi Claude.
  • Skrip kredensial kustom: konfigurasi pengaturan apiKeyHelper untuk menjalankan skrip shell yang mengembalikan kunci API.
  • Interval penyegaran: lihat apiKeyHelper untuk kasus di mana Claude Code menjalankan kembali helper.
  • Pemberitahuan helper lambat: jika apiKeyHelper membutuhkan waktu lebih lama dari 10 detik untuk mengembalikan kunci, Claude Code menampilkan pemberitahuan peringatan di bilah prompt yang menunjukkan waktu yang telah berlalu. Jika Anda melihat pemberitahuan ini secara teratur, periksa apakah skrip kredensial Anda dapat dioptimalkan.
  • Kegagalan helper: ketika skrip keluar dengan kesalahan, habis waktu, atau tidak mencetak apa pun, permintaan gagal dengan Your apiKeyHelper script is failing dalam tiga upaya.

apiKeyHelper, ANTHROPIC_API_KEY, dan ANTHROPIC_AUTH_TOKEN berlaku untuk CLI dan permukaan yang membungkusnya, termasuk ekstensi VS Code, Agent SDK, dan GitHub Actions. Claude Desktop dan sesi cloud tidak memanggil apiKeyHelper atau membaca variabel lingkungan ini: mereka menggunakan OAuth, kecuali sesi desktop yang menjalankan konfigurasi inferensi pihak ketiga, yang melakukan autentikasi dengan kredensial konfigurasi tersebut.

Perbarui login yang akan kedaluwarsa

Ketika login yang Anda buat dengan /login dalam tiga hari akan kedaluwarsa, Claude Code menampilkan peringatan saat startup: Your login expires in 3 days · run /login to renew.

Jalankan /login untuk memperbarui. Peringatan bersifat informatif dan tidak pernah memblokir permintaan: autentikasi terus bekerja sampai login benar-benar kedaluwarsa.

Setelah login yang disimpan kedaluwarsa dan tidak dapat disegarkan, setiap permintaan model gagal dengan Login expired · Please run /login sampai Anda masuk lagi.

Anda dapat memeriksa status ini sebelum permintaan gagal: /status menampilkan baris Login yang membaca Expired — log in again, ditambah organisasi dan email yang disimpannya untuk login yang kedaluwarsa. Baris muncul hanya ketika login claude.ai yang disimpan adalah kredensial aktif. Baris memerlukan Claude Code v2.1.210 atau lebih baru.

Peringatan muncul hanya ketika login claude.ai adalah kredensial aktif, dan bukan ketika penyedia cloud, ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, atau apiKeyHelper menyediakan kredensial.

Memperbarui lebih awal paling penting untuk sesi yang berjalan tanpa pengawasan. Sesi background session in agent view atau sesi Remote Control yang melampaui login berhenti membuat kemajuan setelah kredensial kedaluwarsa dan tidak dapat pulih sampai Anda masuk lagi.

Urutan prioritas autentikasi

Ketika beberapa kredensial ada, Claude Code memilih salah satu dalam urutan ini:

  1. Kredensial penyedia cloud, ketika CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX, atau CLAUDE_CODE_USE_FOUNDRY diatur. Lihat integrasi pihak ketiga untuk pengaturan.
  2. Variabel lingkungan ANTHROPIC_AUTH_TOKEN. Dikirim sebagai header Authorization: Bearer. Gunakan ini saat merutekan melalui gateway LLM atau proxy yang melakukan autentikasi dengan token bearer daripada kunci API Anthropic.
  3. Variabel lingkungan ANTHROPIC_API_KEY. Dikirim sebagai header X-Api-Key. Gunakan ini untuk akses API Anthropic langsung dengan kunci dari Claude Console. Dalam mode interaktif, Anda diminta sekali untuk menyetujui atau menolak kunci, dan pilihan Anda diingat. Untuk mengubahnya nanti, gunakan toggle "Use custom API key" di /config. Toggle hanya muncul saat ANTHROPIC_API_KEY diatur di lingkungan Anda. Dalam mode non-interaktif (-p), kunci selalu digunakan saat ada.
  4. Output skrip apiKeyHelper. Gunakan ini untuk kredensial dinamis atau berputar, seperti token berumur pendek yang diambil dari vault.
  5. Variabel lingkungan CLAUDE_CODE_OAUTH_TOKEN. Token OAuth berumur panjang yang dihasilkan oleh claude setup-token. Gunakan ini untuk pipeline CI dan skrip di mana login browser tidak tersedia. Jika Anda menjalankan /login saat variabel diatur, Claude Code beralih sesi saat ini ke login baru, tetapi membaca variabel lagi di setiap sesi baru sampai Anda menghapusnya dari profil shell atau blok env dari file pengaturan.
  6. Kredensial profil Anthropic dan federasi, kredensial yang digunakan CLI ant dan Workload Identity Federation. Profil yang ditulis ant auth login hanya menempati peringkat di sini ketika Anda menamakannya di ANTHROPIC_PROFILE; jika tidak, itu menempati peringkat di bawah /login. Lihat Profil Anthropic dan kredensial federasi.
  7. Kredensial OAuth langganan dari /login. Ini adalah default untuk pengguna Claude Pro, Max, Team, dan Enterprise.

Sesi gateway aplikasi Claude yang sudah masuk berada di luar daftar ini: ini adalah pemilihan penyedia seperti Amazon Bedrock atau Agent Platform Google Cloud, dan itu mengungguli mereka. Ketika sesi gateway ada, CLI melakukan autentikasi dengan token gateway bahkan jika CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX, atau CLAUDE_CODE_USE_FOUNDRY diatur, dan sumber kredensial di atas seperti token bearer, kunci API, apiKeyHelper, dan profil tidak digunakan.

Jika pengaturan terkelola mesin Anda menetapkan forceLoginMethod ke "gateway" atau menetapkan forceLoginGatewayUrl, dan Anda tidak memilih penyedia cloud melalui variabel seperti CLAUDE_CODE_USE_BEDROCK atau CLAUDE_CODE_USE_VERTEX, sesi Anda hanya menggunakan sign-in gateway. Claude Code melewati sumber kredensial lainnya dan meminta Anda untuk masuk dengan /login. Lihat Administrator policy requires a Cloud gateway sign-in untuk apa yang Anda lihat dengan setiap kredensial sisa. Memerlukan Claude Code v2.1.261 atau lebih baru, atau v2.1.265 atau lebih baru pada mesin yang hanya menetapkan forceLoginGatewayUrl.

Jika Anda memiliki langganan Claude aktif tetapi juga memiliki ANTHROPIC_API_KEY diatur di lingkungan Anda, Claude Code menggunakan kunci API setelah Anda menyetujuinya. Ini dapat menyebabkan kegagalan autentikasi jika kunci milik organisasi yang dinonaktifkan atau kedaluwarsa.

Jalankan unset ANTHROPIC_API_KEY untuk kembali ke langganan Anda, dan periksa /status untuk mengonfirmasi metode mana yang aktif. Ketika login dan kunci API keduanya dikonfigurasi, /status menandai kredensial yang tidak sedang digunakan.

Sesi cloud selalu menggunakan kredensial langganan Anda. Jika Anda menetapkan ANTHROPIC_API_KEY atau ANTHROPIC_AUTH_TOKEN di lingkungan cloud, itu tidak menimpa kredensial langganan Anda.

Profil Anthropic dan kredensial federasi

Profil adalah file konfigurasi kredensial bernama di direktori konfigurasi Anthropic Anda, secara default ~/.config/anthropic di macOS dan Linux atau %APPDATA%\Anthropic di Windows. Mode auth profil adalah oidc_federation ketika Anda menyiapkannya untuk Workload Identity Federation (WIF) atau user_oauth ketika ant auth login menulisnya atau Anda masuk ke akun Console tanpa kunci API.

Claude Code tidak membaca profil atau variabel federasi dalam mode bare, di Claude Desktop, atau dalam sesi cloud. Dalam sesi tersebut, /status tidak menampilkan baris Profile.

Claude Code memeriksa tiga sumber dalam urutan ini dan berhenti di yang pertama yang diatur. Tabel menunjukkan apa yang menetapkan setiap sumber dan di mana itu menempati peringkat terhadap kredensial /login Anda.

Sumber Ditetapkan oleh Peringkat terhadap /login
Profil bernama ANTHROPIC_PROFILE Di atas, mode auth apa pun yang dimiliki profil
Variabel federasi ANTHROPIC_FEDERATION_RULE_ID dan ANTHROPIC_ORGANIZATION_ID, keduanya diatur Di atas
Profil aktif File active_config di direktori konfigurasi Anda, atau profil bernama default Di atas ketika mode auth-nya adalah oidc_federation; di bawah kredensial /login yang berfungsi ketika mode auth-nya adalah user_oauth

Untuk variabel federasi, Claude Code juga membaca variabel lain dalam referensi WIF, seperti ANTHROPIC_IDENTITY_TOKEN_FILE, ketika menukar token identitas Anda. Untuk format file profil, lihat referensi WIF.

Untuk mengonfirmasi sumber mana yang dipilih Claude Code, jalankan /status. Baris Profile menamai sumber sebagai pengganti baris Login method. Ketika profil adalah kredensial yang sedang digunakan, baris Organization dan Email menunjukkan akunnya.

Ketika login profil user_oauth telah kedaluwarsa dan Claude Code tidak dapat memperbaruinya, permintaan gagal dengan kesalahan login profil kedaluwarsa.

Fitur yang memerlukan login claude.ai Anda, seperti konektor claude.ai dan /schedule, tidak tersedia saat salah satu sumber ini dipilih. Untuk menghentikan Claude Code dari memilih sumber:

  • Profil bernama atau variabel federasi: batalkan pengaturan ANTHROPIC_PROFILE, atau batalkan pengaturan variabel federasi apa pun
  • Profil aktif: jalankan /logout untuk profil user_oauth yang kredensial saat ini Anda tulis dengan masuk ke akun Console tanpa kunci API, jalankan ant auth logout untuk yang kredensial saat ini ant auth login tulis, atau hapus file profil dari configs/ di direktori konfigurasi Anda untuk mode auth apa pun

Hasilkan token berumur panjang

Untuk pipeline CI, skrip, atau lingkungan lain di mana login browser interaktif tidak tersedia, hasilkan token OAuth satu tahun dengan claude setup-token:

claude setup-token

Perintah membuka alur otorisasi browser yang sama seperti /login, dan token dicetak ke terminal setelah Anda menyetujui akses di browser. Itu tidak menyimpan token di mana pun; salin dan atur sebagai variabel lingkungan CLAUDE_CODE_OAUTH_TOKEN di mana pun Anda ingin melakukan autentikasi:

macOS, Linux, WSL

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Windows PowerShell

$env:CLAUDE_CODE_OAUTH_TOKEN = "your-token"

Windows CMD

set CLAUDE_CODE_OAUTH_TOKEN=your-token

Token ini melakukan autentikasi dengan langganan Claude Anda dan memerlukan paket Pro, Max, Team, atau Enterprise. Itu hanya dapat membuat permintaan model, jadi itu tidak dapat membuat sesi Remote Control atau mengambil konektor claude.ai. Server MCP yang Anda konfigurasi secara lokal masih berfungsi.

Mode bare tidak membaca CLAUDE_CODE_OAUTH_TOKEN. Jika skrip Anda melewatkan --bare, lakukan autentikasi dengan ANTHROPIC_API_KEY atau apiKeyHelper sebagai gantinya.