Opsi autentikasi CLI

CLI ant mendukung beberapa sumber kredensial. Quickstart membahas jalur cepat 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. Perintah ini membuka alur OAuth berbasis browser terhadap Claude Console dan menyimpan kredensial yang dihasilkan di bawah $ANTHROPIC_CONFIG_DIR (lihat Direktori konfigurasi untuk default spesifik OS). Pada host jarak jauh atau di lingkungan apa pun tanpa browser lokal, berikan --no-browser untuk mencetak URL otorisasi dan tempelkan kode yang dikembalikan ke terminal.

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 <profile-name>

Selama alur browser, Anda memilih organisasi lalu sebuah workspace. Token yang diterbitkan dicakupkan ke workspace tersebut, sehingga CLI hanya dapat melihat sumber daya yang termasuk di dalamnya. Berikan --workspace-id untuk mengikat langsung dan melewati pemilih. Untuk bekerja di lebih dari satu workspace, lihat Beralih antar workspace.

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 sebagai gantinya.

Login menulis kredensial ke credentials/<profile>.json. Login pertama untuk sebuah profil juga membuat configs/<profile>.json dan menetapkannya sebagai profil aktif. Untuk menghapus kredensial yang tersimpan, jalankan ant auth logout, atau ant auth logout --all untuk menghapus setiap profil.

Kunci API

CLI juga membaca kunci API Anda dari variabel lingkungan ANTHROPIC_API_KEY. Dapatkan kunci dari Claude Console.

Untuk menimpa kunci pada satu pemanggilan, berikan --api-key. Untuk mengarahkan ke host API yang berbeda, atur ANTHROPIC_BASE_URL atau berikan --base-url.

Memeriksa status autentikasi

ant auth status mencetak sumber kredensial yang dipilih CLI (variabel lingkungan kunci API, login OAuth, federasi, atau profil), profil aktif, workspace tempat token aktif terikat, dan jalur direktori konfigurasi. Gunakan ini untuk mendiagnosis mengapa suatu beban kerja memilih kredensial atau workspace yang salah.

ant auth status

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 terpilih. Perintah ini melaporkan status alih-alih melakukan pemeriksaan kesehatan, jadi jangan membuat skrip berdasarkan status keluarnya. Untuk urutan lengkap sumber kredensial, lihat Prioritas kredensial.

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 tersendiri, lalu beralih di antaranya:

# 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-perintah berikutnya:
ant profile activate other-ws

# 3. Atau pilih untuk satu perintah saja tanpa mengubah default:
ant --profile other-ws models list
ANTHROPIC_PROFILE=other-ws ant models list

Jalankan ant auth status untuk mengonfirmasi profil dan workspace mana yang aktif.

Mengelola profil

Subperintah ant profile memeriksa dan mengedit status profil secara langsung:

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 menerbitkan token bagi workspace baru.

Untuk skema file profil dan blok federasi, lihat File konfigurasi profil. Untuk Workload Identity Federation, lihat Ikhtisar autentikasi dan Referensi WIF.