SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Cara Jalankan Claude Code di Amazon Bedrock atau Vertex AI

Ketahui cara menyambungkan Claude Code ke Amazon Bedrock atau Google Vertex AI. Panduan ini menjelaskan konfigurasi pemboleh ubah persekitaran dan implikasi kos anda.

Perubahan apabila Claude Code dijalankan pada akaun awan anda sendiri

Anda boleh menjalankan Claude Code pada Amazon Bedrock atau Google Vertex AI, dan pertukaran tersebut hanya melibatkan dua atau tiga pemboleh ubah persekitaran serta kelayakan awan yang sedia ada pada pasukan anda. Semua fungsi setempat kekal sama: CLI, subejen, cangkuk (hooks), kemahiran, pelayan MCP dan fail CLAUDE.md anda. Hanya panggilan model yang beralih, dan empat perkara turut berpindah bersamanya: rangkaian yang dilalui oleh permintaan tersebut, akaun yang menanggung kosnya, model Claude yang dibenarkan untuk anda panggil, serta ciri-ciri bahagian pelayan yang tersedia.

Persoalannya jarang sekali tentang sama ada ia berfungsi atau tidak. Ia memang berfungsi. Persoalannya adalah yang mana antara empat perkara tersebut yang paling penting bagi anda.

Tiga jenis penghalaan dan kos bagi setiap satunya

Terus melalui Anthropic dengan langganan. Anda log masuk menggunakan akaun claude.ai dengan pelan Pro, Max, Ultra, Team atau Enterprise. Permintaan dihantar ke API Anthropic. Bagi pelan Pro, Max, Ultra dan Team, anda membayar mengikut kerusi (seat), dan penggunaan dihadkan oleh had pelan tersebut dan bukannya dibilkan mengikut token. Pelan Enterprise semasa adalah pengecualian: yuran kerusi tidak merangkumi penggunaan, dan setiap token dibilkan secara berasingan pada kadar API standard, dengan kontrak Enterprise berasaskan kerusi yang lama akan beralih ke model ini semasa pembaharuan. Ini adalah satu-satunya penghalaan yang mencapai permukaan yang dibina di atas akaun tersebut, seperti Claude Code di web, aplikasi mudah alih dan Remote Control. Bagi pasukan, pelan Team sudah merangkumi daftar masuk tunggal (SSO) dan tetapan terurus pelayan untuk konfigurasi Claude Code seluruh organisasi, dan pelan Claude Enterprise menambah log audit, SCIM, kawalan pengekalan data tersuai dan API Pematuhan (Compliance API) sebagai tambahan.

Terus melalui Anthropic dengan kunci API. Anda mencipta kunci dalam Anthropic Console dan membayar mengikut token. Infrastruktur dan wilayah yang sama seperti langganan, tiada yuran kerusi, dan penggunaan dipaparkan dalam papan pemuka Anthropic sendiri. Mana antara kedua-duanya yang lebih murah bergantung pada berapa jam sehari ejen tersebut benar-benar berjalan, yang merupakan topik utama dalam perbandingan kos API berbanding langganan dan kos sebenar Claude Code dalam praktiknya.

Endpoint pihak ketiga di Bedrock atau Vertex. Akaun AWS atau Google Cloud anda sendiri yang menyediakan model tersebut. Anthropic tidak berada dalam laluan permintaan semasa inferens. Token tersebut akan dimasukkan ke dalam bil yang anda terima sedia ada, di bawah polisi IAM (pengurusan identiti dan akses) serta log audit yang anda jalankan. Terdapat tiga lagi pilihan pihak ketiga, iaitu Microsoft Foundry, Claude Platform di AWS dan Claude Models di Google Cloud (diuruskan oleh Anthropic), dan semuanya mengikut bentuk yang sama: satu pemboleh ubah persekitaran memilih penyedia, dan akaun awan tersebut yang membuat pembayaran. Laluan Google Cloud yang diuruskan oleh Anthropic menggunakan CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD=1 dan berasingan daripada Vertex.

