Alibaba Cloud Model Studio:Claude Code

Instal

npm install -g @anthropic-ai/claude-code

Lewati verifikasi login

Edit atau buat file ~/.claude.json (jalur Windows: C:\Users\<username>\.claude.json), lalu atur hasCompletedOnboarding menjadi true untuk melewati verifikasi login resmi Anthropic.

{
  "hasCompletedOnboarding": true
}

Token Plan (Team Edition)

Ganti YOUR_API_KEY dengan Kunci API khusus Token Plan (Team Edition). Untuk daftar model yang tersedia, lihat model yang didukung untuk Token Plan (Team Edition).

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.6-plus",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.6-plus"
    }
}

Coding Plan

Ganti YOUR_API_KEY dengan Kunci API khusus Coding Plan. Untuk daftar model yang tersedia, lihat model yang didukung untuk Coding Plan.

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://coding-intl.dashscope.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.7-plus",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-plus",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus"
    }
}

Pay-as-you-go

Ganti YOUR_API_KEY dengan Kunci API Alibaba Cloud Model Studio. Untuk daftar model yang tersedia, lihat API kompatibel Anthropic.

Atur ANTHROPIC_BASE_URL berdasarkan Wilayah. Kunci API harus sesuai dengan Wilayah yang dipilih:

• China North 2 (Beijing): https://dashscope.aliyuncs.com/apps/anthropic

• Singapura: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic. Ganti WorkspaceId dengan ID Ruang Kerja Anda yang sebenarnya.

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.6-plus",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.6-plus",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.6-plus",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.6-plus"
    }
}

Instal CC Switch

• macOS: brew tap farion1231/ccswitch && brew install --cask cc-switch, atau unduh file .dmg dari Releases.

• Windows: unduh installer .msi atau paket portabel .zip dari Releases.

• Linux: di Arch, jalankan paru -S cc-switch-bin; di distribusi lain, unduh .deb / .rpm / .AppImage dari Releases.

Tambahkan penyedia

1. Pada antarmuka utama CC Switch, pilih Claude Code di bilah ikon atas (ikon bintang oranye), lalu klik + di pojok kanan atas untuk membuka Add New Provider. Isi bidang berdasarkan tabel di bawah ini, lalu klik Add.

   Rencana penagihan	Konfigurasi
   Token Plan (Team Edition)	Nama penyedia: Bailian-Token Plan Kunci API: ambil dari konsol Endpoint: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
   Coding Plan	Nama penyedia: Bailian-Coding Plan Kunci API: ambil dari konsol Endpoint: https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
   Pay-as-you-go	Nama penyedia: Bailian-Pay-as-you-go Kunci API: Kunci API Model Studio Endpoint: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

2. Buka Advanced Options untuk mengonfigurasi pemetaan model. Atur model utama serta model default Haiku, Sonnet, dan Opus ke model yang didukung untuk rencana Anda. Contoh pemetaan:

   • Model utama: qwen3.7-max (tidak didukung oleh Coding Plan)

   • Model default Haiku: qwen3.6-flash (tidak didukung oleh Coding Plan)

   • Model default Sonnet: qwen3.7-max (tidak didukung oleh Coding Plan)

   • Model default Opus: qwen3.7-max (tidak didukung oleh Coding Plan)

3. Kembali ke antarmuka utama, klik Enable di samping penyedia, lalu mulai sesi Claude Code baru agar konfigurasi diterapkan.

Hubungkan Claude Code Desktop

1. Instal Claude Code Desktop dari halaman unduhan Claude.

2. Pada menu atas, buka Help > Troubleshooting > Enable Developer Mode. Setelah restart, menu Developer akan muncul di bagian atas.

3. Buka Developer > Configure Third-Party Inference, atur Connection ke Gateway, isi bidang berdasarkan tabel di bawah ini, lalu klik Apply locally:

   Bidang	Nilai
   Gateway base URL	Alamat listen router CC Switch. Default http://127.0.0.1:15721; jika diubah, pastikan konsisten dengan langkah berikutnya.
   Gateway API key	Kunci API Model Studio
   Gateway auth scheme	bearer
   Daftar model	ID model harus dalam gaya Anthropic, seperti claude-opus-4.7. Model aktual yang dipanggil ditentukan oleh routing CC Switch, yang sesuai dengan pemetaan model di Advanced Options. Nama tampilan hanya memengaruhi label dropdown.

4. Di CC Switch, klik ikon pengaturan di kiri atas, buka Router, lalu aktifkan Router Master Switch. Alamat listen default adalah 127.0.0.1:15721; jika diubah, pastikan konsisten dengan langkah sebelumnya.

5. Pilih ID model yang telah dikonfigurasi dari dropdown model di Claude Code Desktop untuk mulai menggunakannya.

VS Code

1. Cari Claude Code for VS Code di pasar ekstensi dan instal.

2. Restart VS Code dan klik ikon di pojok kanan atas untuk membuka Claude Code.

3. Ketik / di kotak dialog, pilih General config, lalu atur model di Selected Model.

JetBrains

1. Cari Claude Code di pasar ekstensi dan instal.

2. Restart IDE dan klik ikon di pojok kanan atas untuk mulai menggunakannya.

Kode error

Jika Anda mengalami error selama konfigurasi, rujuk dokumentasi FAQ untuk rencana penagihan Anda:

• Pay-as-you-go: Anthropic API Compatible - Kode Error

• Coding Plan: FAQ Coding Plan

• Token Plan (Team Edition): FAQ Token Plan (Team Edition)

Setelah menjalankan Claude Code, antarmuka menampilkan "Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR_BAD_REQUEST"

Claude Code terhubung ke layanan Anthropic resmi, bukan ke Alibaba Cloud Model Studio. Hal ini biasanya berarti variabel lingkungan tidak ada atau belum berlaku. Ikuti langkah-langkah berikut:

1. Periksa konfigurasi. Jalankan perintah /status setelah menjalankan Claude Code. Pastikan ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN mengarah ke alamat Model Studio. Jika output kosong atau menunjukkan alamat non-Model Studio, periksa konfigurasi settings.json.

2. Verifikasi hasCompletedOnboarding. Pastikan hasCompletedOnboarding diatur ke true dalam ~/.claude.json. Tanpa pengaturan ini, Claude Code akan mencoba terhubung ke layanan Anthropic resmi untuk verifikasi login saat startup.

3. Buka terminal baru. Setelah mengedit file konfigurasi, buka jendela terminal baru dan jalankan claude agar perubahan diterapkan.