Cara Atasi Had Penggunaan Claude (Claude Usage Limits)

Apakah had penggunaan Claude?

Had penggunaan Claude terdiri daripada dua sistem berasingan, dan langkah pertama adalah menentukan sistem mana yang menyekat anda. Langganan Claude (Pro, Max, Team, atau Enterprise berasaskan tempat duduk) memberikan anda kuota penggunaan berputar yang dikongsi merentasi model, selain daripada beberapa had siling keluarga model, dan dikongsi dengan sembang Claude, jadi ia akan menyekat anda dengan mesej seperti You've hit your session limit · resets 3:45pm. Pelan Enterprise berasaskan penggunaan semasa adalah pengecualian: ia tidak mempunyai kuota yang disertakan, dan semua penggunaan dibilkan pada kadar API bermula daripada token pertama. API Claude mengukur perkara lain: seberapa pantas anda menghantar permintaan dan token, yang dikira setiap minit. Ia menyekat anda dengan ralat HTTP 429 jenis rate_limit_error, biasanya dengan pengepala retry-after yang menyatakan berapa saat untuk menunggu.

Penyelesaian bagi kedua-duanya tidak sama. Had langganan adalah mengenai jumlah yang telah anda gunakan dalam satu tempoh masa, jadi anda perlu menunggu sehingga ia ditetapkan semula, membeli lebih banyak penggunaan, atau menggunakan tetapan semula had percuma jika pelan anda menawarkannya. Had kadar API adalah mengenai kelajuan anda pada masa ini, dan ia akan hilang dalam beberapa saat sebaik sahaja anda memperlahankan kadar permintaan.

Kuota pelan dan nombor peringkat had kadar sering berubah, dan nombor yang salah adalah lebih buruk daripada tiada maklumat langsung, jadi tiada nombor yang dicetak di sini. Baca had anda sendiri dengan arahan di bawah.

Had yang mana telah anda capai? Baca mesej yang tepat

Claude Code menamakan sistem tersebut dalam teks yang dicetaknya. Padankan dengan sistem anda sebelum membuat sebarang perubahan.

• You've hit your session limit · resets 3:45pm ialah had langganan. Peruntukan pusingan pelan anda untuk tempoh ini telah habis digunakan.
• You've hit your weekly limit · resets Mon 12:00am ialah sistem yang sama untuk tempoh yang lebih panjang.
• You've hit your Opus limit · resets 3:45pm ialah had langganan yang hanya terpakai untuk permintaan Opus. Beralih kepada model di luar keluarga Opus membolehkan anda terus bekerja.
• You've hit your Sonnet limit · resets 3:45pm ialah jenis had keluarga model yang sama, khusus untuk permintaan Sonnet sahaja. Beralih kepada model di luar keluarga Sonnet membolehkan anda terus bekerja.
• Mesej yang bermula dengan Fable limit reached bermakna anda telah menggunakan bahagian peruntukan mingguan anda yang boleh diambil oleh model Fable. Meneruskan penggunaan Fable akan mengenakan caj kredit penggunaan, jadi Claude Code meminta anda untuk mengesahkan terlebih dahulu. Pilih model lain dengan /model untuk kekal dalam pelan anda.
• API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com. ialah had kadar API. Anda telah mencapai had yang dikonfigurasikan untuk kunci API anda, atau untuk projek Amazon Bedrock atau Google Cloud anda. Perkara yang terpakai bergantung pada cara klien mengesahkan identiti, memandangkan klien Bedrock atau Vertex diukur berdasarkan kuota projek awan anda dan bukannya organisasi Anthropic.
• API Error: Server is temporarily limiting requests (not your usage limit) ialah pendikit jangka pendek yang tidak berkaitan dengan kuota pelan anda. Claude Code akan mencuba semula secara automatik dengan backoff sebelum ia memaparkan baris tersebut kepada anda.

Had penggunaan langganan: sesi, mingguan, dan tetingkap Opus

Pelan Pro, Max, Team atau Enterprise berasaskan kerusi merangkumi peruntukan penggunaan yang bergerak (rolling). Apabila peruntukan ini habis, Claude Code menyekat permintaan seterusnya sehingga waktu set semula yang dipaparkan dalam mesej. Dua sifat peruntukan ini sering menyebabkan kekeliruan.