Nota penamaan, setakat Oktober 2026: Google menamakan semula Vertex AI kepada Google Cloud's Agent Platform. Dokumentasi Anthropic menggunakan nama baharu tersebut, gesaan log masuk Claude Code masih memaparkan Google Vertex AI, dan pemboleh ubah persekitaran masih memaparkan VERTEX.

Residensi data adalah sebab sebenar pasukan melakukan perkara ini

Pada Bedrock, permintaan dihantar ke endpoint Bedrock dalam AWS region yang anda pilih, di dalam akaun anda sendiri. Data at rest disulitkan dengan AES-256 di bawah kunci kendalian AWS, dan anda boleh membekalkan kunci sendiri melalui AWS KMS (key management service). Pada Vertex, padanannya ialah kunci penyulitan kendalian Google, dengan CMEK (customer-managed encryption keys) tersedia. Akses dikawal oleh peranan IAM yang anda sudah gunakan, dan panggilan tersebut muncul dalam CloudTrail atau, dengan pengelogan audit Data Access diaktifkan, Cloud Audit Logs. Bagi pasukan yang tertakluk kepada peraturan, itulah hujah keseluruhannya, dan ia merupakan hujah yang kukuh.

Dua perincian menjadikan perkara ini kurang mutlak berbanding apa yang dicadangkan oleh pemasaran.

Profil inferens rentas-region (cross-region) bukanlah satu region tunggal. Pada Bedrock, Claude Code menyelesaikan model lalai terbina dalamnya kepada ID profil inferens rentas-region, dan awalan yang dipilihnya datang daripada region yang diselesaikan: us. dalam region us-*, eu. dalam region eu-*, apac. dalam region ap-*, dan us-gov. dalam GovCloud. Profil rentas-region boleh melayani permintaan daripada region lain dalam geografi tersebut, jadi jaminan yang anda peroleh ialah geografi, bukan bandar. Jika keperluan anda menamakan satu region, halakan melalui application inference profile yang disokong oleh model asas dalam region tersebut, bukannya profil rentas-region, dan tetapkan ANTHROPIC_MODEL kepada ARN-nya.

Sebahagian trafik masih sampai ke Anthropic. Telemetri, pelaporan ralat dan arahan /feedback dinyahaktifkan secara lalai pada kedua-dua Bedrock dan Vertex, dan /feedback menulis arkib di bawah ~/.claude/feedback-bundles/ pada mesin anda sendiri dan bukannya memuat naik apa-apa. Dua pengecualian berjalan pada setiap penyedia. Sebelum mengambil URL, alat WebFetch menghantar hostname, dan hanya hostname sahaja, ke api.anthropic.com untuk menyemak senarai sekat keselamatan. Tinjauan kualiti sesi juga masih muncul. Matikan yang pertama dengan skipWebFetchPreflight dalam fail tetapan anda dan yang kedua dengan CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1. Menetapkan CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC juga menghentikan tinjauan tersebut, bersama-sama dengan baki trafik yang tidak penting, tetapi ia tidak menyentuh semakan WebFetch, yang mempunyai pilihan opt-out tersendiri. Apabila platform hos menetapkan CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, telemetri ditetapkan kepada aktif secara lalai.

Mengenai latihan: di bawah terma komersial, Anthropic tidak melatih model menggunakan kod atau prompt yang dihantar melalui Claude Code, dan penggunaan platform pihak ketiga adalah bersifat komersial. Development Partner Program, iaitu opt-in yang membenarkan latihan, tidak ditawarkan kepada pengguna Bedrock atau Vertex sama sekali. Pada Vertex, model Fable memerlukan perkongsian prompt-respons dengan Anthropic untuk pemantauan penyalahgunaan; perkara yang sama terpakai kepada model yang didaftarkan dalam Cyber Verification Program. Penyimpanan data sifar pada endpoint ini tertakluk kepada perjanjian anda dengan AWS atau Google dan keperluan penyimpanan model tersebut.

Menghalakan Claude Code ke Amazon Bedrock

