Panduan API Claude

Panduan ini untuk semua pengguna: Windows, Mac dan Linux; pengguna baharu atau berpengalaman; yang menggunakan satu app atau ketiga-tiganya; dan yang melanggan satu provider atau lebih. Mulakan di bahagian 1 untuk mengetahui kaedah yang sesuai untuk anda.

1.Mula di sini — pilihan kaedah dan istilah asas

Pilih mengikut situasi anda

Istilah asas

2.App dan file yang diubah

• Claude Code: jika base URL tidak ditetapkan, Claude Code menggunakan langganan claude.ai.
• OpenCode: boleh menyimpan beberapa provider serentak. Model dipilih terus dalam OpenCode melalui /models.
• Hermes Agent: di Windows, Hermes hanya berjalan dalam WSL2. Skrip mengesan folder Hermes dalam WSL secara automatik.

VS Code

3.Provider dan sokongan app

Nama kecil di bawah nama provider (mwapi, bedrock, mirai) ialah nama yang digunakan dalam command switch-api. Cara mendapatkan API key berbeza bagi setiap provider:

MWAPI · panduan penuh MWAPI →

• Key sah 60 hari; kuota API boleh digunakan dalam 30 hari. CDK baharu boleh diaktifkan pada akaun yang sama untuk menambah kuota.
• Halaman Keys ada butang Use Key yang memberi command pemasangan rasmi untuk Claude Code dan OpenCode (macOS/Linux atau Windows). Itu cara alternatif kepada switch-api. Pilih satu cara sahaja bagi setiap app.
• Semak baki token: log masuk ke akaun anda di api.mwapi.dev; baki dipaparkan dalam akaun.
• Video panduan rasmi: Google Drive

Bedrock · panduan penuh Bedrock →

• Kredit boleh ditambah pada key yang sama berkali-kali. Baki token kekal pada key sehingga key tamat tempoh.
• Halaman CHECK memaparkan status key, baki token, tarikh tamat, had kadar (contoh 60 request/minit) dan sejarah tambah kredit.
• Auth: x-api-key atau Authorization: Bearer, kedua-duanya diterima.

MiraiAPI · panduan penuh MiraiAPI →

• Kod redeem bermula dengan MR-. Halaman Usage ada tab Check key, Redeem code, Models & pricing dan Setup guide.
• Halaman Config menjana command pemasangan satu baris (PowerShell, CMD, macOS/Linux) untuk app pilihan. Itu cara alternatif kepada switch-api. Pilih satu cara sahaja bagi setiap app.
• Kod redeem bukan API key. Redeem mencipta API key baharu, atau menambah kuota pada key sedia ada; untuk menambah kuota kemudian, anda tidak perlu menjalankan setup semula.
• Video panduan rasmi: YouTube

Nama model

Default ikut sumber rasmi setiap provider (2 Nov 2026): installer MWAPI, panduan Bedrock, dan halaman Config MiraiAPI. Perhatikan: MiraiAPI menggunakan titik (claude-opus-4.8, claude-sonnet-5.5), bukan sempang. Bedrock: kebanyakan model mempunyai context 1M token; claude-haiku-5-5 dan model 4.5 ke bawah 200K. Untuk Claude Code, tambah akhiran [1m] pada nama model (contoh claude-fable-5-1[1m]) supaya Claude Code menggunakan bajet context 1M; gateway Bedrock membuang akhiran ini dan menggunakan model yang sama.

Menggunakan provider selain tiga di atas? Gunakan Kaedah B dan rujuk bahagian 10.

4.Kesilapan lazim

5.Kaedah A — Skrip PowerShell disyorkan

Keperluan

• Windows 10 atau 11 sahaja. PowerShell tersedia secara default pada semua komputer Windows. Node.js, Git atau software lain tidak diperlukan.
• Pengguna Mac / Linux: gunakan Kaedah B.
• Hanya untuk provider mwapi, bedrock dan mirai. Untuk provider lain, gunakan Kaedah B.

New-Item -ItemType Directory -Force "$env:USERPROFILE\Documents\switch-api" | Out-Null; cd "$env:USERPROFILE\Documents\switch-api"; [Net.ServicePointManager]::SecurityProtocol = 'Tls12'; irm https://panduanapiclaude.pages.dev/switch-api.ps1 -OutFile switch-api.ps1

cd "$env:USERPROFILE\Documents\switch-api"

powershell -ExecutionPolicy Bypass -File .\switch-api.ps1 install

switch-api list

switch-api setup mwapi
switch-api setup bedrock
switch-api setup mirai

switch-api claude   use mwapi
switch-api opencode use bedrock
switch-api hermes   use mwapi

Command lain

