← Panduan API Claude

MiraiAPI

Redeem kod pesanan di miraiapi.com untuk mencipta API key. Halaman Config MiraiAPI ialah sumber setting paling tepat.

Versi 2.5 · 2026-11-02

1.Ringkasan

Laman webmiraiapi.com/usage

Base URLhttps://api.miraiapi.com (Claude Code)
https://api.miraiapi.com/v1 (app lain)

Claude Code authANTHROPIC_AUTH_TOKEN (ikut halaman Config rasmi)

FormatKod redeem MR-… · API key sk-…

AkaunTidak perlu — redeem kod sahaja

KuotaRedeem kod baharu pada key sedia ada untuk menambah kuota

2.Dapatkan API key

3 langkah

1Redeem koddi miraiapi.com/usage/#redeem — kod MR-… dalam butiran pesanan

2Salin API keyklik Create new API key, salin key sk-… serta-merta

3Pasangswitch-api setup mirai atau edit manual (bahagian 4)

Halaman Usage mempunyai tab Check key, Redeem code, Models & pricing, Config dan Setup guide. Selepas Check code, pilih Create new API key (key baharu) atau Add to existing key (tambah kuota pada key sedia ada). Kod redeem bukan API key. Jika key hilang, masukkan kod yang sama sekali lagi dan pilih Recover created API key.

Pembetulan 2 Nov 2026: panduan lama menyebut ANTHROPIC_API_KEY untuk Claude Code. Halaman Config rasmi menggunakan ANTHROPIC_AUTH_TOKEN. Jika anda pernah menjalankan switch-api claude use mirai, jalankan .\switch-api.ps1 install semula, kemudian switch-api claude use mirai — skrip membuang ANTHROPIC_API_KEY lama secara automatik.

3.Semak baki & tambah kuota

Semak kuota & tarikh tamat: miraiapi.com/usage → tab Check key.
Tambah kuota: redeem kod baharu pada key yang sama. Tiada perubahan setting, dan tidak perlu setup semula.

4.Pasang dalam app

Cara A — switch-api (Windows, disyorkan)

Jika switch-api belum dipasang, ikut Kaedah A dalam panduan utama. Kemudian:

switch-api setup mirai
switch-api claude   use mirai
switch-api opencode use mirai
switch-api hermes   use mirai

Jalankan hanya untuk app yang anda guna. setup sekali sahaja; API key disimpan dan dikongsi semua app.

Cara B — edit manual

Claude Code — ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json), blok env:

{
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.miraiapi.com",
        "ANTHROPIC_AUTH_TOKEN": "<api-key-mirai>",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.8",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5"
    }
}

OpenCode 2 — ~/.config/opencode/opencode.json, blok providers:

{
    "$schema": "https://opencode.ai/config.json",
    "providers": {
        "mirai": {
            "name": "MiraiAPI",
            "package": "@opencode/ai/providers/openai-compatible",
            "settings": {
                "baseURL": "https://api.miraiapi.com/v1",
                "apiKey": "<api-key-mirai>"
            },
            "models": {
            "claude-opus-4.8": { "name": "claude-opus-4.8" },
            "claude-sonnet-5": { "name": "claude-sonnet-5" }
            }
        }
    },
    "model": "mirai/claude-opus-4.8"
}

OpenCode 1 menggunakan format lama (blok provider); lihat 6B dalam panduan utama.

Hermes Agent — ~/.hermes/config.yaml (Windows: dalam WSL2), blok model:

# ~/.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>

Format rasmi halaman Config MiraiAPI: base URL tanpa /v1, key dalam ~/.hermes/.env.

VS Code — Cline / Roo Code: API Provider OpenAI Compatible, Base URL https://api.miraiapi.com/v1, API key anda, Model ID contohnya claude-opus-4.8.

Base URL: Claude Code dan Hermes tanpa /v1 (https://api.miraiapi.com); OpenCode dan Cline dengan /v1 (https://api.miraiapi.com/v1).

Cara C — halaman Config MiraiAPI (sumber paling tepat)

Di miraiapi.com/usage/#config, pilih app (Claude Code, OpenCode, Hermes, Cline dan lain-lain) dan model, kemudian masukkan API key anda. Halaman ini memaparkan fail config manual dan command pemasangan satu baris (Windows PowerShell, Windows CMD, macOS/Linux). Jika panduan ini berbeza dengan halaman Config, ikut halaman Config.

Pilih satu cara sahaja bagi setiap app: switch-api, edit manual atau command rasmi. Jangan kongsi command tersebut — ia mengandungi API key anda.

5.Model yang tersedia

Model ID	Nota
claude-opus-4.8	default opus (halaman Config & switch-api)
claude-sonnet-5	default sonnet (halaman Config & switch-api)
claude-sonnet-5.5
claude-opus-5
ccmax-claude-opus-5.5
ccmax-claude-5.5
claude-fable-5
claude-opus-4.7
claude-opus-4.6

MiraiAPI menggunakan titik dalam nama model (claude-sonnet-5.5, claude-opus-4.8), bukan sempang. Senarai terkini dan harga ada di tab Models & pricing (perlu API key).

6.Masalah lazim

Simptom	Penyelesaian
Error 401 dalam Claude Code	Pastikan hanya `ANTHROPIC_AUTH_TOKEN` ditetapkan; buang `ANTHROPIC_API_KEY` lama. Semak key masih aktif di tab Check key.
`model not found`	Nama model tiada pada provider ini. Pilih nama daripada jadual model di atas (ejaan mesti tepat).
404 / Not Found	Base URL salah: semak `/v1` (Claude Code tanpa, app lain dengan).
Kod redeem ditolak	Semak ejaan kod (`MR-…`) dan pastikan belum digunakan. Hubungi pembekal jika masih gagal.

Masalah lain (skrip, PATH, JSON rosak): lihat Penyelesaian masalah dalam panduan utama.

7.Rujukan

Usage, redeem & config: miraiapi.com/usage — halaman Config ialah sumber setting paling tepat
Video panduan rasmi: YouTube
Panduan asal pembekal (Google Docs): Claude API Guide

Halaman ini diringkaskan dan dikemas kini daripada panduan rasmi provider pada 2 Nov 2026. Jika ada percanggahan, ikut maklumat terkini di laman web provider.