Dua perkara perlu dilakukan sekali bagi setiap akaun AWS sebelum konfigurasi klien diambil kira. Buka konsol Amazon Bedrock, pilih model Anthropic daripada katalog model, dan hantar borang kes penggunaan: akses diberikan serta-merta selepas penghantaran. Kemudian, lampirkan polisi IAM yang membenarkan panggilan yang dibuat oleh Claude Code.

  • bedrock:InvokeModel
  • bedrock:InvokeModelWithResponseStream
  • bedrock:ListInferenceProfiles
  • bedrock:GetInferenceProfile

ListInferenceProfiles ialah perkara yang membolehkan Claude Code menyemak semasa permulaan model mana yang akaun anda benar-benar boleh panggil. GetInferenceProfile membolehkannya menyelesaikan ARN profil inferens aplikasi kembali kepada model asas di sebaliknya, supaya ia boleh memilih bentuk permintaan yang betul. Tanpa yang itu, permintaan masih berjaya, kerana Claude Code mencuba semula sekali dengan bentuk yang lain. Simptomnya ialah satu pusingan tambahan bagi setiap model baharu, bukan ralat. Polisi yang diterbitkan oleh Anthropic juga membenarkan aws-marketplace:ViewSubscriptions dan aws-marketplace:Subscribe apabila dipanggil melalui Bedrock, yang meliputi langkah langganan model.

Laluan klien yang paling pantas ialah wizard. Jalankan claude, pilih 3rd-party platform dan kemudian Amazon Bedrock, atau taip /setup-bedrock dalam sesi yang sudah dilog masuk. Ia membaca profil dalam direktori ~/.aws anda, mengesahkan model yang boleh anda panggil, dan menulis hasilnya ke dalam blok env bagi ~/.claude/settings.json, supaya tiada apa-apa yang bergantung pada profil shell anda.

Untuk pelancaran secara skrip, tetapkan pemboleh ubah sendiri.

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

Kelayakan datang daripada rantaian kelayakan AWS SDK standard, jadi apa sahaja yang sudah berfungsi untuk CLI aws akan berfungsi di sini: aws configure, profil SSO, peranan yang diandaikan (assumed role), atau kunci API Bedrock.

aws sso login --profile=your-profile-name
export AWS_PROFILE=your-profile-name
export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

Token pembawa (bearer token) ialah pilihan paling mudah dan perlu dikendalikan dengan berhati-hati, kerana ia merupakan rahsia yang berada dalam pemboleh ubah persekitaran. AWS mengeluarkan kunci jangka pendek yang bertahan sehingga 12 jam dan kunci jangka panjang yang bertahan sehingga tarikh yang anda tetapkan, dan mengesyorkan jenis jangka panjang hanya untuk tujuan penerokaan. Pada kotak binaan (build box) yang dikongsi, utamakan peranan yang tamat tempoh. Penaakulan yang sama meliputi setiap kelayakan lain yang boleh dibaca oleh ejen, yang merupakan subjek bagi menjauhkan rahsia daripada capaian ejen AI.

Perangkap rantau. Claude Code menyelesaikan rantau mengikut tertib ini: AWS_REGION, kemudian AWS_DEFAULT_REGION, kemudian region pada profil AWS aktif anda, kemudian us-east-1. Langkah terakhir itu ialah lalai, bukan ralat, jadi pasukan yang tidak menetapkan rantau di mana-mana dan mengandaikan penghalaan Eropah akan menghantar permintaan mereka ke rantau AS tanpa sebarang amaran dicetak. Jalankan /status di dalam Claude Code untuk melihat rantau yang diselesaikan dan sumber asalnya. Untuk mengesahkan perkara yang boleh dipanggil oleh akaun anda dalam sesuatu rantau, jalankan aws bedrock list-inference-profiles --region your-region.

Bedrock juga menawarkan titik akhir Mantle, yang menggunakan bentuk API Anthropic asli. Pilihnya dengan CLAUDE_CODE_USE_MANTLE=1; ia menggunakan kelayakan AWS yang sama tetapi memerlukan kebenaran IAM bedrock-mantle: yang berasingan.

Menjalankan Claude Code pada Google Vertex AI

