Langsung ke konten utama

Claude Code

Claude Code adalah alat coding agentic resmi Anthropic yang berjalan di terminal. Panduan ini menjelaskan cara mengonfigurasikannya agar menggunakan KiosAPI sebagai penyedia backend.

Prasyarat

  • Node.js 18+ — periksa dengan node --version
  • Kunci API KiosAPI (diawali dengan sk-) dari Dashboard → Token Management

Instalasi

Instal Claude Code secara global melalui npm:
Verifikasi instalasi:

Dapatkan Kunci API Anda

  1. Masuk ke Dashboard KiosAPI
  2. Buka Token Management
  3. Buat atau salin kunci API yang ada (diawali dengan sk-)
Gunakan grup token Claude-Kiro untuk Claude Code. Grup ini merutekan ke endpoint Claude yang dioptimalkan untuk tugas coding dan lebih murah daripada grup default.

Lewati Onboarding

Setelah instalasi, lewati wizard onboarding interaktif dengan mengedit ~/.claude.json:
Ini mencegah Claude Code meminta Anda masuk dengan akun Anthropic.

Konfigurasi Proyek

Buat file .claude/settings.json di root proyek untuk menyuntikkan variabel lingkungan:
Ganti sk-xxx dengan kunci KiosAPI Anda yang sebenarnya.
ANTHROPIC_BASE_URL harus berupa https://kiosapi.com (tanpa /v1). Claude Code menambahkan jalur API secara otomatis.

Konfigurasi Global

Anda juga dapat mengatur variabel lingkungan ini secara global agar Claude Code berfungsi di direktori mana pun.

Windows (PowerShell)

macOS / Linux

Tambahkan berikut ke ~/.bashrc atau ~/.zshrc:
Kemudian muat ulang shell Anda:

Lokasi file konfigurasi global

Model Claude terkini di KiosAPI

Daftar otoritatif dengan harga live ada di halaman Model & Harga (filter grup Claude-Kiro).

Penggunaan

Buka direktori proyek Anda dan jalankan Claude Code:
Ini membuka sesi interaktif tempat Anda dapat meminta Claude membaca, menulis, dan mengubah kode.

Praktik Terbaik

CLAUDE.md

Buat file CLAUDE.md di root proyek untuk memberi Claude konteks permanen tentang codebase, konvensi, dan perintah umum Anda. Claude Code membaca file ini secara otomatis saat dimulai.

Izin File

Claude Code akan meminta izin sebelum membaca atau menulis file. Anda dapat menyetujui direktori terlebih dahulu dengan menambahkannya ke .claude/settings.json:

Manajemen Konteks

Sesi panjang dapat menghabiskan banyak konteks. Gunakan perintah slash berikut untuk mengelolanya:

Mengganti Model

Ubah model default secara global:
Atau beralih ke model yang lebih ringan untuk respons lebih cepat:

Pemecahan Masalah

400 Bad Request / Flag Beta Tidak Valid

Jika Anda melihat kesalahan seperti Invalid beta flag atau status 400:
Tambahkan variabel lingkungan ini ke konfigurasi Anda:
Ini menonaktifkan header beta eksperimental yang mungkin tidak didukung KiosAPI.

Kesalahan Panjang / Token Output Maksimum

Jika muncul kesalahan tentang panjang output atau batas maksimum token:
Tambahkan ini ke blok env .claude/settings.json:

Koneksi Ditolak / 401 Unauthorized

  • Pastikan kunci API benar dan diawali dengan sk-
  • Pastikan ANTHROPIC_BASE_URL adalah https://kiosapi.com (tanpa garis miring akhir dan /v1)
  • Pastikan grup token mendukung model Claude (gunakan Claude-Kiro)

Verifikasi Pengaturan

Jalankan pengujian sederhana:
Jika Claude merespons, konfigurasi Anda sudah berfungsi dengan benar.

Butuh Bantuan?