Memahami prioritas autentikasi di Claude Code
Saat menggunakan Claude Code, penting untuk memahami bagaimana metode autentikasi diprioritaskan untuk menghindari biaya API yang tidak terduga dan memastikan Anda menggunakan akun yang dimaksud.
Penting: Jika Anda memiliki variabel lingkungan ANTHROPIC_API_KEY yang diatur di sistem Anda, Claude Code akan menggunakan kunci API ini untuk autentikasi alih-alih langganan Claude.ai Anda (Pro, Max, Team, atau Enterprise), yang mengakibatkan biaya penggunaan API daripada menggunakan penggunaan yang termasuk dalam langganan Anda.
Cara Kerja Autentikasi
Claude Code memprioritaskan kunci API variabel lingkungan daripada langganan yang terautentikasi.
Ini adalah perilaku yang disengaja yang dirancang untuk memberi Anda fleksibilitas dalam memilih metode autentikasi Anda.
Ketika kunci API diatur sebagai variabel lingkungan, Anda akan dikenakan biaya melalui tarif bayar sesuai pemakaian 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 termasuk dalam langganan Anda.
Jika Anda perlu menggunakan kunci API tertentu sesekali, atur 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 terautentikasi Anda dan kunci API variabel lingkungan:
Selama pengaturan 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
Memeriksa 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 sedang 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
Mengatur 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"
Mengatur Variabel Lingkungan Kunci API Secara Permanen
macOS/Linux:
Untuk zsh (default di macOS):
bash
# Tambahkan ke file konfigurasi shell
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
# Terapkan perubahan
source ~/.zshrc
Untuk bash:
bash
# Tambahkan ke file konfigurasi shell
echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.bash_profile
# Terapkan perubahan
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 restart terminal Anda
Menghapus Variabel Lingkungan Kunci API
macOS/Linux (sementara):
unset ANTHROPIC_API_KEY
macOS (permanen):
# Hapus dari file konfigurasi
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 me-restart 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 Product Support kami.