Dayakan API dan dapatkan kelayakan (credentials).

gcloud config set project YOUR-PROJECT-ID
gcloud services enable aiplatform.googleapis.com
gcloud auth application-default login

Mohon akses kepada model Claude yang anda perlukan dalam Model Garden. Berikan tempoh 24 hingga 48 jam untuk kelulusan. Berikan roles/aiplatform.user, yang membawa kebenaran aiplatform.endpoints.predict yang digunakan untuk kedua-dua pemanggilan model dan pengiraan token.

Kemudian, pilih penyedia (provider).

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

CLOUD_ML_REGION mengambil global, iaitu lokasi berbilang wilayah seperti eu atau us, atau satu wilayah tunggal. Endpoint global memberikan ketersediaan terbaik dan kawalan paling sedikit ke atas tempat permintaan diservis, jadi keperluan residensi data biasanya bermakna anda perlu menetapkan lokasi tertentu. Liputan model berbeza merentas ketiga-tiga bentuk tersebut. Apabila satu model yang anda perlukan tiada pada endpoint global, tetapkan model tersebut sahaja ke satu lokasi dengan pemboleh ubah VERTEX_REGION_CLAUDE_* miliknya dan biarkan yang lain sebagai global. Semak halaman lokasi Vertex AI semasa dan jangan bergantung pada senarai yang mungkin sudah lapuk.

Perangkap projek. ANTHROPIC_VERTEX_PROJECT_ID menentukan ke mana permintaan dihantar. Claude Code menghalakan permintaan tersebut ke projek itu walaupun GCLOUD_PROJECT, GOOGLE_CLOUD_PROJECT atau fail kelayakan yang dinamakan oleh GOOGLE_APPLICATION_CREDENTIALS membawa maklumat yang berbeza. Pada mesin di mana gcloud menghala ke satu projek dan ANTHROPIC_VERTEX_PROJECT_ID yang tertinggal menamakan projek lain, caj akan dikenakan pada projek kedua, dan tiada apa-apa dalam sesi tersebut yang akan memberi amaran kepada anda.

Sahkan selepas sebarang perubahan penyedia. Jalankan /status untuk menyemak penyedia dan konfigurasi yang aktif. Jika pemboleh ubah tidak sampai ke proses tersebut, semak sama ada ia telah dieksport dalam shell yang melancarkan claude. Pindahkan pemboleh ubah tersebut ke dalam blok env dalam fail tetapan, yang juga merupakan cara untuk memastikan nilai seperti AWS_PROFILE tidak terdedah kepada setiap proses lain yang anda mulakan.

Model yang anda peroleh, dan tempoh masa ketibaannya

Alias seperti sonnet dan opus tidak bermaksud model tersebut adalah yang terbaharu. Pada endpoint pihak ketiga, alias ini akan merujuk kepada tetapan lalai terbina dalam Claude Code untuk penyedia tersebut, yang mungkin ketinggalan berbanding keluaran semasa dan mungkin tidak diaktifkan langsung dalam akaun anda. Apabila tetapan lalai tidak tersedia, Claude Code akan kembali menggunakan model yang lebih lama atau model peringkat rendah untuk sesi tersebut dan mencetak notis. Tindakan kembali kepada model asal ini tidak disimpan, namun Claude Code boleh mengingati penolakan akses model pada mesin tersebut sehingga satu hari dan akan menyemak semula penolakan tetapan lalai semasa pada pelancaran sebaik sahaja sepuluh minit berlalu sejak semakan terakhir.

Untuk pelancaran merentasi pasukan, tetapkan versi secara spesifik (pin).

# Copy the exact IDs from your provider's own model catalog.
export ANTHROPIC_DEFAULT_OPUS_MODEL='<provider model id>'
export ANTHROPIC_DEFAULT_SONNET_MODEL='<provider model id>'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='<provider model id>'

