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

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

## Pendahuluan

CC-Switch adalah aplikasi desktop open source yang menyatukan pengelolaan konfigurasi penyedia API di berbagai alat CLI coding AI seperti Claude Code, Codex, dan Gemini CLI.
Aplikasi ini mengubah proses edit file konfigurasi yang merepotkan menjadi beberapa klik di GUI. Setelah penyedia ditambahkan, Anda dapat beralih antar layanan API secara instan tanpa mengedit file konfigurasi secara manual.

Dengan menghubungkan GccAi melalui CC-Switch, Anda dapat mengonfigurasi layanan GccAi untuk Claude Code dan Codex dengan mudah, lalu beralih bebas antar beberapa penyedia.

## Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. **Alat CLI yang didukung sudah terinstal**
   Minimal satu alat CLI yang didukung sudah terinstal, seperti [Claude Code](https://gccai.heqingsong.uk/id/integrations/dev-tool/claude-code.md) atau [Codex CLI](https://gccai.heqingsong.uk/id/integrations/dev-tool/codex-cli.md)

2. **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 CC-Switch

Pilih metode instalasi sesuai sistem operasi Anda:

**macOS**

Instal melalui Homebrew (direkomendasikan):

```bash theme={null}
brew tap farion1231/ccswitch
brew install --cask cc-switch
```

Anda juga dapat mengunduh installer `.dmg` dari [GitHub Releases](https://github.com/farion1231/cc-switch/releases). CC-Switch sudah ditandatangani dan dinotariskan oleh Apple, sehingga dapat diinstal langsung (memerlukan macOS 12 atau lebih baru).

**Windows**

Unduh installer `.msi` atau `.zip` portabel dari [GitHub Releases](https://github.com/farion1231/cc-switch/releases).

Requires Windows 10 or later.

**Linux**

Unduh paket yang sesuai dari [GitHub Releases](https://github.com/farion1231/cc-switch/releases):

* Debian / Ubuntu: `.deb` package
* Fedora / RHEL: `.rpm` package
* Universal: `.AppImage` format
* Arch Linux: `paru -S cc-switch-bin`

> [!NOTE]
>
> Saat CC-Switch dijalankan pertama kali, aplikasi ini otomatis mendeteksi alat CLI yang terinstal di mesin Anda dan dapat mengimpor konfigurasi yang ada sebagai penyedia default.

## Langkah 2: Tambahkan Penyedia GccAi

Di bagian atas jendela utama CC-Switch, Anda dapat beralih antar grup alat CLI. Ikuti langkah di bawah sesuai alat yang ingin dikonfigurasi.

**Konfigurasi untuk Claude Code**

**1. Beralih ke grup Claude Code**

Pilih **Claude Code** di bagian atas jendela utama.

**2. Buka panel Add Provider**

Klik tombol **+** di sudut kanan atas jendela utama.

**3. Isi detail penyedia**

Isi formulir sebagai berikut:

| Field | Value | Description |
| - | - | - |
| **Name** | `GccAi` | Label kustom agar mudah dikenali |
| **Endpoint URL** | `https://gccai.heqingsong.uk` | Base URL API GccAi |
| **API Key** | `sk-xxxxxxxxxxxx` | API key GccAi Anda |
| **API Format** | `Anthropic Messages` | Pertahankan format bawaan native Anthropic |

![CC-Switch main interface](https://mintcdn.com/apicore/_1ZGW4_iuaSfzpC6/images/integrations/cc-switch/step-2.png?fit=max\&auto=format\&n=_1ZGW4_iuaSfzpC6\&q=85\&s=7d91af6ec3f40c7bb2666ba455a09faa)

**4. Simpan konfigurasi**

Klik **Add** untuk menyimpan. GccAi akan muncul di daftar penyedia.

**Konfigurasi untuk Codex**

**1. Beralih ke grup Codex**

Pilih **Codex** di bagian atas jendela utama.

**2. Buka panel Add Provider**

Klik tombol **+** di sudut kanan atas jendela utama.

**3. Isi detail penyedia**

Penyedia Codex dikonfigurasi melalui dua blok:

Isi API key di blok **auth.json**:

```json theme={null}
{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}
```

Isi konfigurasi penyedia di blok **config.toml**:

```toml theme={null}
model = "gpt-5.5"
model_provider = "gccai"

[model_providers.gccai]
name = "GccAi"
base_url = "https://gccai.heqingsong.uk/v1"
wire_api = "responses"
requires_openai_auth = true
```

**4. Simpan konfigurasi**

Beri nama penyedia (misalnya `GccAi`) lalu klik **Add** untuk menyimpan. CC-Switch akan memvalidasi JSON dan TOML secara otomatis.

> [!NOTE]
>
> **Tentang URL endpoint:** Claude Code menggunakan format native Anthropic dengan URL `https://gccai.heqingsong.uk` (tanpa `/v1`); Codex menggunakan format yang kompatibel dengan OpenAI dengan URL `https://gccai.heqingsong.uk/v1` (dengan
> `/v1`). Do not mix them up.

## Langkah 3: Beralih Penyedia

Setelah ditambahkan, Anda dapat beralih antara GccAi dan penyedia lain kapan saja:

### Beralih di jendela utama

1. Pilih **GccAi** di daftar penyedia
2. Klik tombol **Enable** (atau **Use**)
3. Toast "Switched successfully" mengonfirmasi perubahan

![CC-Switch main interface](https://mintcdn.com/apicore/LdtR-ceBhXT3_e8B/images/integrations/cc-switch/step-1.png?fit=max\&auto=format\&n=LdtR-ceBhXT3_e8B\&q=85\&s=46a838ac93d721254556c464cc0b4864)

### Beralih dari system tray

CC-Switch tetap berada di system tray, sehingga Anda dapat beralih tanpa membuka jendela utama:

1. Klik ikon CC-Switch di system tray
2. Klik nama penyedia target di menu; perubahan langsung berlaku

> [!NOTE]
>
> **Tentang aktivasi:** Claude Code mendukung hot switching; sesi baru akan mengambil konfigurasi baru secara otomatis. Setelah beralih untuk Codex, Anda perlu memulai ulang terminal atau Codex agar perubahan berlaku.

## Didukung Models

Setelah beralih ke penyedia GccAi, Anda dapat menggunakan berbagai model di alat CLI terkait:

| ID Model | Keunggulan | Kasus Penggunaan yang Direkomendasikan |
| - | - | - |
| `claude-opus-4-6` | Strongest overall | Complex architecture, hard debugging |
| `claude-sonnet-4-6` | Balanced perf & speed | Day-to-day coding, code generation |
| `gpt-5.5` | Excellent coding skills | Complex engineering tasks |
| `gpt-4o` | High performance, fast | Everyday coding, fast iteration |

> [!TIP]
>
> Di Claude Code, gunakan perintah `/model` untuk beralih model; di Codex, gunakan juga perintah `/model`. Untuk daftar model lengkap, lihat [panduan Claude Code](https://gccai.heqingsong.uk/id/integrations/dev-tool/claude-code.md) dan [panduan Codex CLI
> guide](https://gccai.heqingsong.uk/id/integrations/dev-tool/codex-cli.md).

## FAQ

### Q1: Switching providers doesn't take effect?

* **Claude Code**: Mendukung hot switching; mulai sesi baru. Jika masih belum berfungsi, mulai ulang Claude Code
* **Codex**: Setelah beralih, mulai ulang terminal atau Codex

### Q2: API key dilaporkan tidak valid?

1. Pastikan API key diawali dengan `sk-` dan disalin lengkap tanpa spasi tambahan
2. Buka [Konsol GccAi](https://gccai.heqingsong.uk/keys) untuk memastikan key aktif
3. Periksa bahwa URL endpoint benar (Claude Code menggunakan `https://gccai.heqingsong.uk`, Codex menggunakan `https://gccai.heqingsong.uk/v1`)

### Q3: Error format saat menambahkan penyedia Codex?

CC-Switch memvalidasi `auth.json` (sintaks JSON) dan `config.toml` (sintaks TOML). Pastikan:

* Kurung, tanda kutip, dan koma dalam JSON lengkap
* Tidak menggunakan tanda kutip full-width atau smart quotes
* Nama kolom dalam TOML dieja dengan benar

### Q4: Which files does CC-Switch modify?

CC-Switch menulis ke file konfigurasi setiap alat:

* **Claude Code**: `~/.claude/settings.json`
* **Codex**: `~/.codex/config.toml` and `~/.codex/auth.json`

CC-Switch otomatis mencadangkan file tersebut sebelum beralih, sehingga Anda tidak perlu mengeditnya secara manual.

### Q5: Bagaimana melihat penggunaan API dan penagihan?

Masuk ke [Konsol GccAi](https://gccai.heqingsong.uk/overview) untuk melihat statistik panggilan API, detail konsumsi token, dan tren biaya.

## Dukungan dan Bantuan

Jika Anda mengalami masalah saat menggunakan CC-Switch:

* 📚 [Pusat Dokumentasi GccAi](https://gccai.heqingsong.uk)
* 📚 [CC-Switch Project Page](https://github.com/farion1231/cc-switch)
* 💬 [Discord Community](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, ambil API key Anda, dan kelola beberapa alat coding AI dengan mudah di CC-Switch!


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