• Ia dikongsi dengan sembang Claude. Kerja yang anda lakukan di claude.ai menggunakan peruntukan yang sama dengan kerja di terminal, jadi penggunaan yang berat dalam sembang pada waktu petang akan memendekkan masa pengekodan anda pada waktu malam. Setiap platform yang anda log masuk dengan akaun tersebut menggunakan kumpulan yang sama, jadi pada Linux aplikasi desktop beta dan CLI Claude Code berkongsi satu peruntukan antara keduanya, bukan satu peruntukan setiap satu.
• Ia dikongsi merentasi model. Had sesi dan mingguan adalah satu kumpulan untuk setiap model. Pengecualiannya ialah siling keluarga model di dalam kumpulan tersebut: had Opus dan Sonnet, serta peruntukan Fable sehingga 50% daripada had mingguan anda pada kerusi Max dan Premium. Bagi kerusi Pro dan Standard, Fable tidak disertakan dalam had pelan sama sekali dan dibilkan kepada kredit penggunaan bermula daripada permintaan pertama.

Pada Claude for Teams dan Enterprise berasaskan kerusi, bentuk yang didokumenkan ialah peruntukan setiap kerusi yang ditetapkan semula pada tetingkap lima jam yang bergerak dan tetingkap mingguan, dikongsi dengan sembang Claude dan Cowork, serta ditentukan saiznya mengikut peringkat kerusi (Standard atau Premium). Pelan Enterprise berasaskan penggunaan semasa berfungsi secara berbeza: tiada peruntukan disertakan untuk dihabiskan, penggunaan dibilkan pada kadar API, dan silingnya adalah mengikut had perbelanjaan yang ditetapkan oleh pentadbir di peringkat organisasi dan untuk pengguna individu. Pada pelan bantuan jualan, penggunaan yang dihentikan oleh had perbelanjaan akan bersambung semula pada permulaan tempoh bil seterusnya melainkan pemilik menaikkan had tersebut terlebih dahulu. Pada pelan layan diri, penggunaan juga berhenti apabila baki kredit prabayar habis, sehingga pemilik membeli lebih banyak kredit. Pada Pro dan Max, waktu set semula yang dicetak dalam mesej dan bar /usage anda sendiri adalah angka yang boleh dipercayai, bukan angka yang disalin daripada catatan blog. Jika anda masih memilih peringkat, pelan Claude yang anda perlukan membandingkan perkara yang dihadkan oleh setiap pelan.

Mengapa menukar model dengan /model tidak memulihkan sesi atau had mingguan

Ini adalah kesilapan yang paling kerap berlaku, dan dokumentasi menyatakan perkara ini dengan jelas: had sesi dan had mingguan dikongsi merentasi semua model, jadi menukar model tidak akan memulihkan akses. Memilih model yang lebih kecil selepas tempoh sesi anda tamat hanya menukar model yang akan menjawab permintaan anda. Ia tidak mengubah baki kuota yang tinggal, kerana had sesi dan mingguan tidak ditetapkan mengikut model, jadi pertukaran tersebut tidak membebaskan apa-apa kuota.

Pengecualiannya ialah had siling keluarga model. Jika mesej memaparkan You've hit your Opus limit atau You've hit your Sonnet limit, maka /model ialah penyelesaian yang betul. Tukar kepada model di luar keluarga tersebut dan teruskan bekerja, kerana hanya permintaan bagi keluarga model itu yang disekat. Had Fable bagi pelan Max dan Premium berfungsi dengan cara yang sama: tukar kepada model lain untuk terus bekerja dalam pelan anda, atau teruskan menggunakan Fable dengan kredit penggunaan. Walau bagaimanapun, Fable menggunakan kolam mingguan kongsi dengan lebih cepat berbanding model lain, jadi pertukaran selepas had Fable tidak akan membolehkan anda melepasi had mingguan keseluruhan anda.

