--- title: Opsi autentikasi CLI url: https://platform.claude.com/docs/id/cli-sdks-libraries/cli/authentication description: Autentikasi CLI ant dengan login interaktif, kunci API, profil bernama, dan Workload Identity Federation. --- CLI `ant` mendukung beberapa sumber kredensial. [Quickstart](https://platform.claude.com/docs/id/cli-sdks-libraries/cli/quickstart#authentication) membahas login satu perintah (`ant auth login`). Halaman ini membahas setiap opsi secara lengkap. ## Login interaktif `ant auth login` memungkinkan Anda memanggil API tanpa membuat atau mengelola kunci API. Ini membuka alur OAuth berbasis browser terhadap Claude Console dan menyimpan kredensial yang dihasilkan di bawah `$ANTHROPIC_CONFIG_DIR` (lihat [Direktori konfigurasi](https://platform.claude.com/docs/id/manage-claude/wif-reference#configuration-directory) untuk default spesifik OS). Pada host jarak jauh atau di lingkungan apa pun tanpa browser lokal, berikan `--no-browser` untuk mencetak URL otorisasi dan tempel kode yang dikembalikan kembali ke terminal. ```bash CLI ant auth login # Pada host jarak jauh tanpa browser: ant auth login --no-browser # Ikat ke workspace tertentu dan lewati pemilih browser: ant auth login --workspace-id wrkspc_01... # Jika profil bernama yang Anda berikan dengan --profile tidak ada, # profil bernama baru akan dibuat dengan nama tersebut. ant auth login --profile work ``` Selama alur browser, Anda memilih organisasi dan kemudian [workspace](https://platform.claude.com/docs/id/manage-claude/workspaces). Token yang diterbitkan [dibatasi ke workspace tersebut](https://platform.claude.com/docs/id/manage-claude/workspaces#api-keys-and-resource-scoping), sehingga CLI hanya dapat melihat sumber daya yang menjadi miliknya. Berikan `--workspace-id` untuk mengikat secara langsung dan melewati pemilih. Untuk bekerja di lebih dari satu workspace, lihat [Beralih antar workspace](https://platform.claude.com/docs/id/cli-sdks-libraries/cli/authentication#switch-between-workspaces). Login interaktif ditujukan untuk pengembangan lokal dan scripting di mesin Anda sendiri. Untuk beban kerja non-interaktif seperti CI, server, dan kontainer, gunakan [Workload Identity Federation](https://platform.claude.com/docs/id/manage-claude/workload-identity-federation) sebagai gantinya. Login menulis kredensial ke `credentials/.json`. Login pertama untuk sebuah profil juga membuat `configs/.json` dan menetapkannya sebagai profil aktif. Untuk menghapus kredensial yang tersimpan, jalankan `ant auth logout`, atau `ant auth logout --all` untuk membersihkan setiap profil. ## Akses admin Secara default, `ant auth login` meminta token yang dibatasi ke workspace. Untuk mengelola sumber daya yang didokumentasikan di halaman [Admin API](https://platform.claude.com/docs/id/manage-claude/admin-api), minta scope `org:admin` di bawah profil khusus: ```bash CLI ant auth login --profile admin --scope "org:admin" # Cetak bearer token untuk header Authorization: ant auth print-credentials --profile admin --access-token ``` Scope `org:admin` hanya diberikan kepada anggota organisasi dengan peran admin, owner, atau primary owner. Token yang diterbitkan memiliki akses seluruh organisasi, dan pengikatan workspace apa pun pada profil tidak membatasinya. Jaga agar profil admin tetap terpisah dari profil sehari-hari Anda sehingga perintah rutin tidak pernah berjalan dengan akses yang ditingkatkan. ## Kunci API CLI juga membaca kunci API Anda dari variabel lingkungan `ANTHROPIC_API_KEY`. Dapatkan kunci dari [Claude Console](https://platform.claude.com/settings/keys). ```bash echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.zshrc source ~/.zshrc ``` ```bash echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.bashrc source ~/.bashrc ``` ```powershell setx ANTHROPIC_API_KEY "sk-ant-api03-..." ``` Buka terminal baru agar perubahan berlaku. Untuk menimpa kunci untuk satu kali eksekusi, berikan [`--api-key-stdin`](https://platform.claude.com/docs/id/cli-sdks-libraries/cli/using#global-flags) dan alirkan (pipe) kunci ke perintah. Untuk mengarahkan ke host API yang berbeda, atur `ANTHROPIC_BASE_URL` atau berikan `--base-url`. Jika Anda menggunakan [kunci akun pribadi atau akun layanan](https://platform.claude.com/docs/id/manage-claude/authentication#key-types) yang tidak dibatasi ke workspace, Anda harus [menentukan workspace](https://platform.claude.com/docs/id/manage-claude/authentication#select-a-workspace) tempat perintah Anda dijalankan. Lakukan ini dengan mengatur variabel lingkungan `ANTHROPIC_WORKSPACE_ID`, yang dibaca CLI secara otomatis, atau dengan menggunakan [flag `--workspace-id`](https://platform.claude.com/docs/id/cli-sdks-libraries/cli/using#global-flags). Nilainya harus berupa ID `wrkspc_...`. ```bash CLI ant messages create \ --workspace-id wrkspc_01... \ --model claude-opus-5-5 \ --max-tokens 1024 \ --message '{role: user, content: "Hello, Claude"}' ``` ## Periksa status autentikasi `ant auth status` mencetak sumber kredensial yang dipilih CLI (variabel lingkungan kunci API, login OAuth, federasi, Google Cloud, atau profil), profil aktif, workspace tempat token aktif terikat, dan jalur direktori konfigurasi. Gunakan untuk mendiagnosis mengapa beban kerja memilih kredensial atau workspace yang salah. ```bash CLI ant auth status ``` ```text Active profile: default Config dir: ~/.config/anthropic Profile config: ~/.config/anthropic/configs/default.json Credentials: ~/.config/anthropic/credentials/default.json Credentials (active) * Profile (user_oauth) [via active_config] sk-ant-oat01-EXA... ... Workspace (active) * Workspace wrkspc_01... (Engineering) ``` Baca baris `(active)` untuk melihat sumber kredensial dan workspace mana yang menang. Perintah ini melaporkan status daripada melakukan pemeriksaan kesehatan, jadi jangan membuat skrip terhadap status keluar. Untuk urutan lengkap sumber kredensial, lihat [Prioritas kredensial](https://platform.claude.com/docs/id/manage-claude/wif-reference#credential-precedence). ## Beralih antar workspace Token login interaktif terikat ke satu workspace. Untuk menggunakan CLI terhadap lebih dari satu workspace, login ke masing-masing di bawah profil bernama sendiri, lalu beralih di antaranya: ```bash CLI # 1. Buat profil (interaktif; pilih workspace lain di # browser, atau berikan --workspace-id untuk melewati pemilih): # ant auth login --profile other-ws # 2. Jadikan sebagai default untuk perintah berikutnya: ant profile activate other-ws # 3. Atau pilih untuk satu perintah tanpa mengubah default: ant --profile other-ws models list ANTHROPIC_PROFILE=other-ws ant models list ``` Jalankan [`ant auth status`](https://platform.claude.com/docs/id/cli-sdks-libraries/cli/authentication#check-authentication-status) untuk mengonfirmasi profil dan workspace mana yang aktif. `ANTHROPIC_API_KEY` atau `ANTHROPIC_AUTH_TOKEN` di lingkungan Anda lebih diprioritaskan daripada setiap profil (lihat [Prioritas kredensial](https://platform.claude.com/docs/id/manage-claude/wif-reference#credential-precedence)). Sampai Anda menghapusnya (unset), permintaan API menggunakan kredensial tersebut, profil mana pun yang Anda pilih, dan `ant` mencetak pesan ke stderr yang menyatakan hal tersebut. ## Kelola profil Subperintah `ant profile` memeriksa dan mengedit status profil secara langsung: ```bash CLI ant profile list ant profile get --profile other-ws ant profile set workspace_id wrkspc_01... --profile other-ws ``` Kunci yang dapat ditulis untuk `ant profile set` adalah `workspace_id`, `base_url`, `organization_id`, `scope`, `client_id`, dan `console_url`. Mengatur `workspace_id` mencatat workspace target dalam konfigurasi profil tetapi tidak mengikat ulang kredensial yang sudah diterbitkan; jalankan `ant auth login` lagi di bawah profil tersebut untuk mencetak token untuk workspace baru. Untuk skema file profil dan blok federasi, lihat [File konfigurasi profil](https://platform.claude.com/docs/id/manage-claude/wif-reference#profile-configuration-file). Untuk Workload Identity Federation, lihat [Ikhtisar autentikasi](https://platform.claude.com/docs/id/manage-claude/authentication) dan [referensi WIF](https://platform.claude.com/docs/id/manage-claude/wif-reference). ## Langkah selanjutnya Struktur perintah, format output, transformasi GJSON, dan body permintaan Kontrol versi untuk sumber daya API, pola scripting, dan penggunaan dari Claude Code Autentikasi non-interaktif untuk CI, server, dan kontainer