Saat menggunakan Claude Code, penting untuk memahami bagaimana metode autentikasi diprioritaskan guna menghindari biaya API yang tidak terduga dan memastikan Anda menggunakan akun yang dimaksudkan.
Cara kerja autentikasi
Claude Code memprioritaskan kunci API variabel lingkungan daripada langganan yang diautentikasi.
Ini adalah perilaku yang disengaja dirancang untuk memberikan Anda fleksibilitas dalam memilih metode autentikasi Anda.
Ketika kunci API diatur sebagai variabel lingkungan, Anda akan dikenakan biaya melalui tarif bayar sesuai penggunaan API menggunakan akun API yang terkait dengan kunci tersebut.
Ini terjadi bahkan jika Anda masuk ke Claude Code dengan langganan claude.ai atau akun Console yang berbeda.
Praktik terbaik
Untuk menggunakan Claude Code dengan langganan Claude Anda: Biarkan variabel lingkungan ANTHROPIC_API_KEY tidak diatur.
Ini mencegah biaya API yang tidak terduga dan memastikan Anda menggunakan penggunaan yang disertakan dalam langganan Anda.
Jika Anda perlu menggunakan kunci API tertentu sesekali, aturnya secara sementara hanya saat diperlukan.
Jalankan /status di Claude Code secara berkala untuk memverifikasi metode autentikasi Anda saat ini.
Peringatan konflik autentikasi
Claude Code akan memberi tahu Anda ketika ada konflik antara langganan autentikasi Anda dan kunci API variabel lingkungan:
Selama penyiapan awal, jika kunci API terdeteksi di variabel lingkungan Anda, Claude Code akan meminta Anda untuk mengonfirmasi metode autentikasi mana yang ingin Anda gunakan.
Setelah login berhasil, Anda akan melihat notifikasi jika kedua kredensial aktif, memperingatkan Anda tentang potensi biaya API yang tidak terduga.
Periksa konfigurasi Anda saat ini
Untuk memverifikasi apakah kunci API diatur sebagai variabel lingkungan, jalankan /status di Claude Code. Ini akan menunjukkan kepada Anda metode autentikasi mana yang saat ini aktif.
Untuk memeriksa variabel lingkungan Anda secara langsung, jalankan salah satu perintah ini di terminal (di luar Claude Code):
macOS/Linux:
echo $ANTHROPIC_API_KEY
Windows CMD:
echo %ANTHROPIC_API_KEY%
Windows PowerShell:
echo $env:ANTHROPIC_API_KEY
Atur kunci API secara sementara
Jika Anda perlu menggunakan kunci API hanya untuk sesi terminal saat ini:
macOS/Linux:
export ANTHROPIC_API_KEY='your-api-key-here'
Windows CMD:
set ANTHROPIC_API_KEY=your-api-key-here
Windows PowerShell:
$env:ANTHROPIC_API_KEY="your-api-key-here"
Atur variabel lingkungan kunci API secara permanen
macOS/Linux:
For zsh (default on macOS):
bash
# Add to shell config file
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
# Apply changes
source ~/.zshrc
For bash:
bash
# Add to shell config file
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bash_profile
# Apply changes
source ~/.bash_profile
Windows:
Buka System Properties → Advanced → Environment Variables
Di bawah "User variables", klik "New"
Nama variabel: ANTHROPIC_API_KEY
Nilai variabel: your-api-key-here
Klik OK dan mulai ulang terminal Anda
Hapus variabel lingkungan kunci API
macOS/Linux (sementara):
unset ANTHROPIC_API_KEY
macOS (permanen):
# Remove from config file
sed -i '' '/ANTHROPIC_API_KEY/d' ~/.zshrc
source ~/.zshrc
Linux (permanen)
sed -i '/ANTHROPIC_API_KEY/d' ~/.zshrc
Windows CMD:
set ANTHROPIC_API_KEY=
Windows PowerShell:
Remove-Item Env:ANTHROPIC_API_KEY
Windows (permanen): Hapus variabel dari pengaturan System Environment Variables.
Masalah umum yang harus dihindari
Mengatur variabel lingkungan di file konfigurasi shell dan melupakannya.
Tidak memulai ulang terminal Anda setelah mengubah variabel lingkungan.
Mengasumsikan Anda menggunakan langganan Anda ketika kunci API dikonfigurasi di lingkungan Anda.
Jika Anda memiliki pertanyaan, silakan hubungi tim Dukungan kami.