Ambil ID daripada gambaran keseluruhan model dan daripada katalog penyedia anda, kerana formatnya berbeza mengikut penyedia: Bedrock memerlukan ID profil inferens atau ARN, manakala Vertex memerlukan nama model biasa. Jangan salin ID tersebut daripada artikel, termasuk artikel ini. Penetapan versi juga merupakan kawalan kos, memandangkan model utama lalai adalah model kelas Opus dan Opus mengenakan kos yang lebih tinggi bagi setiap token berbanding Sonnet, jadi penggunaan yang tidak menetapkan versi akan dibilkan pada kadar yang lebih tinggi. Untuk menetapkan satu model sebagai lalai sesi, tetapkan ANTHROPIC_MODEL kepada ID penuhnya.

Ketibaan model merupakan pertukaran paling jelas dalam perbandingan ini. Pada API Anthropic sendiri, model berfungsi pada hari ia dilancarkan. Pada Bedrock dan Vertex, ia berfungsi sebaik sahaja penyedia awan anda mengaktifkannya di rantau anda dan akaun anda telah diberikan akses. Jika sesuatu kerja mesti dijalankan pada model terbaharu, kekalkan satu penghalaan (routing) yang boleh mencapainya. Itulah kes praktikal untuk menghalakan model berbeza kepada tugasan berbeza.

Perkara yang anda lepaskan pada Bedrock dan Vertex

Semua fungsi tempatan berfungsi pada setiap penyedia: subejen, cangkuk (hooks), slash commands, kemahiran (skills), pemalam (plugins), titik semakan (checkpoints), sandboxing, fail tetapan terurus dan metrik OpenTelemetry. Jurang perbezaan hanya terletak pada bahagian pelayan.

Tidak tersedia pada kedua-dua titik akhir: Advisor, Channels, Code Mode, papan pemuka analitik, tetapan terurus pelayan, serta arahan /design-sync dan /import. Turut tidak tersedia ialah segala fungsi yang memerlukan akaun claude.ai, termasuk Claude Code di web, aplikasi mudah alih, Kawalan Jauh (Remote Control), rutin dan artifak.

Khusus Bedrock: mod pantas (fast mode) tidak tersedia, dan alat WebSearch tidak wujud di sana, jadi Claude tidak boleh menjalankan carian daripada sesi yang dihalakan ke Bedrock. Ia masih boleh membaca halaman dengan WebFetch apabila anda memberikan URL. Pada Vertex, carian web berfungsi untuk model penjanaan Claude 4 dan seterusnya. Vertex juga menyokong mod pantas pada Fable 5.2 dengan Claude Code v2.1.322 atau lebih baharu dalam global, us atau eu, dengan kelajuan standard sebagai sandaran jika penyedia menolak mod pantas.

Separa pada kedua-duanya: mod auto hanya berjalan pada set model baharu yang terhad, pemesejan rentas sesi hanya mencapai sesi anda yang lain pada mesin yang sama, dan /loop yang memilih selang masanya sendiri memerlukan Claude Code v2.1.248 atau lebih baharu. Desktop boleh dicapai melalui Claude Desktop pada 3P atau melalui penghalaan get laluan (gateway routing) yang dikonfigurasikan dalam aplikasi atau oleh pentadbir. Semak halaman ketersediaan ciri Anthropic sebelum anda menjanjikan sesuatu ciri kepada pasukan anda, kerana senarai ini sentiasa berubah.

Siapa yang menanggung bil tersebut

Langganan dan endpoint pihak ketiga adalah pembelian yang berasingan. Salah satu tidak menggantikan yang lain.

Perkara ini perlu dinyatakan dengan jelas, kerana kesilapan ini tidak disedari. Tetapkan CLAUDE_CODE_USE_BEDROCK=1 pada mesin di mana anda juga telah log masuk dengan seat Max, dan trafik tersebut akan dibilkan oleh AWS: mengikut token pada kadar on-demand Bedrock, atau terhadap provisioned throughput jika itu yang dibeli oleh akaun anda. Seat tersebut terus dicaj setiap bulan dan tidak membayar untuk mana-mana trafik tersebut. Tiada paparan gabungan juga: perbelanjaan beralih ke AWS Cost Explorer atau Google Cloud Billing, dan papan pemuka analitik Anthropic tidak tersedia pada mana-mana penyedia tersebut. Perintah /logout juga hilang, kerana tiada sesi Anthropic untuk ditamatkan. Kredensial tersebut ialah kredensial awan.