switch-api list                # senarai provider, status API key dan settings aktif semua app
switch-api current             # settings aktif semua app
switch-api <app> current       # settings aktif satu app
switch-api <app> off           # buang settings switch-api daripada app tersebut
switch-api                     # paparan bantuan

Fungsi skrip

• Membuat backup file settings terlebih dahulu (<file>.bak.<nama>.<tarikh>).
• Claude Code: menukar baris ANTHROPIC_* dalam blok env.
• OpenCode: menambah provider dengan nama (switch-api). Provider yang anda tambah sendiri tidak diubah. Jika file ialah opencode.jsonc, komen di dalamnya tidak dikekalkan (salinan asal ada dalam backup).
• Hermes Agent: menggantikan blok model: dengan blok bertanda # >>> switch-api. Blok asal anda dijadikan komen dan dipulihkan semasa off.
• Settings lain (statusLine, plugin, theme, MCP, profiles) tidak diubah.

Menukar nama model

notepad "$env:USERPROFILE\.switch-api\providers\mirai.conf"

Buang tanda # di hadapan baris yang berkaitan, tukar nama model, kemudian simpan. Seterusnya jalankan semula command use bagi app tersebut.

Uninstall

switch-api uninstall

Command switch-api dan entri PATH akan dibuang. Anda kemudian akan ditanya dua soalan (jawapan default ialah Tidak; tekan Enter untuk melangkau): sama ada hendak membuang settings switch-api daripada semua app (sama seperti off), dan sama ada hendak memadam semua API key. File backup *.bak.* tidak akan diubah.

Struktur file

6.Kaedah B — Edit manual

Pengguna Mac / Linux

Contoh command di bawah ditulis untuk PowerShell (Windows). Dalam Terminal Mac / Linux, gunakan padanan berikut:

Contoh Mac / Linux untuk Claude Code:

cp ~/.claude/settings.json ~/.claude/settings.json.bak
nano ~/.claude/settings.json

Dalam nano: simpan dengan Ctrl+O, Enter; keluar dengan Ctrl+X. Kandungan JSON / YAML yang perlu ditulis adalah sama untuk semua sistem operasi.

6A. Claude Code

Copy-Item "$env:USERPROFILE\.claude\settings.json" "$env:USERPROFILE\.claude\settings.json.bak"
notepad "$env:USERPROFILE\.claude\settings.json"

{
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.mwapi.dev",
        "ANTHROPIC_AUTH_TOKEN": "<api-key-mwapi>",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5"
    }
}

{
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.mwapi.dev",
        "ANTHROPIC_AUTH_TOKEN": "<api-key-mwapi>",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5"
    },   <-- tanda koma ini wajib
    "theme": "dark"
}

// bedrock
"ANTHROPIC_BASE_URL": "https://api.bedrock.com.de",
"ANTHROPIC_AUTH_TOKEN": "<api-key-bedrock>",

// mirai (model: claude-opus-4.8 / claude-sonnet-5)
"ANTHROPIC_BASE_URL": "https://api.miraiapi.com",
"ANTHROPIC_AUTH_TOKEN": "<api-key-mirai>",

Get-Content "$env:USERPROFILE\.claude\settings.json" -Raw | ConvertFrom-Json

Copy-Item "$env:USERPROFILE\.claude\settings.json.bak" "$env:USERPROFILE\.claude\settings.json"

6B. OpenCode

Copy-Item "$env:USERPROFILE\.config\opencode\opencode.json" "$env:USERPROFILE\.config\opencode\opencode.json.bak"
notepad "$env:USERPROFILE\.config\opencode\opencode.json"

{
    "$schema": "https://opencode.ai/config.json",
    "providers": {
        "mwapi": {
            "name": "mwapi",
            "package": "@opencode/ai/providers/anthropic-compatible",
            "settings": {
                "baseURL": "https://api.mwapi.dev/v1",
                "apiKey": "<api-key-mwapi>"
            },
            "headers": {
                "Authorization": "Bearer <api-key-mwapi>"
            },
            "models": {
                "claude-opus-5-5": { "name": "claude-opus-5-5" },
                "claude-sonnet-5-5": { "name": "claude-sonnet-5-5" }
            }
        }
    },
    "model": "mwapi/claude-opus-5-5"
}

{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "mwapi": {
            "npm": "@ai-sdk/anthropic",
            "name": "mwapi",
            "options": {
                "baseURL": "https://api.mwapi.dev/v1",
                "apiKey": "<api-key-mwapi>"
            },
            "models": {
                "claude-opus-5-5": { "name": "claude-opus-5-5" },
                "claude-sonnet-5-5": { "name": "claude-sonnet-5-5" }
            }
        }
    },
    "model": "mwapi/claude-opus-5-5"
}

