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 Vertex AI, 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.

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.

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.
• Penyedia cloud: jika organisasi Anda menggunakan Amazon Bedrock, Google Vertex AI, atau Microsoft Foundry, atur variabel lingkungan yang diperlukan sebelum menjalankan claude. Tidak diperlukan login browser.

Untuk keluar dan melakukan autentikasi ulang, ketik /logout di prompt Claude Code.

Jika Anda mengalami kesulitan masuk, lihat pemecahan masalah autentikasi.

Atur autentikasi tim

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

• Claude for Teams atau Enterprise, direkomendasikan untuk sebagian besar tim
• Claude Console
• Amazon Bedrock
• Google Vertex AI
• Microsoft Foundry

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, dan manajemen penagihan. Terbaik untuk tim yang lebih kecil.
• Claude for Enterprise: menambahkan SSO, penangkapan domain, izin berbasis peran, API kepatuhan, dan pengaturan kebijakan terkelola untuk konfigurasi Claude Code di seluruh organisasi. Terbaik untuk organisasi yang lebih besar dengan persyaratan keamanan dan kepatuhan.

Autentikasi Claude Console

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

Autentikasi penyedia cloud

Untuk tim yang menggunakan Amazon Bedrock, Google Vertex AI, atau Microsoft Foundry:

Manajemen kredensial

Claude Code mengelola kredensial autentikasi Anda dengan aman:

• Lokasi penyimpanan:
  • Di macOS, kredensial disimpan di Keychain macOS yang terenkripsi.
  • 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 di Linux atau Windows, file .credentials.json berada di bawah direktori tersebut.
  • 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, Azure Auth, Bedrock Auth, dan Vertex Auth.
• Skrip kredensial kustom: pengaturan apiKeyHelper dapat dikonfigurasi untuk menjalankan skrip shell yang mengembalikan kunci API.
• Interval penyegaran: secara default, apiKeyHelper dipanggil setelah 5 menit atau pada respons HTTP 401. Atur variabel lingkungan CLAUDE_CODE_API_KEY_HELPER_TTL_MS untuk interval penyegaran kustom.
• 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.

apiKeyHelper, ANTHROPIC_API_KEY, dan ANTHROPIC_AUTH_TOKEN hanya berlaku untuk sesi CLI terminal. Claude Desktop dan sesi jarak jauh menggunakan OAuth secara eksklusif dan tidak memanggil apiKeyHelper atau membaca variabel lingkungan kunci API.

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. 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.
6. Kredensial OAuth langganan dari /login. Ini adalah default untuk pengguna Claude Pro, Max, Team, dan Enterprise.

Jika Anda memiliki langganan Claude aktif tetapi juga memiliki ANTHROPIC_API_KEY diatur di lingkungan Anda, kunci API memiliki prioritas setelah disetujui. 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.

Claude Code di Web selalu menggunakan kredensial langganan Anda. ANTHROPIC_API_KEY dan ANTHROPIC_AUTH_TOKEN di lingkungan sandbox tidak menimpanya.

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 memandu Anda melalui otorisasi OAuth dan mencetak token ke terminal. Perintah tidak menyimpan token di mana pun; salin dan atur sebagai variabel lingkungan CLAUDE_CODE_OAUTH_TOKEN di mana pun Anda ingin melakukan autentikasi:

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Token ini melakukan autentikasi dengan langganan Claude Anda dan memerlukan paket Pro, Max, Team, atau Enterprise. Token ini dibatasi untuk inferensi saja dan tidak dapat membuat sesi Remote Control.

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