Skip to main content

Claude Code

Gunakan model Alibaba Cloud Model Studio di Claude Code.

Mulai cepat

Pilih klien yang Anda gunakan dan selesaikan konfigurasi.
  • CLI
  • CC Switch
  • Plugin IDE
  • Aplikasi desktop
  1. 1

    Konfigurasikan model

    • Token Plan
    • Metode penagihan pay-as-you-go
    • Coding Plan
    Ganti YOUR_API_KEY dengan API Key Token Plan Anda:
    export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
    export ANTHROPIC_BASE_URL="https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic"
    export ANTHROPIC_MODEL="auto"
    export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen3.6-flash"
    export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen3.8-flash"
    export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen4-max-preview"
    export CLAUDE_CODE_SUBAGENT_MODEL="auto"
    export CLAUDE_CODE_MAX_CONTEXT_TOKENS="983616"
    
    Saat menggunakan qwen4-max-preview, jika output panjang terpotong, atur CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000.
    Untuk menggunakan qwen4-max, setel ANTHROPIC_DEFAULT_OPUS_MODEL ke qwen4-max dan biarkan CLAUDE_CODE_MAX_CONTEXT_TOKENS tetap 983616. Jika output panjang terpotong, setel CLAUDE_CODE_MAX_OUTPUT_TOKENS=131072. qwen4-max memiliki panjang konteks 1M token; output maksimum dalam mode non-thinking adalah 131.072 token, dan gabungan maksimum untuk thinking dan jawaban akhir adalah 262.144 token; nilai default-nya adalah reasoning_effort=high dan thinking_budget=131072.
    Variabel lingkungan di atas hanya berlaku untuk sesi terminal saat ini. Untuk membuat konfigurasi permanen, gunakan Konfigurasi melalui file konfigurasi.
  2. 2

    Verifikasi

    Jalankan perintah berikut untuk memverifikasi:
    claude -p "你好"
    

Konfigurasi melalui file konfigurasi

Selain metode di atas, Anda juga dapat terhubung melalui file konfigurasi.
  1. 1

    Buka atau buat file konfigurasi

    • macOS / Linux: ~/.claude/settings.json
    • Windows: C:\Users\<username>\.claude\settings.json
  2. 2

    Tulis konfigurasi

    • Token Plan
    • Metode penagihan pay-as-you-go
    • Coding Plan
    Ganti YOUR_API_KEY dengan API Key Token Plan Anda:
    {
        "env": {
            "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
            "ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
            "ANTHROPIC_MODEL": "auto",
            "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
            "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-flash",
            "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen4-max-preview",
            "CLAUDE_CODE_SUBAGENT_MODEL": "auto",
            "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
        }
    }
    
  3. 3

    Verifikasi

    Setelah menyimpan, jalankan perintah berikut untuk verifikasi:
    claude -p "你好"
    

Konfigurasikan ukuran jendela konteks

Claude Code menggunakan jendela konteks 200K secara default. Saat model mendukung 1M, jendela konteks dapat diperluas menjadi 1M (1.000.000 token). Metode 1: Atur melalui variabel lingkungan Tambahkan CLAUDE_CODE_MAX_CONTEXT_TOKENS ke bidang env di ~/.claude/settings.json:
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus",
        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
    }
}
Metode 2: Melalui akhiran nama model Tambahkan akhiran [1m] setelah nama model, berlaku untuk model Model Studio yang mendukung konteks 1M:
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_BASE_URL": "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
        "ANTHROPIC_MODEL": "qwen3.7-plus[1m]",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus[1m]",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-plus[1m]",
        "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus[1m]"
    }
}
Setelah mengubah konfigurasi, buka jendela terminal baru dan mulai ulang Claude Code agar perubahan berlaku.

Konfigurasi mode izin

Claude Code menyediakan mode izin berikut:
  • default: meminta konfirmasi pengguna untuk setiap operasi.
  • acceptEdits: menyetujui pengeditan file secara otomatis, sementara operasi lain tetap meminta konfirmasi.
  • plan: mode perencanaan hanya-baca yang tidak melakukan perubahan.
  • auto: classifier menentukan apakah suatu operasi boleh dijalankan, sehingga mengurangi permintaan konfirmasi. Dalam sesi terminal interaktif dan sesi VS Code, Claude Code v2.1.283 dan versi lebih baru menggunakan mode ini secara default.
  • dontAsk: tidak bertanya; operasi yang memerlukan konfirmasi langsung ditolak.
  • bypassPermissions: melewati semua pemeriksaan izin.
  • delegate: mode delegasi.