Get-Content "$env:USERPROFILE\.config\opencode\opencode.json" -Raw | ConvertFrom-Json

6C. Hermes Agent

Windows: semua langkah di bawah dijalankan dalam WSL. Mac / Linux: jalankan terus dalam Terminal.

Cara paling mudah: jalankan hermes model dan pilih Custom endpoint. Masukkan base URL, API key dan nama model. Atau edit file secara manual:

cp ~/.hermes/config.yaml ~/.hermes/config.yaml.bak
nano ~/.hermes/config.yaml

Gantikan blok model: dengan (gantikan API key):

model:
  provider: custom
  default: "claude-opus-5-5"
  base_url: "https://api.mwapi.dev/v1"
  api_key: "<api-key-mwapi>"
  api_mode: chat_completions

Untuk bedrock, tukar base_url kepada https://api.bedrock.com.de/v1.

MiraiAPI — format rasmi daripada halaman Config MiraiAPI (base URL tanpa /v1, key dalam ~/.hermes/.env):

# ~/.hermes/config.yaml
model:
  provider: custom
  base_url: "https://api.miraiapi.com"
  model: "claude-opus-4.8"

# ~/.hermes/.env
OPENAI_API_KEY=<api-key-mirai>

6D. VS Code

Extension Claude Code: tiada tindakan tambahan diperlukan. Extension ini membaca file settings yang sama dengan Claude Code CLI. Selepas menukar provider, jalankan Ctrl+Shift+P (Mac: Cmd+Shift+P) → Developer: Reload Window.

Extension Cline:

1. Pasang extension Cline, kemudian buka Cline Settings.
2. API Provider: OpenAI Compatible
3. Base URL: dengan /v1, contohnya https://api.mwapi.dev/v1
4. API Key: paste API key provider
5. Model ID: nama model daripada jadual Nama model, contohnya claude-sonnet-4-6

Tetapan ini mengikut panduan rasmi MWAPI dan Bedrock untuk Cline (dan Roo Code). Panduan Bedrock juga menunjukkan pilihan kedua: API Provider: Anthropic dengan base URL https://api.bedrock.com.de/v1.

7.Kaedah C — OpenCode Console OpenCode 2

OpenCode Console ialah servis pilihan di website OpenCode. Anda mendaftarkan custom provider di website, dan OpenCode 2 mengambilnya melalui /connect. Kaedah ini tidak wajib; Kaedah A dan B masih berfungsi untuk OpenCode 2 tanpa akaun Console.

Bil: provider yang mengecaj token. Console tidak menolak kredit untuk custom provider, tetapi tetap merekod penggunaannya.

Langkah di atas berdasarkan dokumentasi OpenCode (opencode.ai/v2/docs/console/providers). Paparan website mungkin berubah.

8.Penyelesaian masalah

9.Keselamatan

• Jangan ambil screenshot file tersebut.
• Jangan commit file tersebut ke repository Git. Tambahkan ke .gitignore jika folder tersebut berada dalam repository.
• Semua kod dan prompt anda dihantar melalui server provider pihak ketiga. Jika provider tersebut tidak boleh dipercayai, jangan letakkan maklumat rahsia atau file sensitif dalam projek yang dibuka.
• Skrip switch-api.ps1 itu sendiri selamat untuk dikongsi kerana ia hanya mengandungi URL awam dan nama model, tanpa API key.

10.Semakan sebelum memilih provider baharu

Menggunakan provider lain (Kaedah B)

Ikut contoh mwapi dalam bahagian 6, dan tukar tiga perkara:

• Base URL: alamat dari dokumentasi provider. Claude Code tanpa /v1; OpenCode dan Hermes dengan /v1.
• API key: key dari dashboard provider.
• Model: nama model dari dashboard provider.

Jika tidak pasti, cuba ANTHROPIC_AUTH_TOKEN dahulu. Jika mendapat error 401, tukar kepada ANTHROPIC_API_KEY. Untuk OpenCode, blok "headers" (Bearer) hanya diperlukan jika provider menggunakan Bearer token.

11.Rujukan

• OpenCode: opencode.ai/v2/docs/providers
• OpenCode Console: opencode.ai/v2/docs/console/providers
• Hermes Agent: hermes-agent.nousresearch.com/docs
• Bedrock: bedrock.com.de/docs — bukan AWS Bedrock rasmi; ia gateway pihak ketiga yang menggunakan nama yang sama. Jangan tetapkan CLAUDE_CODE_USE_BEDROCK.
• Mirai: miraiapi.com/usage
• mwapi: rujuk dashboard mwapi untuk base URL dan API key.