Menganggap had tersebut sebagai pepijat adalah kesilapan kedua. Memasang semula atau mengesahkan semula identiti tidak akan mengubah apa-apa. Kuota akan kembali apabila tempoh masa ditetapkan semula, apabila anda menggunakan tetapan semula had percuma, atau apabila anda membeli kredit penggunaan.

Apa yang perlu dilakukan apabila anda mencapai had langganan

1. Semak masa set semula. Tetingkap sesi adalah singkat. Tetingkap mingguan bukanlah sesuatu yang anda perlu tunggu di meja anda. Pada Claude Code v2.1.234 atau lebih baharu, /rate-limit-options boleh menunggu masa set semula dan menyambung tugas yang terganggu secara automatik.
2. Jika ia adalah had Opus, Sonnet atau Fable, jalankan /model dan pilih model di luar keluarga tersebut.
3. Jalankan /usage untuk melihat had pelan anda, bar penggunaan anda, dan bila ia akan ditetapkan semula. /cost ialah alias untuk skrin yang sama.
4. Semak Settings > Usage pada claude.ai atau dalam Claude Desktop untuk bahagian Resets. Pelan yang layak kadangkala ditawarkan set semula had percuma, dan mengklik "Reset for free" akan menetapkan semula had sesi lima jam atau had mingguan anda, mengikut mana-mana yang diliputi oleh tawaran tersebut, kembali kepada penuh dengan serta-merta. Butang ini tidak tersedia dalam Claude Code di terminal atau IDE, atau pada Claude Mobile, dan setiap tawaran mempunyai tarikh luput.
5. Jalankan /usage-credits untuk terus bekerja melepasi had tersebut. Pada pelan Pro dan Max, ia membuka tetapan pengebilan anda. Pada pelan Team dan Enterprise, ia membuka tetapan penggunaan organisasi anda, atau menghantar permintaan kepada pentadbir anda jika anda tidak mempunyai akses pengebilan.
6. Jika anda menghadapi sekatan yang sama setiap minggu, pelan tersebut tidak sesuai dengan cara kerja anda, dan laluan keluar daripada had penggunaan wajar dipertimbangkan sekali sahaja berbanding melakukannya setiap kali had ditetapkan semula.

/usage-credits memerlukan langganan claude.ai yang dilog masuk melalui /login. Ia tidak tersedia dengan pengesahan API key, kerana API key tidak mempunyai peruntukan pelan untuk dilanjutkan.

Kredit penggunaan mempunyai satu kesan sampingan yang perlu diketahui terlebih dahulu. Secara lalai, Claude Code memberikan perbualan utama anda cache prompt selama satu jam semasa anda berada dalam penggunaan yang disertakan dalam langganan, dan mengurangkannya kepada lima minit sebaik sahaja anda menggunakan kredit, jadi lebih banyak pusingan bermula dari awal dan penggunaan token Claude Code meningkat untuk kerja yang sama. Subagen berada di luar baldi perbualan utama tersebut, jadi mereka mendapat lima minit walaupun dalam penggunaan pelan. Memilih TTL sendiri, dengan tetapan promptCacheTtl atau CLAUDE_CODE_PROMPT_CACHE_TTL pada Claude Code v2.1.242 atau lebih baharu, mengekalkan jangka hayat satu jam semasa anda menggunakan kredit.

Mesej yang kelihatan seperti had penggunaan tetapi sebenarnya bukan

Empat ralat Claude Code dilaporkan sebagai had penggunaan sedangkan ia bukan.

