> ## Documentation Index
> Fetch the complete documentation index at: https://gccai.heqingsong.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Menggunakan GccAi di Claude Code

> Panduan terperinci untuk mengonfigurasi dan menggunakan layanan API GccAi di Claude Code CLI, sehingga Anda dapat mengakses beberapa model AI untuk bantuan pemrograman dengan konfigurasi sederhana.

![Claude Code Main Interface](https://mintcdn.com/apicore/_4UKBib4iqrgK4Ws/images/integrations/claude-code/claude-code-cli.png?fit=max\&auto=format\&n=_4UKBib4iqrgK4Ws\&q=85\&s=219739f4029aa915b90253ad02b01437)

## Prasyarat

Claude Code adalah asisten pemrograman AI berbasis baris perintah dari Anthropic yang mendukung percakapan AI langsung, pembuatan kode, dan debugging di terminal.
Dengan terhubung ke GccAi, Anda dapat menggunakan beberapa model termasuk GPT, Claude, dan Gemini di Claude Code.

Sebelum memulai, pastikan Anda memiliki:

1. **API key GccAi sudah diperoleh**
   Masuk ke [Konsol GccAi](https://gccai.heqingsong.uk/keys) untuk mendapatkan API key Anda (diawali dengan `sk-`)

> [!NOTE]
>
> **Tips:** Jika Anda belum memiliki akun GccAi, daftar terlebih dahulu di [GccAi](https://gccai.heqingsong.uk) dan dapatkan API key Anda.

## Langkah 1: Instal Claude Code

Pilih salah satu metode berikut untuk instalasi:

**macOS / Linux (Direkomendasikan)**

Instal dengan skrip resmi:

```bash theme={null}
curl -fsSL https://claude.ai/install.sh | bash
```

Atau instal melalui Homebrew:

```bash theme={null}
brew install --cask claude-code
```

> [!NOTE]
>
> Jika mengalami masalah izin, tambahkan `sudo` sebelum perintah.

**Windows**

**PowerShell:**

```powershell theme={null}
irm https://claude.ai/install.ps1 | iex
```

**CMD:**

```cmd theme={null}
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```

**NPM Install**

Jika Node.js 18 atau lebih baru sudah terinstal, Anda dapat menginstal melalui npm:

```bash theme={null}
npm install -g @anthropic-ai/claude-code
```

Berfungsi di semua sistem operasi.

### Verifikasi Instalasi

Setelah instalasi, jalankan perintah berikut untuk memastikan:

```bash theme={null}
claude --version
```

Jika nomor versi ditampilkan (misalnya `1.x.x`), instalasi berhasil.

## Langkah 2: Konfigurasikan API GccAi

Tersedia tiga metode konfigurasi. Pilih yang paling sesuai dengan alur kerja Anda.

### Metode 1: Edit settings.json (Direkomendasikan)

Pendekatan paling stabil: konfigurasikan sekali dan pengaturannya tetap tersimpan.

**1. Temukan direktori konfigurasi:**

* Windows: Tekan `Win + R`, masukkan `%userprofile%\.claude`
* macOS: Tekan `Command + Shift + G`, masukkan `~/.claude`
* Linux: Buka direktori `~/.claude`

> [!NOTE]
>
> Jika direktori belum ada, jalankan `claude` sekali di terminal lalu tekan `Ctrl + C` untuk keluar; direktori akan dibuat otomatis.

**2. Buat atau edit file `settings.json`:**

```json theme={null}
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gccai.heqingsong.uk",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "claude-opus-5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
```

| Parameter | Deskripsi |
| - | - |
| `ANTHROPIC_BASE_URL` | Alamat API GccAi, tetap sebagai `https://gccai.heqingsong.uk` |
| `ANTHROPIC_AUTH_TOKEN` | API key GccAi Anda (diawali dengan `sk-`) |
| `ANTHROPIC_MODEL` | Model default yang digunakan; pilih dari daftar model di bawah |
| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Atur ke `1` untuk mengurangi permintaan jaringan non-esensial |

Simpan file dan mulai ulang Claude Code agar perubahan berlaku.

### Metode 2: Environment Variable Permanen

Tulis konfigurasi ke environment sistem agar semua jendela terminal memuatnya otomatis.

**macOS (zsh)**

```bash theme={null}
echo 'export ANTHROPIC_BASE_URL="https://gccai.heqingsong.uk"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-opus-5"' >> ~/.zshrc
source ~/.zshrc
```

**macOS / Linux (bash)**

```bash theme={null}
echo 'export ANTHROPIC_BASE_URL="https://gccai.heqingsong.uk"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL="claude-opus-5"' >> ~/.bashrc
source ~/.bashrc
```

**Windows**

**Opsi A: Pengaturan GUI**

1. Klik kanan "This PC" → "Properties" → "Advanced system settings" → "Environment Variables"
2. Tambahkan variabel pengguna baru:
   * `ANTHROPIC_BASE_URL` = `https://gccai.heqingsong.uk`
   * `ANTHROPIC_API_KEY` = `sk-xxxxxxxxxxxx`
   * `ANTHROPIC_MODEL` = `claude-opus-5`
3. Mulai ulang terminal

**Opsi B: Perintah PowerShell**

```powershell theme={null}
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://gccai.heqingsong.uk', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-xxxxxxxxxxxx', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-opus-5', 'User')
```

### Metode 3: Environment Variable Sementara

Cocok untuk pengujian cepat; konfigurasi akan hilang saat terminal ditutup.

**macOS / Linux**

```bash theme={null}
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"
export ANTHROPIC_MODEL="claude-opus-5"
export ANTHROPIC_BASE_URL="https://gccai.heqingsong.uk"
claude
```

**Windows (PowerShell)**

```powershell theme={null}
$env:ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"
$env:ANTHROPIC_MODEL="claude-opus-5"
$env:ANTHROPIC_BASE_URL="https://gccai.heqingsong.uk"
claude
```

**Windows (CMD)**

```cmd theme={null}
set ANTHROPIC_API_KEY=sk-xxxxxxxxxxxx
set ANTHROPIC_MODEL=claude-opus-5
set ANTHROPIC_BASE_URL=https://gccai.heqingsong.uk
claude
```

> [!WARNING]
>
> Environment variable sementara hanya berlaku di jendela terminal saat ini. Anda perlu mengaturnya lagi setelah berpindah jendela atau menutup terminal.

## Langkah 3: Mulai Menggunakan

### Verifikasi Konfigurasi

Jalankan Claude Code dan kirim pesan sederhana untuk memastikan:

```bash theme={null}
claude "Hello"
```

Jika Anda menerima respons AI, konfigurasi berhasil. Jika melihat error `401`, `403`, atau error lain, lihat FAQ di bawah.

### Mode Penggunaan

Claude Code menyediakan dua mode interaksi:

* **Mode interaktif**: Jalankan `claude` untuk percakapan berkelanjutan, ideal untuk tugas kompleks
* **Perintah tunggal**: Jalankan `claude "pertanyaan Anda"` untuk respons sekali jalan, ideal untuk kueri cepat

### Model yang Didukung

GccAi mendukung seluruh seri model Claude. Anda dapat beralih secara fleksibel sesuai kebutuhan:

| Nama Model | Fitur | Penggunaan yang Direkomendasikan |
| - | - | - |
| `claude-opus-5` | Model unggulan generasi baru | Arsitektur kompleks, debugging sulit |
| `claude-opus-4-6` | Kemampuan menyeluruh yang kuat | Arsitektur kompleks, debugging sulit |
| `claude-sonnet-4-6` | Performa dan kecepatan seimbang | Pemrograman harian, pembuatan kode |
| `claude-opus-4-5-20251101` | Penalaran tingkat lanjut | Kode kompleks, analisis mendalam |
| `claude-sonnet-4-5-20250929` | Kemampuan kode yang sangat baik | Desain algoritma, optimasi kode |
| `claude-haiku-4-5-20251001` | Respons ultra-cepat | Tanya jawab cepat, cuplikan kode |

Semua model di atas mendukung versi Thinking (penalaran diperluas); tambahkan `-thinking` ke ID model, misalnya `claude-opus-4-6-thinking`. Mode Thinking ideal untuk tugas kompleks yang membutuhkan penalaran mendalam.

> [!TIP]
>
> **Rekomendasi Model:**
>
> * 🚀 **Performa Tinggi:** `claude-opus-5` — Untuk tantangan kode dan arsitektur paling kompleks
> * ⚖️ **Performa Seimbang:** `claude-sonnet-4-6` — Untuk pemrograman harian
> * ⚡ **Respons Cepat:** `claude-haiku-4-5-20251001` — Saat Anda membutuhkan umpan balik instan
> * 🧠 **Pemikiran Mendalam:** `claude-opus-5-thinking` — Saat dibutuhkan penalaran mendalam

Untuk beralih model, gunakan perintah `/model` dalam mode interaktif, atau ubah kolom `ANTHROPIC_MODEL` di konfigurasi lalu mulai ulang.

### Perintah Umum

Berikut perintah dan pintasan yang sering digunakan di Claude Code:

| Perintah | Deskripsi |
| - | - |
| `claude` | Masuk ke mode interaktif |
| `claude "pertanyaan"` | Kueri tunggal |
| `claude --version` | Memeriksa versi |
| `/model` | Beralih model dalam mode interaktif |
| `/help` | Melihat informasi bantuan |
| `Ctrl + C` | Keluar dari mode interaktif |

## FAQ

### Q1: Masih melihat halaman pemilihan login setelah konfigurasi?

Jika "Select login method" masih muncul setelah startup, konfigurasi belum berlaku.

**Langkah pemecahan masalah:**

1. **Menggunakan settings.json**: Periksa apakah path file sudah benar
   * Windows: `C:\Users\<username>\.claude\settings.json`
   * macOS / Linux: `~/.claude/settings.json`
2. **Menggunakan environment variable**: Pastikan Anda menjalankan Claude Code dari **jendela terminal yang sama** tempat variabel diatur
3. **Periksa format JSON**: Pastikan kurung, koma, dan tanda kutip semuanya benar

### Q2: Mendapat error 401 / 403?

| Kode Error | Arti | Solusi |
| - | - | - |
| `401 Unauthorized` | API key hilang atau tidak valid | Periksa apakah key benar dan diawali dengan `sk-` |
| `403 Forbidden` | Izin tidak cukup atau key kedaluwarsa | Buka [Konsol](https://gccai.heqingsong.uk/keys) untuk memverifikasi status key |

Pastikan juga `ANTHROPIC_BASE_URL` diatur ke `https://gccai.heqingsong.uk`, bukan alamat resmi Anthropic.

### Q3: Error "Unable to connect"?

Ini berarti Claude Code gagal terhubung ke layanan API.

1. Periksa koneksi jaringan Anda
2. Verifikasi `ANTHROPIC_BASE_URL` dikonfigurasi dengan benar
3. Jika menggunakan proxy, pastikan proxy mengizinkan akses ke `gccai.heqingsong.uk`

### Q4: "Auth conflict" error?

Jika Anda melihat pesan seperti:

```
Auth conflict: Both a token (claude.ai) and an API key (ANTHROPIC_API_KEY) are set.
```

Ini berarti Anda masuk ke claude.ai sekaligus mengatur API Key, sehingga terjadi konflik.

**Solusi:** Jalankan `/logout` dalam mode interaktif Claude Code untuk keluar dari claude.ai, sehingga hanya konfigurasi API Key yang tersisa.

### Q5: Error max\_tokens saat menggunakan model non-Claude?

Jika Anda melihat error seperti:

```
max_tokens is too large: 32000. This model supports at most 16384 completion tokens.
```

Ini terjadi karena Claude Code secara default mengirim permintaan dengan parameter model Claude (32000 token), sementara beberapa model non-Claude (misalnya `gpt-4o`) memiliki batas token lebih rendah.

**Solusi:** Beralih ke model Claude (misalnya `claude-sonnet-4-6`) yang kompatibel secara native dengan Claude Code dan tidak akan menyebabkan masalah ini.

### Q6: Respons lambat?

1. Beralih ke model yang lebih cepat (misalnya `claude-haiku-4-5-20251001` atau `claude-sonnet-4-6`)
2. Persingkat prompt Anda untuk mengurangi panjang konteks
3. Periksa kondisi jaringan Anda

### Q7: Bagaimana beralih model?

Dua cara:

1. **Dalam mode interaktif**: Masukkan perintah `/model`
2. **Edit konfigurasi**: Ubah kolom `ANTHROPIC_MODEL` di `settings.json` atau environment variable, lalu mulai ulang Claude Code

### Q8: Apakah Claude Code membaca file lokal secara otomatis?

Tidak. Claude Code mengharuskan Anda merujuk file secara eksplisit, dan akan meminta konfirmasi sebelum melakukan operasi sensitif. Disarankan menggunakannya di direktori proyek khusus.

### Q9: Bagaimana menganalisis file lokal dengan Claude Code?

Dalam mode interaktif, Anda dapat merujuk file dengan:

* Memasukkan path file secara langsung
* Menyeret file ke jendela terminal
* Menyalin-tempel konten file

### Q10: Bagaimana memeriksa penggunaan dan biaya?

Masuk ke [Konsol GccAi](https://gccai.heqingsong.uk/overview) untuk melihat:

* Statistik panggilan API
* Detail konsumsi token
* Statistik dan tren biaya

## Dukungan

Jika Anda mengalami masalah:

* 📚 [Dokumentasi GccAi](https://gccai.heqingsong.uk)
* 💬 [Komunitas Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @GccAi\_](https://x.com/GccAi_)
* 📧 Dukungan teknis: [zhihong@gccai.heqingsong.uk](mailto:zhihong@gccai.heqingsong.uk)

***

> **[Mulai dengan GccAi](https://gccai.heqingsong.uk)**
>
> Daftar GccAi sekarang, dapatkan API key Anda, dan rasakan asisten pemrograman multi-model di Claude Code!


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.