Bypass Login Claude Code untuk Custom API

Claude Code secara default memaksa kamu untuk login ke Anthropic, bahkan ketika ANTHROPIC_API_KEY sudah di-set dengan benar. Ini jadi masalah kalau kamu mau pakai custom API endpoint seperti CLIProxy.

Artikel ini menjelaskan cara bypass login tersebut.

---

Masalahnya

Saat pertama kali menjalankan claude, kamu akan diminta untuk login meskipun environment variable sudah diset:

export ANTHROPIC_API_KEY="sk-xxx"
export ANTHROPIC_BASE_URL="https://custom-api.example.com"

Ini terjadi karena Claude Code mengecek status "onboarding completion" sebelum mengecek API credentials.

---

Solusi: Edit Config File

Langkah 1: Buat/Edit File Config

File konfigurasi Claude Code ada di ~/.claude.json. Buat atau edit file ini:

nano ~/.claude.json

Langkah 2: Tambahkan Field Onboarding

Tambahkan atau modifikasi content file menjadi:

{
  "hasCompletedOnboarding": true
}

Langkah 3: Quick Command (One-Liner)

Atau jalankan command ini di terminal untuk langsung apply:

echo '{"hasCompletedOnboarding": true}' > ~/.claude.json

Langkah 4: Restart Claude Code

Tutup dan buka kembali terminal, lalu jalankan claude lagi.

---

Verifikasi

Setelah menerapkan fix ini:

• ✅ Claude Code akan start tanpa login screen
• ⚠️ Mungkin muncul warning "mixed API and authentication usage" — ini normal
• ✅ Semua fitur (code completion, analysis, debugging) tetap berfungsi
• ℹ️ Warning tersebut hanya informasi, tidak memblokir fitur apapun

---

Platform-Specific

macOS / Linux

# Cek apakah file sudah ada
ls -la ~/.claude.json

# Buat file baru
echo '{"hasCompletedOnboarding": true}' > ~/.claude.json

# Verifikasi isi file
cat ~/.claude.json

Windows (PowerShell)

# Navigate ke user directory
cd $env:USERPROFILE

# Buat file
Set-Content -Path ".claude.json" -Value '{"hasCompletedOnboarding": true}'

Cara buka home folder di Windows:

1. Via Run Dialog: Tekan Win + R, ketik %USERPROFILE%, tekan Enter
2. Via File Explorer: Buka File Explorer, ketik %USERPROFILE% di address bar
3. Via Command Prompt: Ketik cd %USERPROFILE% lalu explorer .

Home folder biasanya di C:\Users\NamaKamu\. File .claude.json harus dibuat di folder ini.

---

Kenapa Ini Berhasil?

Method ini bekerja dengan cara menandai proses onboarding sebagai "selesai" di konfigurasi lokal. Dengan begitu, Claude Code langsung lanjut ke pengecekan API credentials dari environment variables, tanpa memaksa login ke Anthropic.

---

Troubleshooting

Masih diminta login?

1. Pastikan file ~/.claude.json sudah benar isinya
2. Restart terminal sepenuhnya (bukan cuma tab baru)
3. Cek permission file: chmod 644 ~/.claude.json

Environment variables tidak terbaca?

Verifikasi dengan:

echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_BASE_URL

Kalau kosong, pastikan sudah ditambahkan ke ~/.zshrc atau ~/.bashrc dan sudah di-source.

---

Catatan Keamanan

• Jangan share API key kamu ke siapapun
• File ~/.claude.json hanya berisi setting lokal, bukan credentials
• Bypass ini tidak melanggar ToS — kamu tetap pakai API key yang valid