• Amaran konteks atau auto-compact bukanlah had penggunaan. /context mencetak baris seperti Context exceeds the 200k-token limit by 94k tokens, diikuti dengan arahan yang mengosongkan ruang, sebaik sahaja perbualan melebihi tetingkap konteks model. Pemadatan (compacting) meringkaskan sejarah lama untuk mengosongkan ruang, tetapi ia tidak percuma: /compact membaca perbualan yang diringkaskannya, jadi memadatkan konteks yang besar merupakan satu permintaan besar terhadap pelan anda. Apabila anda mahukan permulaan baharu dan bukannya kesinambungan, /clear tidak mengenakan sebarang kos.
• Prompt is too long · automatic compaction failed: <the underlying error> bermaksud pemadatan automatik itu sendiri gagal, berdasarkan ralat yang dinamakan. /compact akan terus gagal pada ralat yang sama sehingga anda menyelesaikannya.
• Credit balance is too low bermaksud organisasi Console anda telah kehabisan kredit prabayar, atau Claude Code menghantar permintaan pelanggan melalui kunci API Console; /status menunjukkan kelayakan mana yang aktif. Tambah kredit di platform.claude.com/settings/billing, yang turut menawarkan fungsi tambah nilai automatik.
• API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context ialah semakan kelayakan, bukan kuota yang habis. Jika anda memilih varian [1m] bagi Opus 4.6 atau Sonnet 4.6, pilih varian tanpa akhiran [1m], atau tetapkan CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Jika ia muncul di pertengahan perbualan kerana konteks melebihi 200K token, Claude Code akan memadatkan semula di bawah had standard dengan sendirinya. Sonnet 5 dan seterusnya, Opus 4.7 dan seterusnya, Haiku 5.5 serta model Fable berjalan dengan tetingkap asli 1M dan tidak mempunyai akhiran untuk dibuang; pemboleh ubah itulah yang mengehadkannya kepada 200K.

Satu lagi ralat datang daripada API. 413 request_too_large ialah had saiz bagi satu permintaan tunggal, bukan had kadar.

Had laju API: apa yang sebenarnya dikira oleh 429

Messages API mengukur tiga perkara, secara berasingan bagi setiap kelas model.

• permintaan seminit (RPM)
• token input seminit (ITPM)
• token output seminit (OTPM)

Organisasi anda juga mempunyai had perbelanjaan, iaitu perkara yang berbeza: kos bulanan maksimum untuk penggunaan API. Sebaik sahaja anda mencapai had perbelanjaan tier anda, penggunaan API akan dijeda sehingga bulan berikutnya melainkan anda meminta had yang lebih tinggi. Ia juga tiba sebagai 429 rate_limit_error, tetapi tanpa header retry-after dan dengan enforced_spend_limit_reached dalam error.details.error_code. Tiada gelung cuba semula (retry loop) yang dapat menyelesaikan masalah itu. Had perbelanjaan lebih rendah yang anda tetapkan sendiri dalam Console akan dipaparkan secara berbeza: permintaan mengembalikan HTTP 400 invalid_request_error dengan mesej yang bermula dengan You have reached your specified API usage limits, dan meningkatkan atau membuang had tersebut akan memulihkan akses.

Empat mekanik menentukan bila 429 akan tiba.

• Had adalah mengikut kelas model. Ia terpakai secara berasingan bagi setiap model, jadi anda boleh menggunakan model yang berbeza sehingga had masing-masing pada masa yang sama. Sesetengah keluarga berkongsi baldi (bucket) yang sama: had laju Opus adalah jumlah keseluruhan merentasi Claude Opus 4.8, Opus 4.7, Opus 4.6 dan Opus 4.5, manakala Claude Sonnet 5 mempunyai hadnya sendiri.
• Kapasiti diisi semula secara berterusan. API menggunakan algoritma token bucket, jadi kapasiti diisi semula secara berterusan dan bukannya ditetapkan semula pada saat yang tetap. Had 60 permintaan seminit mungkin dikuatkuasakan sebagai satu permintaan sesaat, jadi 60 permintaan yang dihantar serentak masih akan gagal.
• Hanya input yang tidak dicache (uncached) dikira ke arah ITPM pada kebanyakan model. input_tokens dan cache_creation_input_tokens dikira. cache_read_input_tokens tidak dikira pada kebanyakan model Claude, dengan Claude Haiku 3.5 sebagai pengecualian yang didokumenkan. Oleh itu, caching memberikan ruang had laju (rate-limit headroom) serta diskaun. Dari segi output, max_tokens yang tinggi tidak dikira terhadap OTPM, kerana OTPM hanya mengira token yang benar-benar dihasilkan.
• Had wujud pada peringkat organisasi. Ruang kerja (workspace) boleh diberikan had yang lebih rendah, dan had seluruh organisasi sentiasa terpakai walaupun jumlah had ruang kerja melebihi had tersebut. Had yang tidak anda ganti (override) pada ruang kerja akan diwarisi daripada organisasi, bukannya dibiarkan tanpa had.