Saat menggunakan mode auto dengan endpoint Token Plan, pemeriksaan classifier mungkin gagal mengembalikan hasil. Pada beberapa model, muncul Not run · auto mode's check had no usable answer, sehingga operasi tidak dijalankan.Saat Anda menemui pesan ini, Anda dapat menyetel permissions.defaultMode ke default atau acceptEdits, atau menyesuaikan model yang digunakan classifier (ANTHROPIC_DEFAULT_SONNET_MODEL; Claude Code v2.1.302 dan versi lebih baru juga dapat menyetel CLAUDE_CODE_AUTO_MODE_MODEL), lalu mulai ulang sesi.
Metode 1: argumen baris perintah Gunakan --permission-mode untuk menentukan mode izin default untuk sesi ini:
claude --permission-mode plan
claude --permission-mode acceptEdits
Metode 2: perintah interaktif Masukkan /permissions dalam sesi untuk mengelola aturan yang telah disetujui dan ditolak sebelumnya untuk tool, mendukung tool bash, edit, dan MCP. Metode 3: konfigurasi settings.json Konfigurasikan di bidang permissions pada ~/.claude/settings.json:
{
    "permissions": {
        "allow": ["Bash(git:*)", "Read", "Edit"],
        "deny": ["Bash(rm:*)"],
        "defaultMode": "default"
    }
}

Hubungkan ke Model Studio CLI

  1. 1

    Instal Model Studio CLI

    请帮我全局安装阿里云百炼 CLI 命令行工具:npm install -g bailian-cli
    
  2. 2

    Konfigurasikan API Key

    Buka konsol Model Studio untuk mendapatkan API Key, lalu sampaikan kepada Claude Code:
    配置我的 API Key 是:sk-xxxxxxxxxxxxx
    
  3. 3

    Mulai

    Jelaskan kebutuhan Anda langsung dalam bahasa alami, misalnya:
    帮我生成 6 张亚马逊电商主图,产品是白色无线蓝牙耳机。
    帮我生成一段 30 秒的白色无线蓝牙耳机产品演示视频。
    

Kode error

Jika Anda mengalami error selama konfigurasi, lihat dokumentasi FAQ untuk paket yang sesuai:

FAQ

Metode koneksi penagihan pay-as-you-go tetap tidak berubah, menggunakan API Key umum Model Studio dan Base URL. Setelah Anda membeli paket penghematan, paket tersebut berlaku otomatis, dan biaya panggilan dipotong secara otomatis sesuai urutan pemotongan. Untuk detailnya, lihat Paket penghematan.

Bagaimana cara melewati verifikasi login resmi Anthropic?

Edit atau buat ~/.claude.json (jalur Windows: C:\Users\<username>\.claude.json), dan atur hasCompletedOnboarding menjadi true untuk melewati verifikasi login resmi Anthropic.
{
  "hasCompletedOnboarding": true
}
Error ini menunjukkan bahwa jenis API Key tidak cocok dengan ANTHROPIC_BASE_URL. Model Studio menyediakan tiga metode koneksi, masing-masing menggunakan base_url yang berbeda dan API Key khusus, dan keduanya harus digunakan sebagai pasangan yang sesuai:

Metode koneksi

base_url

API Key

Token Plan

https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

API Key Token Plan

penagihan pay-as-you-go

https://dashscope-intl.aliyuncs.com/apps/anthropic

API Key Model Studio (diawali sk-)

Coding Plan

https://coding-intl.dashscope.aliyuncs.com/apps/anthropic

API Key Coding Plan

Langkah pemecahan masalah adalah sebagai berikut:
  1. Periksa URL permintaan. Lihat nilai ANTHROPIC_BASE_URL di ~/.claude/settings.json.
  2. Konfirmasi jenis API Key. Bandingkan dengan tabel di atas dan pastikan jenis API Key yang Anda gunakan cocok dengan base_url.
  3. Perbaiki konfigurasi. Saat menggunakan API Key pay-as-you-go Model Studio, atur ANTHROPIC_BASE_URL ke https://dashscope-intl.aliyuncs.com/apps/anthropic.
