Ekstensi VS Code Claude Code dengan API pihak ketiga: penyiapan environmentVariables
Wokey Team · 2026-09-24
Jawaban singkat: untuk mengarahkan ekstensi VS Code Claude Code ke API pihak ketiga, taruh ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN di claudeCode.environmentVariables pada pengaturan pengguna VS Code, lalu aktifkan claudeCode.disableLoginPrompt. Meng-export variabel di terminal umumnya tidak sampai ke ekstensi. ~/.claude/settings.json juga tidak cukup: pemeriksaan login ekstensi sebelum peluncuran tidak bisa membacanya, sehingga layar masuk terus muncul.
Penyiapan
- Instal ekstensinya. Dibutuhkan VS Code 1.94.0 atau lebih baru. Cari "Claude Code" (penerbit: Anthropic) di tampilan Extensions (
Cmd/Ctrl+Shift+X). Cursor bisa menginstal ekstensi yang sama, dan editor seperti VSCodium bisa mendapatkannya dari Open VSX. - Buka pengaturan pengguna Anda. Tekan
Cmd/Ctrl+Shift+Plalu jalankan Preferences: Open User Settings (JSON). - Tambahkan pengaturannya. Di dalam
{}terluar, tambahkan:
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" }
],
"claudeCode.disableLoginPrompt": true
}
- Muat ulang. Jalankan Developer: Reload Window dari command palette, lalu buka panel Claude Code.
Tiga hal yang perlu diperhatikan:
ANTHROPIC_BASE_URLhanya berisi domain, tanpa/v1; ekstensi sendiri yang menambahkan/v1/messages.- Pengaturan ini ditaruh di pengaturan pengguna, bukan di
.vscode/settings.jsonmilik workspace, yang sering di-commit ke repositori. disableLoginPromptmelewati permintaan masuk. Deskripsi resminya menyebut pengaturan ini "for third-party provider setups".
Mengapa export dan settings.json tidak cukup
Sebelum ekstensi menjalankan proses Claude, ia memeriksa apakah kredensial tersedia. Pemeriksaan itu hanya membaca claudeCode.environmentVariables:
- VS Code yang dibuka dari Dock, menu Start, atau ikon desktop tidak mendapat variabel yang Anda export di
~/.zshrc. - Blok
envdi~/.claude/settings.jsonsampai ke proses Claude yang dijalankan ekstensi, tetapi tidak ke pemeriksaan login ekstensi itu sendiri.
Jadi dengan hanya settings.json dan disableLoginPrompt nonaktif, gejala khasnya adalah ekstensi yang terus meminta Anda masuk. Untuk memakai variabel shell sesekali, jalankan code . dari terminal tempat variabel itu diatur. Untuk pemakaian sehari-hari, pengaturan pengguna di atas lebih andal.
Pastikan permintaan melewati Wokey
Jalankan /status di kotak prompt ekstensi (membutuhkan Claude Code v2.1.280 atau lebih baru). Anthropic base URL di tab Status seharusnya bertuliskan https://api.wokey.ai.
Memilih model
Pilih Switch model… dari menu perintah, atau klik nama model di bawah kotak prompt. Untuk menetapkan model yang dipakai tiap tingkat Opus, Sonnet, dan Haiku, tambahkan variabelnya ke daftar yang sama:
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" },
{ "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5" },
{ "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" }
]
}
Yang tidak tersedia dengan API pihak ketiga
Dengan API pihak ketiga, ekstensi tidak menyediakan fitur yang membutuhkan akun claude.ai:
- Bilah penggunaan paket, dikte suara, dan tab Web untuk sesi cloud.
- Tidak ada item Sign out di menu.
- Mengirim
/bugmenampilkan error dan tidak mengirim apa pun.
Akun claude.ai yang sebelumnya Anda pakai masuk dengan /login tetap tersimpan tetapi tidak dipakai.
Dibandingkan CLI di terminal, ekstensi juga hanya mendukung sebagian perintah, dan tidak punya pintasan Bash ! maupun pelengkapan tab.
Pemecahan masalah
Layar masuk terus muncul. claudeCode.environmentVariables tidak ada atau berada di tempat yang salah (misalnya pengaturan workspace), atau Anda belum memuat ulang jendela sejak perubahan itu. Periksa juga apakah disableLoginPrompt bernilai true.
invalid x-api-key. Permintaan menuju alamat Anthropic sendiri karena ANTHROPIC_BASE_URL tidak diterapkan. Wokey tidak pernah mengembalikan pesan itu; lihat panduan invalid x-api-key.
404 yang menyebut /v1/v1/messages. Base URL kelebihan /v1. Ubah menjadi https://api.wokey.ai.
Tidak ada balasan dan tidak ada error. Saran resminya adalah menjalankan claude di terminal untuk error yang lebih rinci. Ekstensi membawa CLI sendiri tetapi tidak menambahkan claude ke PATH Anda, jadi instal CLI secara terpisah dan atur variabelnya seperti di panduan base URL Claude Code.
Pengguna JetBrains
Plugin JetBrains tidak membawa CLI. Ia menjalankan perintah claude yang Anda instal di terminal IDE; path-nya bisa diubah di Settings → Tools → Claude Code [Beta] → Claude command. Jadi JetBrains dikonfigurasi dengan cara yang sama seperti CLI: taruh ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN di blok env pada ~/.claude/settings.json. Lihat panduan base URL Claude Code.
Pertanyaan umum
Bagaimana cara mengatur base URL Claude Code di VS Code?
Di pengaturan pengguna VS Code (JSON), tambahkan claudeCode.environmentVariables berisi ANTHROPIC_BASE_URL (https://api.wokey.ai, tanpa /v1) dan ANTHROPIC_AUTH_TOKEN, atur claudeCode.disableLoginPrompt ke true, lalu jalankan Reload Window.
Mengapa ekstensi terus meminta saya masuk?
Pemeriksaan login ekstensi sebelum peluncuran hanya membaca claudeCode.environmentVariables, bukan variabel shell atau ~/.claude/settings.json. Taruh variabelnya di pengaturan pengguna Anda, aktifkan disableLoginPrompt, lalu muat ulang jendela.
Bisakah ini ditaruh di .vscode/settings.json milik workspace?
Sebaiknya jangan. Pengaturan workspace sering di-commit ke repositori, sehingga key Anda bisa bocor. Pengaturan pengguna toh berlaku untuk semua proyek.
Bagaimana cara mengonfigurasi plugin JetBrains?
Plugin JetBrains menjalankan perintah claude yang Anda instal, jadi konfigurasikan seperti CLI: taruh ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN di blok env pada ~/.claude/settings.json.