Tier yang dinamakan Start, Build, Scale dan Custom menetapkan angka sebenar, yang diberikan secara automatik berdasarkan sejarah penggunaan dan status akaun anda. Organisasi baharu dan organisasi yang mempunyai sejarah penggunaan yang sedikit mungkin bermula dalam tier Evaluation, di bawah had standard yang diterbitkan, jadi 429 pertama boleh tiba lebih awal daripada yang diramalkan oleh jadual. Peningkatan penggunaan yang mendadak akan mencetuskan had pecutan, yang mengembalikan 429 semasa anda masih berada dalam tier anda, jadi tingkatkan trafik secara beransur-ansur. Setiap angka yang diterbitkan adalah siling: had yang didokumenkan adalah penggunaan maksimum yang dibenarkan, bukan minimum yang dijamin. Untuk meminta lebih, gunakan "Request tier increase" pada halaman Rate limits dalam Claude Console.

Membaca ralat 429: retry-after, pengepala, dan percubaan semula SDK

Setiap ralat API mengembalikan sampul yang sama: objek error bersarang yang membawa jenis dan mesej, serta request_id pada peringkat atas.

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "<names the rate limit you exceeded>"
  },
  "request_id": "req_011CSHoEeqs5C35K2UUqR7Fy"
}

Pengepala membawa maklumat selebihnya.

• retry-after ialah bilangan saat untuk menunggu sebelum anda boleh mencuba semula permintaan tersebut. Percubaan semula yang lebih awal akan gagal. Tidak semua ralat 429 membawa maklumat ini, dan ralat 429 bagi had perbelanjaan (spend-cap) tidak akan menyertakannya.
• anthropic-ratelimit-requests-limit, anthropic-ratelimit-requests-remaining dan anthropic-ratelimit-requests-reset menerangkan belanjawan permintaan anda.
• anthropic-ratelimit-input-tokens-* dan anthropic-ratelimit-output-tokens-* melakukan perkara yang sama untuk ITPM dan OTPM, dengan akhiran limit, remaining dan reset yang serupa.
• anthropic-ratelimit-tokens-* memaparkan nilai bagi had paling ketat yang sedang berkuat kuasa.

Pengepala reset adalah dalam format cap masa RFC 3339. Pengepala baki token (remaining) dibundarkan kepada ribu yang terdekat, jadi bacalah ia sebagai penunjuk anggaran. Mod pantas (fast mode) mempunyai kumpulan (pool) tersendiri dan pengepala anthropic-fast-* yang tersendiri. Baca kesemuanya daripada mana-mana panggilan yang berjaya:

curl -s -D - -o /dev/null https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}' \
  | grep -i 'ratelimit\|retry-after\|request-id'

Setiap respons juga membawa pengepala request-id yang unik, contohnya req_018EeWyXxfu5pfWkrYcMdjWG. Ia muncul sebagai request_id dalam badan ralat dan sebagai _request_id pada respons SDK Python dan TypeScript. Sila nyatakan kod ini apabila anda menghubungi sokongan.

Semak sama ada anda benar-benar memerlukan gelung backoff sebelum anda menulisnya. SDK rasmi secara automatik mencuba semula kegagalan sementara, termasuk ralat sambungan, had kadar (rate limits) dan ralat pelayan 5xx, dengan backoff eksponen, sebanyak dua kali secara lalai, serta mematuhi pengepala retry-after apabila ia hadir. Setiap klien menerima pilihan maximum-retries untuk mengubah atau melumpuhkan gelagat tersebut.

import anthropic

client = anthropic.Anthropic(max_retries=5)  # the SDK default is 2

try:
    msg = client.messages.create(
        model="claude-sonnet-5",
        max_tokens=1024,
        messages=[{"role": "user", "content": "hello"}],
    )
