MaCloud AI - Cara pakai CC Switch untuk Claude Code, Codex dan Gemini CLI

Kenapa pakai CC Switch?

Tidak perlu mengetik environment variable atau mengedit settings.json, config.toml dan .env satu per satu.
Satu API key MaCloud AI bisa dipasang ke Claude Code, Codex dan Gemini CLI sekaligus. Kalau kamu punya paket coding, ketiganya memakai kuota yang sama.
Ganti provider cukup satu klik (misalnya dari akun resmi ke MaCloud AI, atau sebaliknya). Plugin, MCP dan hook kamu tidak ikut berubah.

Yang perlu disiapkan

Claude Code, Codex atau Gemini CLI sudah terpasang (salah satu saja juga boleh).
Akun MaCloud AI dengan saldo atau paket, dan API key dari tab API Key di konsol.
Nama model dari halaman model, misalnya hk-5-5 untuk Claude Code, tt-6-luna untuk Codex, gem-3.8-flash untuk Gemini CLI.

Cara pasang CC Switch

Windows 10/11: unduh file .msi dari halaman Releases di GitHub (proyek farion1231/cc-switch), lalu jalankan.
macOS 12 ke atas: brew install --cask cc-switch, atau unduh file .dmg dari halaman Releases.
Linux: unduh .deb, .rpm atau .AppImage dari halaman Releases.

Unduh hanya dari halaman Releases resmi proyek di GitHub. Jangan pasang versi dari grup atau situs lain, karena aplikasi ini menyimpan API key kamu.

Cara tercepat: impor sekali klik dari konsol

Pasang CC Switch dan buka aplikasinya sekali.
Di konsol → tab API Key, klik ikon unduh di baris key kamu.
Pilih Claude Code, Codex atau Gemini CLI. Browser akan minta izin membuka CC Switch; izinkan.
Di CC Switch, cek data provider "MaCloud AI" (base URL, key dan model sudah terisi), simpan, lalu klik Enable.

Mau isi sendiri atau mengubah model? Ikuti langkah manual di bawah.

Tambah MaCloud AI untuk Claude Code

Buka CC Switch, pilih Claude Code di sidebar.
Klik + (Add Provider) di kanan atas, lalu pilih Custom Configuration.
Isi nama, misalnya "MaCloud AI", lalu isi konfigurasi seperti contoh di bawah: base URL https://api.macloudai.com (tanpa /v1) dan API key kamu.
Klik Add, lalu klik Enable pada provider MaCloud AI.
Buka terminal di folder proyek dan jalankan claude. Kirim pesan pendek, lalu cek tab Pemakaian di konsol.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.macloudai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "hk-5-5"
  }
}

Untuk Claude Code, biarkan Upstream Format di Advanced Options tetap Anthropic Messages (Native). MaCloud AI melayani format Anthropic langsung, jadi tidak perlu routing lokal.

Tambah MaCloud AI untuk Codex

Pilih Codex di sidebar, klik +, pilih Custom Configuration.
Di bagian auth.json, isi API key kamu.
Di bagian config.toml, isi seperti contoh di bawah. Untuk Codex, base URL pakai /v1.
Klik Add, lalu Enable. Tutup dan buka lagi terminal, lalu jalankan codex.

{
  "OPENAI_API_KEY": "sk-..."
}

model_provider = "macloud"
model = "tt-6-luna"

[model_providers.macloud]
name = "MaCloud AI"
base_url = "https://api.macloudai.com/v1"
wire_api = "responses"
requires_openai_auth = true

Tambah MaCloud AI untuk Gemini CLI

Pilih Gemini CLI di sidebar, klik +, pilih Custom Configuration.
Isi konfigurasi seperti contoh di bawah: base URL https://api.macloudai.com (tanpa /v1), API key, dan nama model.
Klik Add, lalu Enable. Buka lagi terminal dan jalankan gemini.

{
  "env": {
    "GOOGLE_GEMINI_BASE_URL": "https://api.macloudai.com",
    "GEMINI_API_KEY": "sk-...",
    "GEMINI_MODEL": "gem-3.8-flash"
  }
}

Cara cek dan atasi error

Gejala	Penyebab biasa
Error 401	API key salah, ada spasi saat menyalin, atau key sudah dihapus
Error 403	Saldo habis dan kuota paket hari ini juga habis
Error 404 / model tidak ditemukan	Nama model salah ketik, atau `/v1` salah tempat (Claude Code dan Gemini CLI tanpa `/v1`, Codex pakai `/v1`)
Codex atau Gemini CLI masih memakai provider lama	Terminal belum dibuka ulang setelah klik Enable
Tidak muncul apa-apa di tab Pemakaian	Provider MaCloud AI belum di-Enable, atau ada environment variable lama yang menimpa; hapus variabel lama dari `~/.zshrc` / `~/.bashrc` / pengaturan Windows

Pertanyaan umum

Q1Apakah CC Switch gratis?

Ya. CC Switch adalah aplikasi open source dan gratis. Yang kamu bayar hanya pemakaian model di MaCloud AI, dari saldo atau paket.

Q2Apakah perlu routing lokal (local proxy)?

Tidak. MaCloud AI melayani format Anthropic untuk Claude Code, format Responses untuk Codex dan format Gemini untuk Gemini CLI secara langsung. Biarkan Upstream Format di pilihan native.

Q3Kenapa Codex pakai /v1 tapi Claude Code tidak?

Codex memakai format OpenAI, yang alamatnya diakhiri /v1. Claude Code dan Gemini CLI memakai format Anthropic dan Gemini, yang alamatnya tanpa /v1.

Q4Apakah paket coding berlaku untuk ketiga tool?

Ya. Paket menempel ke akun MaCloud AI, jadi Claude Code, Codex dan Gemini CLI memakai kuota paket yang sama.

Q5Bisa balik ke akun resmi Anthropic atau OpenAI?

Bisa. Tambahkan provider resmi di CC Switch, lalu klik Enable di provider itu kapan saja. Kamu bisa pindah bolak-balik.

Daftar gratis → Lihat model & harga

Cara pakai CC Switch untuk Claude Code, Codex dan Gemini CLI