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

# Menggunakan APIMart di Claude Code

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

<Frame>
  <img src="https://mintcdn.com/apicore/_4UKBib4iqrgK4Ws/images/integrations/claude-code/claude-code-cli.png?fit=max&auto=format&n=_4UKBib4iqrgK4Ws&q=85&s=219739f4029aa915b90253ad02b01437" alt="Claude Code Main Interface" width="2574" height="360" data-path="images/integrations/claude-code/claude-code-cli.png" />
</Frame>

## 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 APIMart, Anda dapat menggunakan beberapa model termasuk GPT, Claude, dan Gemini di Claude Code.

Sebelum memulai, pastikan Anda memiliki:

1. **API key APIMart sudah diperoleh**
   Masuk ke [Konsol APIMart](https://apimart.ai/keys) untuk mendapatkan API key Anda (diawali dengan `sk-`)

<Note>**Tips:** Jika Anda belum memiliki akun APIMart, daftar terlebih dahulu di [APIMart](https://apimart.ai) dan dapatkan API key Anda.</Note>

## Langkah 1: Instal Claude Code

Pilih salah satu metode berikut untuk instalasi:

<Tabs>
  <Tab title="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.</Note>
  </Tab>

  <Tab title="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
    ```
  </Tab>

  <Tab title="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.
  </Tab>
</Tabs>

### 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 APIMart

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.</Note>

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

```json theme={null}
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apimart.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6-apimart",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
```

| Parameter                                  | Deskripsi                                                      |
| ------------------------------------------ | -------------------------------------------------------------- |
| `ANTHROPIC_BASE_URL`                       | Alamat API APIMart, tetap sebagai `https://api.apimart.ai`     |
| `ANTHROPIC_AUTH_TOKEN`                     | API key APIMart 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.

<Tabs>
  <Tab title="macOS (zsh)">
    ```bash theme={null}
    echo 'export ANTHROPIC_BASE_URL="https://api.apimart.ai"' >> ~/.zshrc
    echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.zshrc
    echo 'export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"' >> ~/.zshrc
    source ~/.zshrc
    ```
  </Tab>

  <Tab title="macOS / Linux (bash)">
    ```bash theme={null}
    echo 'export ANTHROPIC_BASE_URL="https://api.apimart.ai"' >> ~/.bashrc
    echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.bashrc
    echo 'export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"' >> ~/.bashrc
    source ~/.bashrc
    ```
  </Tab>

  <Tab title="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://api.apimart.ai`
       * `ANTHROPIC_API_KEY` = `sk-xxxxxxxxxxxx`
       * `ANTHROPIC_MODEL` = `claude-sonnet-4-6-apimart`
    3. Mulai ulang terminal

    **Opsi B: Perintah PowerShell**

    ```powershell theme={null}
    [System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.apimart.ai', 'User')
    [System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-xxxxxxxxxxxx', 'User')
    [System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-sonnet-4-6-apimart', 'User')
    ```
  </Tab>
</Tabs>

### Metode 3: Environment Variable Sementara

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

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"
    export ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"
    export ANTHROPIC_BASE_URL="https://api.apimart.ai"
    claude
    ```
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={null}
    $env:ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"
    $env:ANTHROPIC_MODEL="claude-sonnet-4-6-apimart"
    $env:ANTHROPIC_BASE_URL="https://api.apimart.ai"
    claude
    ```
  </Tab>

  <Tab title="Windows (CMD)">
    ```cmd theme={null}
    set ANTHROPIC_API_KEY=sk-xxxxxxxxxxxx
    set ANTHROPIC_MODEL=claude-sonnet-4-6-apimart
    set ANTHROPIC_BASE_URL=https://api.apimart.ai
    claude
    ```
  </Tab>
</Tabs>

<Warning>Environment variable sementara hanya berlaku di jendela terminal saat ini. Anda perlu mengaturnya lagi setelah berpindah jendela atau menutup terminal.</Warning>

## 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

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

| Nama Model                   | Fitur                           | Penggunaan yang Direkomendasikan     |
| ---------------------------- | ------------------------------- | ------------------------------------ |
| `claude-opus-4-6`            | Kemampuan menyeluruh terkuat    | 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.

#### Model Diskon APIMart

APIMart menawarkan model diskon eksklusif dengan harga **hanya 20% dari harga resmi**, dengan kemampuan yang sama. Cukup tambahkan `-apimart` ke ID model:

| Nama Model Diskon                    | Fitur                           |
| ------------------------------------ | ------------------------------- |
| `claude-opus-4-6-apimart`            | Kemampuan menyeluruh terkuat    |
| `claude-sonnet-4-6-apimart`          | Performa dan kecepatan seimbang |
| `claude-opus-4-5-20251101-apimart`   | Penalaran tingkat lanjut        |
| `claude-sonnet-4-5-20250929-apimart` | Kemampuan kode yang sangat baik |
| `claude-haiku-4-5-20251001-apimart`  | Respons ultra-cepat             |

Versi Thinking juga tersedia, misalnya `claude-opus-4-6-thinking-apimart`, `claude-sonnet-4-6-thinking-apimart`, dll.

<Tip>
  **Rekomendasi Model:**

  * 💰 **Nilai Terbaik:** `claude-sonnet-4-6-apimart` — Pilihan terbaik untuk pemrograman harian, hanya 20% dari harga resmi
  * 🚀 **Performa Tinggi:** `claude-opus-4-6-apimart` — Untuk tantangan kode dan arsitektur paling kompleks
  * ⚡ **Respons Cepat:** `claude-haiku-4-5-20251001-apimart` — Saat Anda membutuhkan umpan balik instan
  * 🧠 **Pemikiran Mendalam:** `claude-opus-4-6-thinking-apimart` — Saat dibutuhkan penalaran mendalam
</Tip>

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://apimart.ai/keys) untuk memverifikasi status key |

Pastikan juga `ANTHROPIC_BASE_URL` diatur ke `https://api.apimart.ai`, 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 `api.apimart.ai`

### 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-apimart`) 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-apimart` atau `claude-sonnet-4-6-apimart`)
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 APIMart](https://apimart.ai/overview) untuk melihat:

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

## Dukungan

Jika Anda mengalami masalah:

* 📚 [Dokumentasi APIMart](https://docs.apimart.ai)
* 💬 [Komunitas Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 Dukungan teknis: [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="Mulai dengan APIMart" icon="rocket" href="https://apimart.ai">
  Daftar APIMart sekarang, dapatkan API key Anda, dan rasakan asisten pemrograman multi-model di Claude Code!
</Card>