except anthropic.RateLimitError as err:
    headers = err.response.headers
    print("still limited after retries; wait", headers.get("retry-after"), "seconds")
    print("request id:", headers.get("request-id"))

529 ralat beban lampau bukan salah anda

Kod 429 bermaksud anda membuat permintaan terlalu pantas. Kod 529 overloaded_error bermaksud API mengalami beban lampau buat sementara waktu, dan ia boleh berlaku apabila API menerima trafik yang tinggi daripada semua pengguna. Tiada kaitan dengan kunci atau kod anda yang menyebabkan perkara ini. Cuba semula dengan exponential backoff, yang sudah pun dilakukan oleh SDK untuk respons 5xx, dan semak status.claude.com jika masalah tidak selesai. Kod 500 api_error ialah ralat dalaman yang perlu dicuba semula dengan cara yang sama, dan kedua-duanya bukanlah had kadar (rate limit).

Baca had anda sendiri dan bukannya jadual

Bagi langganan, /usage ialah skrin yang penting. Ia memaparkan bar penggunaan pelan anda serta perincian perkara yang menggunakannya, dan d atau w menukar paparan antara 24 jam terakhir dengan 7 hari terakhir. Terdapat dua perkara yang perlu diberi perhatian. Blok Session menunjukkan penggunaan token API dan ditujukan untuk pengguna API, jadi pelanggan boleh mengabaikan angka dolar di situ. Angka tersebut diperoleh daripada sejarah sesi setempat pada mesin tersebut, jadi penggunaan daripada peranti lain atau daripada claude.ai tidak disertakan.

Bagi pihak API, halaman Usage dalam Claude Console memaparkan dua carta, "Rate Limit - Input Tokens" dan "Rate Limit - Output Tokens". Carta input memplotkan maksimum setiap jam bagi token input yang tidak dicache setiap minit berbanding had ITPM semasa anda, dengan kadar cache anda di sebelahnya, supaya anda boleh memantau had yang hampir dicapai dan bukannya menemuinya semasa dalam pengeluaran.

Untuk membaca had yang dikonfigurasikan secara programatik:

curl -s https://api.anthropic.com/v1/organizations/rate_limits \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

Ia memerlukan kelayakan Admin API: kunci Admin API, token OAuth dengan skop org:admin, atau kunci akaun peribadi atau perkhidmatan yang tidak dihadkan kepada ruang kerja (workspace). Kunci API ruang kerja tidak berfungsi. GET /v1/organizations/workspaces/{workspace_id}/rate_limits melakukan perkara yang sama bagi setiap ruang kerja. Kedua-duanya adalah baca sahaja: untuk menukar had, gunakan halaman Rate limits dalam Console.

Menggunakan less supaya anda kurang menghadapi had

Kedua-dua sistem mengukur perkara yang sama di peringkat asas, jadi tuil ini berfungsi pada kedua-duanya.

• Gunakan lebih sedikit token bagi setiap giliran. Sesi berterusan memastikan cache kekal panas, dan /clear antara tugasan yang tidak berkaitan tidak menelan sebarang kos. Penggunaan token Claude Code merangkumi tuil tersebut sepenuhnya.
• Kurangkan usaha. Tahapnya ialah low, medium, high, xhigh dan max. Menu /effort juga menawarkan ultracode, yang meningkatkan perbelanjaan dan bukannya mengurangkannya. Penaakulan mendalam untuk penamaan semula mekanikal tidak memberikan sebarang faedah.
• Kurangkan konkurensi selepas ralat 429. Rendahkan CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY dan elakkan terlalu banyak subejen selari. Jalankan /status juga: ANTHROPIC_API_KEY yang tersasar akan menghalakan permintaan melalui kunci peringkat rendah dan bukannya langganan anda.
• Alihkan kerja bukan interaktif ke Message Batches API. Ia menjalankan volum besar secara tak segerak dengan diskaun 50% pada token input dan output, di bawah had kadarnya sendiri, supaya kerja malam tidak bersaing dengan sesi anda.