Kadar harga terdapat pada halaman penyedia itu sendiri dan sentiasa berubah, jadi baca harga Amazon Bedrock atau harga Vertex AI dan bukannya mana-mana angka dalam artikel. Satu perkara struktur tidak berubah: inferens on-demand pada endpoint ini dibilkan mengikut token, jadi ejen yang dibiarkan berjalan sepanjang hari akan menanggung kosnya, tanpa had pelan untuk menghentikannya. Alternatif yang dijual oleh kedua-dua awan ialah provisioned throughput, iaitu kapasiti terpelihara pada caj tetap selagi anda memegangnya. AWS mengenakan caj setiap jam, dan Claude Code menggunakannya apabila anda menetapkan ARN provisioned throughput sebagai ID model. Sama ada mana-mana pilihan lebih berbaloi daripada membeli seat untuk semua orang adalah perkara yang perlu dikira sebelum pelancaran dan bukannya selepas invois pertama, dan pengiraan seat berbanding per-token untuk Team dan Enterprise menjalankan perbandingan tersebut pada skala pasukan.

Had laju dan kuota berfungsi secara berbeza pada setiap penghalaan

Pada langganan Pro, Max, Ultra, Team dan Enterprise berasaskan kerusi (seat-based) yang lama, had adalah milik akaun dan ditetapkan semula mengikut jadual. Mencapai had bermakna anda perlu menunggu, melainkan kredit penggunaan diaktifkan: pelanggan Pro, Max dan Ultra, serta organisasi Team dan Enterprise berasaskan kerusi yang lama, boleh terus bekerja melebihi had pada kadar API standard sehingga had perbelanjaan dicapai. Pelan Enterprise berasaskan penggunaan semasa tidak mempunyai had penggunaan pada peringkat pelan atau kerusi: penggunaan dibilkan mengikut konsumsi, dan pentadbir boleh menetapkan had perbelanjaan organisasi serta individu. Perilaku tersebut diterangkan dalam cara had penggunaan berfungsi.

Pada kunci API Anthropic, had adalah milik organisasi, dinyatakan sebagai permintaan dan token seminit, serta meningkat mengikut tahap penggunaan anda.

Pada Bedrock dan Vertex, had tersebut merupakan kuota awan yang tiada kaitan dengan mana-mana pelan Anthropic. Pada Bedrock, had ditetapkan bagi setiap akaun dan rantau, kebanyakannya mengikut model, ditambah dengan kuota token harian merentas model yang disokong dalam akaun dan rantau tersebut. Pada Vertex, had ditetapkan bagi setiap projek dan lokasi, manakala pada endpoint global dan berbilang rantau, model Claude yang dilancarkan selepas 26 Mei 2026 berkongsi satu kuota bagi setiap keturunan model: setiap versi keluarga model mengambil daripada baldi yang sama di lokasi tertentu, dan endpoint global serta setiap endpoint berbilang rantau mengekalkan baldi yang berasingan. Ralat 429 biasanya bermaksud salah satu kuota tersebut telah habis, tetapi pada kapasiti bayar-guna (pay-as-you-go) yang dikongsi, ia juga boleh bermaksud penyedia kekurangan kapasiti, jadi cuba semula dengan backoff sebelum anda mengubah apa-apa. Apabila ia melibatkan kuota anda, penyelesaiannya ada dalam konsol penyedia: minta peningkatan, atau pindah ke lokasi yang mempunyai ruang lebihan. Bedrock mengenakan caj kuota terhadap peraturan token burndown dan bukannya kiraan permintaan tetap, dan kapasiti terpelihara pada mana-mana awan dibeli sebagai provisioned throughput. Pada Vertex, pastikan endpoint rantau tunggal anda melayani kedua-dua model utama dan model kecil yang pantas semasa menyiasat ralat 429; CLOUD_ML_REGION=global ialah titik permulaan yang didokumenkan untuk ketersediaan yang lebih baik. Halaman kuota Google merangkumi permintaan peningkatan.