Error ini menunjukkan bahwa Claude Code mencoba terhubung ke layanan Anthropic resmi, bukan Alibaba Cloud Model Studio. Ini biasanya disebabkan oleh variabel lingkungan yang tidak dikonfigurasi dengan benar atau belum berlaku. Ikuti langkah-langkah berikut untuk memecahkan masalah:
  1. Periksa konfigurasi. Setelah memulai Claude Code, jalankan perintah /status untuk mengonfirmasi apakah ANTHROPIC_BASE_URL dan ANTHROPIC_AUTH_TOKEN menunjuk ke URL Model Studio dengan benar. Jika output kosong atau menunjuk ke URL non-Model Studio, periksa apakah konfigurasi settings.json sudah benar.
  2. Konfirmasi hasCompletedOnboarding. Periksa apakah hasCompletedOnboarding dalam file ~/.claude.json disetel ke true. Jika tidak disetel, Claude Code akan mencoba terhubung ke layanan Anthropic resmi untuk verifikasi login setelah dimulai.
  3. Buka kembali terminal. Setelah mengubah file konfigurasi, Anda perlu membuka jendela terminal baru dan menjalankan claude kembali agar konfigurasi berlaku.
  4. Perbarui Claude Code. Jika semua langkah di atas tidak berhasil, versi Claude Code mungkin terlalu lama. Jalankan npm install -g @anthropic-ai/claude-code@latest untuk memperbarui ke versi terbaru, lalu coba lagi.
Endpoint kompatibilitas lama https://dashscope-intl.aliyuncs.com/api/v2/apps/claude-code-proxy hanya mendukung model yang telah dihentikan, dan menentukan model lain tidak akan berlaku. Untuk memanggil model yang tersedia, migrasikan ke API baru seperti yang dijelaskan dalam dokumen ini.
Pesan ini berasal dari pemeriksaan konektivitas yang dijalankan CC Switch saat menyimpan penyedia—pemeriksaan ini menyelidiki endpoint daftar model (seperti /v1/models) pada URL permintaan yang dikonfigurasi. Endpoint kompatibel Anthropic milik Model Studio (berakhiran /apps/anthropic) hanya menyediakan endpoint percakapan /v1/messages dan tidak menyediakan endpoint daftar model, sehingga penyelidikan mengembalikan 404, dan CC Switch pun melaporkan "No available model list endpoint found".Pesan ini tidak memengaruhi penggunaan normal Claude Code dan dapat diabaikan. Claude Code memulai percakapan melalui /v1/messages, dan model yang digunakan ditentukan langsung oleh pemetaan model di Advanced options CC Switch, tanpa bergantung pada penemuan otomatis melalui endpoint daftar model. Ketika URL permintaan dan API Key dikonfigurasi dengan benar, cukup klik Enable dan mulai sesi Claude Code baru untuk mengobrol secara normal.Jika percakapan tetap gagal, konfirmasi hal berikut: URL permintaan berakhiran /apps/anthropic tanpa /v1 tambahan, dan pemetaan model di Advanced options telah diisi dengan model yang didukung oleh paket yang sesuai.
Jika, setelah pemetaan model dikonfigurasi, panggilan gagal di Claude Code dan mengembalikan error AccessDenied (HTTP 403, kode error access_denied), periksa apakah model ditandai sebagai "Retiring" di Models pada konsol Model Studio. Model yang ditandai "Retiring" tetap muncul dalam daftar, tetapi panggilan API mengembalikan 403 AccessDenied. Langkah pemecahan masalah adalah sebagai berikut:
  1. Periksa apakah model ditandai sebagai "Retiring". Cari model yang Anda gunakan di Models pada konsol Model Studio dan lihat label statusnya.
  2. Beralih ke model terbaru yang tersedia. Ganti model lama dalam pemetaan model (seperti qwen-coder-turbo-0919) dengan versi terbaru yang tersedia (seperti qwen3.8-max).
  3. Konfigurasi ulang pemetaan model dan uji. Perbarui pemetaan model di Advanced options CC Switch, klik Enable, dan mulai sesi Claude Code baru untuk memverifikasi.
Model yang ditandai "Retiring" di Models pada konsol Model Studio dapat menjadi tidak tersedia kapan saja. Perhatikan siklus hidup model dan periksa ketersediaan model di Models.