Kerja yang memasukkan data ke dalam konteks paling terasa kesannya: jika anda menganalisis saham dan opsyen berbanding data pasaran langsung, menarik bahagian kecil yang diperlukan oleh setiap soalan hanya menelan sebahagian kecil kos berbanding menampal keseluruhan jadual sebut harga dan rantaian. Kerja secara berpusu-pusu yang dipacu oleh program dan bukannya orang harus menggunakan kunci API sejak awal. Peralihan ke sana mengubah cara anda membayar serta cara anda diukur, memandangkan Claude API tidak mempunyai pelan percuma. Pelan Max dan Team memang menyertakan kredit API bulanan untuk menjalankan aplikasi dan ejen anda sendiri sebaik sahaja anda memautkan organisasi Console. Kredit tersebut tidak meliputi Claude Code dan tidak mengubah had penggunaan pelan anda. Aplikasi Claude API pertama anda pada VPS merangkumi pengendalian kunci dan percubaan semula, dan ejen yang berjalan lama akan bertahan walaupun sambungan terputus apabila anda memastikan Claude Code berjalan pada VPS di dalam tmux.

FAQ

Mengapa menukar model tidak menyelesaikan had penggunaan Claude saya?

Kerana had sesi dan mingguan dikongsi merentasi semua model. Peruntukan tersebut adalah milik pelan, bukan milik model, jadi /model hanya menukar model yang akan menjawab dan bukannya menambah baki peruntukan yang tinggal. Pengecualiannya adalah had keluarga model: You've hit your Opus limit dan You've hit your Sonnet limit hanya terpakai pada keluarga tersebut, dan had Fable pada kerusi Max dan Premium hanya mengehadkan Fable sahaja. Dalam kes itu, menukar model adalah penyelesaian yang didokumentasikan.

Apakah maksud 429 rate_limit_error, dan berapa lama saya perlu menunggu?

Ini bermakna akaun anda telah mencapai had kadar untuk kelas model tersebut: permintaan seminit, token input seminit, atau token output seminit. Respons tersebut biasanya membawa header retry-after yang menyatakan saat untuk menunggu, dan percubaan semula yang lebih awal akan gagal. SDK rasmi sudah pun membuat percubaan semula bagi had kadar dan ralat 5xx dengan exponential backoff, secara lalai sebanyak dua kali, dengan mematuhi header tersebut apabila ia hadir. Ralat 429 yang muncul semasa anda masih berada dalam had tier anda menunjukkan had pecutan akibat peningkatan mendadak. Ralat 429 dengan enforced_spend_limit_reached dalam error.details.error_code, yang tidak pernah membawa header retry-after, adalah had perbelanjaan bulanan, dan menunggu selama beberapa minit tidak akan menyelesaikannya.

Bagaimanakah cara untuk melihat had penggunaan Claude saya dan bila ia akan ditetapkan semula?

Dalam Claude Code, jalankan /usage untuk melihat bar pelan, waktu tetapan semula dan pecahan penggunaan anda; /cost ialah alias, dan d atau w menukar paparan antara 24 jam terakhir dan 7 hari terakhir. Angka tersebut diperoleh daripada sejarah sesi setempat, jadi ia tidak merangkumi penggunaan daripada peranti lain dan daripada claude.ai. Pada API, Konsol memaparkan carta had kadar anda, dan GET /v1/organizations/rate_limits mengembalikan had yang dikonfigurasikan dengan kelayakan Admin API, seperti kunci Admin API.

Bolehkah saya terus bekerja selepas mencapai had pelan Claude saya?

Kadangkala boleh. Jalankan /usage-credits untuk membeli penggunaan melebihi had pada pelan Pro dan Max, atau untuk memohonnya daripada pentadbir pada pelan Team dan Enterprise; ia memerlukan log masuk claude.ai melalui /login dan tidak tersedia dengan pengesahan kunci API. Jika tidak, tunggu sehingga waktu tetapan semula, gunakan tetapan semula had percuma jika Tetapan > Penggunaan pada claude.ai atau Claude Desktop menawarkannya, tukar model jika ia adalah had Opus, Sonnet atau Fable, atau pindahkan kerja tersebut ke kunci API, yang mengira penggunaan seminit dan bukannya mengikut tetingkap masa.