Mod kegagalan, berserta rentetan yang akan anda lihat

Could not load the default credentials, pada Vertex. Application Default Credentials tiada atau telah tamat tempoh. Jalankan gcloud auth application-default login, atau halakan GOOGLE_APPLICATION_CREDENTIALS kepada fail kunci akaun perkhidmatan.

Ralat 404 yang menamakan model, pada Vertex. Model tersebut tidak didayakan dalam Model Garden untuk projek itu, atau ia tidak ditawarkan di lokasi yang anda tetapkan. Sesetengah model hanya dihidangkan pada endpoint global atau lokasi berbilang rantau seperti eu, dan tidak pernah di rantau tertentu.

on-demand throughput isn't supported, pada Bedrock. Anda memasukkan ID model asas (foundation model) untuk model yang hanya dihidangkan melalui profil inferens. Gunakan ID profil inferens sebaliknya.

AWS default-chain credential resolve timed out. Satu langkah dalam rantaian kelayakan AWS terhenti, contohnya pembantu credential_process menunggu input yang tidak akan pernah diterima. Penyelesaian yang mengisi cache kelayakan tamat masa selepas 60 saat secara lalai. Jika rantaian anda benar-benar memerlukan masa yang lebih lama, contohnya aliran SSO pelayar dengan MFA (pengesahan berbilang faktor) di sebalik pembalut (wrapper), tingkatkan had dalam milisaat dengan CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS. Dengan CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1 ditetapkan, setiap permintaan API menyelesaikan rantaian tanpa had ini.

Ralat semasa memulakan Bedrock streaming response has content-type. Sesuatu antara Claude Code dan Bedrock sedang menulis semula strim tersebut. Bedrock menstrim dalam format event-stream binari dengan jenis kandungan application/vnd.amazon.eventstream, jadi get laluan (gateway) yang memancarkan semula ia sebagai server-sent events memberikan kembali badan yang tidak dapat dinyahkod oleh Claude Code. Betulkan get laluan supaya ia melepaskan badan respons dan pengepala Content-Type miliknya tanpa diubah.

Tab pelayar terbuka dalam gelung semasa AWS SSO. VPN korporat atau proksi pemeriksaan TLS mengganggu proses daftar masuk, Claude Code membaca sambungan yang rosak itu sebagai kegagalan pengesahan, menjalankan semula perintah awsAuthRefresh, dan mengulanginya selama-lamanya. Buang awsAuthRefresh daripada fail tetapan anda dan jalankan aws sso login secara manual sebelum memulakan Claude Code.

Memilih penghalaan

Pilih Anthropic direct jika anda mahukan model baharu pada hari pelancaran dan set ciri yang lengkap. Pilih API key jika anda mahukan pengebilan setiap token tanpa perlu membeli tempat duduk (seats). Pilih Bedrock atau Vertex apabila syaratnya ialah inferens mesti berlaku di dalam akaun awan yang sudah anda tadbir, dan anda menerima ketersediaan model pembekal serta senarai ciri yang lebih terhad sebagai ganti rugi. Halaman persediaan yang wajar ditanda buku ialah halaman Anthropic sendiri, untuk Amazon Bedrock dan untuk Google Vertex AI, berserta senarai model mengikut wilayah daripada AWS.

Tiada satu pun daripada ketiga-tiga pilihan ini mengubah lokasi ejen itu sendiri dilaksanakan. Claude Code ialah proses setempat yang membaca fail anda dan menjalankan arahan anda, tidak kira titik akhir (endpoint) mana yang menjawabnya. Itulah sebabnya pasukan yang mahukannya berjalan di tempat lain selain komputer riba meletakkan ejen pengekodan pada VPS dan mengeksport pemboleh ubah yang sama di sana.

FAQ

Adakah langganan Claude saya membayar untuk Claude Code pada Bedrock atau Vertex?

Tidak. Langganan Pro, Max, Ultra, Team atau Enterprise dan endpoint pihak ketiga adalah pembelian yang berasingan, dan tiada satu pun yang melindungi yang lain. Dengan CLAUDE_CODE_USE_BEDROCK=1 atau CLAUDE_CODE_USE_VERTEX=1 ditetapkan, trafik dibilkan oleh AWS atau Google Cloud, mengikut token pada kadar atas permintaan (on-demand) mereka atau berdasarkan throughput yang diperuntukkan yang telah anda beli, dan akan muncul pada bil awan tersebut, manakala langganan anda terus dicaj untuk perkhidmatan yang dilindunginya. Penjejakan perbelanjaan beralih bersamanya ke AWS Cost Explorer atau Google Cloud Billing, kerana papan pemuka analitik Anthropic tidak tersedia pada mana-mana penyedia tersebut.

Ke wilayah manakah Claude Code menghantar permintaan saya pada Amazon Bedrock?

Ke wilayah yang diselesaikan, yang akan ditunjukkan oleh /status kepada anda. Claude Code menyemak AWS_REGION, kemudian AWS_DEFAULT_REGION, seterusnya region pada profil AWS aktif anda, dan kembali kepada us-east-1 apabila tiada satu pun daripadanya ditetapkan. Model lalai terbina dalamnya kemudian diselesaikan kepada profil inferens rentas wilayah yang awalan namanya mengikut wilayah tersebut, seperti us. atau eu., dan profil rentas wilayah boleh melayani permintaan daripada wilayah lain dalam geografi yang sama. Apabila satu wilayah yang dinamakan menjadi keperluan mutlak, gunakan profil inferens aplikasi yang disokong oleh model asas di wilayah tersebut, bukannya profil rentas wilayah, dan tetapkan ANTHROPIC_MODEL kepada ARN-nya.

Mengapakah model Claude terbaharu tiada dalam akaun Bedrock atau Vertex saya?

Kerana setiap penyedia awan mendayakan model mengikut jadual mereka sendiri, dan akaun anda perlu diberikan akses tambahan selepas itu. Pada Vertex, anda perlu meminta akses dalam Model Garden dan kelulusan boleh mengambil masa 24 hingga 48 jam. Sehingga itu, alias seperti sonnet dan opus diselesaikan kepada lalai terbina dalam Claude Code untuk penyedia tersebut, dan apabila lalai itu tidak tersedia dalam akaun anda, Claude Code akan kembali kepada model yang lebih awal atau peringkat lebih rendah untuk sesi tersebut dan memaparkan notis. Tetapkan ANTHROPIC_DEFAULT_SONNET_MODEL dan model yang berkaitan kepada ID yang telah anda sahkan didayakan.

Adakah carian web tersedia dalam Claude Code pada Amazon Bedrock?

Tidak. Alat WebSearch tidak tersedia pada Bedrock, jadi Claude tidak boleh menjalankan carian daripada sesi yang dihalakan ke sana. Ia masih boleh membaca halaman tertentu dengan WebFetch apabila anda memberikan URL. Pada Google Vertex AI, carian web berfungsi untuk model generasi Claude 4 dan seterusnya, yang merupakan salah satu daripada sedikit perbezaan keupayaan yang memihak kepada Vertex.

Adakah saya memerlukan akaun Anthropic untuk menjalankan Claude Code pada Bedrock atau Vertex?

Tidak. Pengesahan adalah menggunakan kelayakan AWS atau Google Cloud anda, itulah sebabnya /logout tidak tersedia pada kedua-dua penyedia tersebut. Satu sambungan ke Anthropic tetap wujud tidak kira penyedia yang anda gunakan: sebelum mengambil URL, alat WebFetch menghantar nama hos, dan hanya nama hos tersebut, ke api.anthropic.com untuk menyemaknya terhadap senarai sekat keselamatan. Tetapkan skipWebFetchPreflight dalam fail tetapan anda untuk mematikan fungsi tersebut, dan pasangkannya dengan peraturan kebenaran WebFetch jika anda masih mahu mengehadkan domain yang boleh dicapai oleh Claude.

Adakah artikel ini berguna?