SSD Nodes Learn Hosting plans →
Hướng dẫn Matt ConnorBởi Matt Connor

Chạy Claude Code trên Bedrock hay Vertex AI

Cấu hình Claude Code với Amazon Bedrock hoặc Google Vertex AI: biến môi trường, nguồn credentials, bên chịu phí và các tính năng bạn phải bỏ.

Claude Code chạy trên cloud account của bạn thì có gì thay đổi

Bạn có thể chạy Claude Code trên Amazon Bedrock hoặc Google Vertex AI. Việc chuyển đổi chỉ cần thêm hoặc đổi hai đến ba biến môi trường, cùng với cloud credentials mà team của bạn đã có. Mọi thứ chạy local vẫn giữ nguyên: CLI, subagent, hook, skill, MCP server và các file CLAUDE.md. Chỉ lệnh gọi model được chuyển sang nơi khác. Cùng với nó, 4 yếu tố cũng thay đổi: network mà request đi qua, account thanh toán chi phí, các Claude model bạn được phép gọi và những tính năng phía server thực sự có sẵn.

Câu hỏi hiếm khi là liệu nó có hoạt động hay không. Nó hoạt động. Câu hỏi là trong 4 yếu tố đó, bạn quan tâm nhất đến yếu tố nào.

Ba cách định tuyến và chi phí của từng cách

Kết nối trực tiếp đến Anthropic bằng subscription. Bạn đăng nhập bằng tài khoản claude.ai có gói Pro, Max, Ultra, Team hoặc Enterprise. Request được gửi đến API của Anthropic. Với Pro, Max, Ultra và Team, bạn trả phí theo seat. Mức sử dụng bị giới hạn theo hạn mức của gói, không tính theo từng token. Các gói Enterprise hiện tại là ngoại lệ: phí seat không bao gồm mức sử dụng, và mỗi token được tính thêm theo bảng giá API tiêu chuẩn. Các hợp đồng Enterprise cũ tính theo seat sẽ chuyển sang mô hình này khi gia hạn. Đây là cách định tuyến duy nhất truy cập được các giao diện xây dựng trên tài khoản, như Claude Code trên web, ứng dụng mobile và Remote Control. Với team, gói Team đã có single sign-on và các setting do server quản lý để cấu hình Claude Code trên toàn tổ chức. Gói Claude Enterprise bổ sung audit log, SCIM, quyền kiểm soát thời gian lưu dữ liệu tùy chỉnh và Compliance API.

Kết nối trực tiếp đến Anthropic bằng API key. Bạn tạo key trong Anthropic Console và trả phí theo token. Cơ sở hạ tầng và các region giống subscription, không có seat, và mức sử dụng hiển thị trong dashboard riêng của Anthropic. Cách nào rẻ hơn tùy thuộc vào số giờ mỗi ngày agent thực sự chạy. Đây là chủ đề chính của so sánh chi phí API với subscription và chi phí thực tế của Claude Code.

Endpoint bên thứ ba trên Bedrock hoặc Vertex. Tài khoản AWS hoặc Google Cloud của bạn phục vụ model. Anthropic không nằm trên đường đi của request tại thời điểm inference. Token được tính vào hóa đơn cloud bạn đã nhận, tuân theo các policy IAM (identity and access management) và audit log mà bạn đã vận hành. Có thêm ba tùy chọn bên thứ ba: Microsoft Foundry, Claude Platform trên AWS và Claude Models trên Google Cloud (Anthropic quản lý). Chúng có cùng mô hình: một biến môi trường chọn provider, còn tài khoản cloud chịu chi phí. Route Google Cloud do Anthropic quản lý sử dụng CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD=1 và tách biệt với Vertex.

Lưu ý về tên gọi, tính đến October 2026: Google đã đổi tên Vertex AI thành Agent Platform của Google Cloud. Tài liệu của Anthropic dùng tên mới, nhưng prompt đăng nhập Claude Code vẫn ghi Google Vertex AI, còn các biến môi trường vẫn ghi VERTEX.

Lưu trữ dữ liệu theo khu vực mới là lý do thực sự khiến các team dùng cách này

Trên Bedrock, request được gửi đến endpoint Bedrock trong AWS region mà bạn chọn, thuộc account của bạn. Dữ liệu ở trạng thái lưu trữ được mã hóa bằng AES-256 với các key do AWS quản lý. Bạn cũng có thể cung cấp key riêng thông qua AWS KMS (key management service). Trên Vertex, cơ chế tương đương là các key mã hóa do Google quản lý, đồng thời hỗ trợ CMEK (customer-managed encryption keys). Quyền truy cập được kiểm soát bằng các IAM role mà bạn đang dùng. Các lần gọi API xuất hiện trong CloudTrail hoặc, khi bật Data Access audit logging, trong Cloud Audit Logs. Với một team chịu quy định, đó là toàn bộ cơ sở để lựa chọn cách này, và đây là một cơ sở hợp lý.

Hai chi tiết khiến phạm vi bảo đảm này không tuyệt đối như nội dung marketing mô tả.

Cross-region inference profile không thuộc một region duy nhất. Trên Bedrock, Claude Code ánh xạ các model mặc định tích hợp sẵn sang các ID của cross-region inference profile. Prefix được ưu tiên phụ thuộc vào region mà nó đã xác định: us. trong một region us-*, eu. trong một region eu-*, apac. trong một region ap-* và us-gov. trong GovCloud. Một cross-region profile có thể xử lý request từ một region khác trong cùng khu vực địa lý. Vì vậy, điều bạn được bảo đảm là một khu vực địa lý, không phải một thành phố. Nếu yêu cầu của bạn chỉ rõ một region, hãy định tuyến qua một application inference profile được liên kết với foundation model trong region đó, thay vì dùng cross-region profile, rồi đặt ANTHROPIC_MODEL thành ARN của profile đó.

Một phần traffic vẫn đến Anthropic. Telemetry, báo cáo lỗi và command /feedback mặc định đều tắt trên cả Bedrock và Vertex. /feedback ghi một archive vào ~/.claude/feedback-bundles/ trên chính máy của bạn thay vì upload dữ liệu. Có 2 ngoại lệ hoạt động trên mọi provider. Trước khi fetch một URL, tool WebFetch gửi hostname, và chỉ hostname, đến api.anthropic.com để kiểm tra safety blocklist. Survey về chất lượng session cũng vẫn xuất hiện. Tắt ngoại lệ đầu tiên bằng skipWebFetchPreflight trong settings file của bạn và tắt ngoại lệ thứ hai bằng CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1. Đặt CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC cũng sẽ tắt survey cùng với phần traffic không thiết yếu còn lại, nhưng không ảnh hưởng đến bước kiểm tra của WebFetch; bước này có tùy chọn opt-out riêng. Khi host platform đặt CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST, telemetry sẽ mặc định bật.

Về việc training: theo điều khoản thương mại, Anthropic không training model bằng code hoặc prompt được gửi qua Claude Code, và việc sử dụng platform của bên thứ ba cũng thuộc phạm vi thương mại. Development Partner Program, tùy chọn opt-in cho phép training, hoàn toàn không được cung cấp cho người dùng Bedrock hoặc Vertex. Trên Vertex, các model Fable yêu cầu chia sẻ prompt-response với Anthropic để giám sát hành vi lạm dụng. Điều tương tự cũng áp dụng cho các model tham gia Cyber Verification Program. Chính sách zero data retention trên các endpoint này phụ thuộc vào thỏa thuận của bạn với AWS hoặc Google và yêu cầu retention của model.

Trỏ Claude Code đến Amazon Bedrock

Có 2 việc cần thực hiện một lần cho mỗi AWS account trước khi cấu hình client. Mở console Amazon Bedrock, chọn một model Anthropic trong model catalog và gửi biểu mẫu use case: quyền truy cập được cấp ngay sau khi gửi. Sau đó gắn một IAM policy cho phép các cuộc gọi mà Claude Code thực hiện.

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

ListInferenceProfiles cho phép Claude Code kiểm tra khi khởi động xem account của bạn thực sự có thể invoke những model nào. GetInferenceProfile cho phép Claude Code phân giải ARN của application inference profile về foundation model đứng sau profile đó, để chọn đúng request shape. Nếu thiếu quyền này, request vẫn thành công vì Claude Code sẽ thử lại một lần với shape còn lại. Biểu hiện là mỗi model mới phát sinh thêm một round trip, không phải lỗi. Policy do Anthropic công bố cũng cho phép aws-marketplace:ViewSubscriptions và aws-marketplace:Subscribe khi được gọi qua Bedrock, bao gồm bước đăng ký model.

Cách cấu hình client nhanh nhất là dùng wizard. Chạy claude, chọn 3rd-party platform rồi chọn Amazon Bedrock, hoặc nhập /setup-bedrock trong một session đã đăng nhập. Lệnh này đọc các profile trong thư mục ~/.aws, xác minh những model bạn có thể invoke và ghi kết quả vào block env của ~/.claude/settings.json, nên cấu hình không phụ thuộc vào shell profile.

Nếu triển khai bằng script, hãy tự đặt các biến.

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

Credentials được lấy từ standard AWS SDK credential chain. Vì vậy, bất cứ thứ gì đang hoạt động với CLI aws đều dùng được ở đây: aws configure, SSO profile, assumed role hoặc Bedrock API key.

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

Bearer token là lựa chọn đơn giản nhất nhưng cần được xử lý cẩn thận, vì nó là secret nằm trong environment variable. AWS cấp short-term key có thời hạn tối đa 12 giờ và long-term key có thời hạn đến ngày bạn đặt, đồng thời khuyến nghị chỉ dùng loại long-term cho mục đích thử nghiệm. Trên build box dùng chung, nên ưu tiên role có thời hạn. Lý do tương tự áp dụng cho mọi credential khác mà agent có thể đọc; nội dung này được trình bày trong giữ secret ngoài tầm với của AI agent.

Bẫy region. Claude Code phân giải region theo thứ tự: AWS_REGION, sau đó AWS_DEFAULT_REGION, rồi đến region trong AWS profile đang active, cuối cùng là us-east-1. Bước cuối là giá trị mặc định, không phải lỗi. Vì vậy, nếu team không đặt region ở đâu và mặc định rằng request sẽ đi qua châu Âu, request sẽ được gửi đến một region tại Mỹ mà không có cảnh báo nào. Chạy /status bên trong Claude Code để xem region đã phân giải và nguồn của region đó. Để xác nhận account của bạn có thể gọi những gì trong một region, chạy aws bedrock list-inference-profiles --region your-region.

Bedrock cũng cung cấp endpoint Mantle, sử dụng native Anthropic API shape. Chọn endpoint này bằng CLAUDE_CODE_USE_MANTLE=1; endpoint dùng cùng AWS credentials nhưng yêu cầu các quyền IAM bedrock-mantle: riêng.

Chạy Claude Code trên Google Vertex AI

Bật API và lấy thông tin xác thực.

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

Trong Model Garden, yêu cầu quyền truy cập vào các model Claude mà bạn cần. Chờ 24 đến 48 giờ để được phê duyệt. Cấp roles/aiplatform.user, quyền này bao gồm permission aiplatform.endpoints.predict dùng cho cả việc gọi model và đếm token.

Sau đó chọn provider.

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

CLOUD_ML_REGION nhận global, một location đa vùng như eu hoặc us, hoặc một region cụ thể. Global endpoint cho khả năng sẵn sàng tốt nhất nhưng ít quyền kiểm soát nhất đối với nơi xử lý request. Vì vậy, yêu cầu về nơi lưu trú dữ liệu thường đồng nghĩa với việc chỉ định một location. Phạm vi model hỗ trợ khác nhau giữa ba dạng này. Khi global endpoint thiếu một model mà bạn cần, chỉ pin model đó vào một location bằng biến VERTEX_REGION_CLAUDE_* và giữ mọi thứ khác ở global. Hãy kiểm tra trang các location của Vertex AI hiện tại thay vì tin vào một danh sách đã lỗi thời.

Bẫy về project. ANTHROPIC_VERTEX_PROJECT_ID quyết định request sẽ đi đâu. Claude Code gửi request đến project đó ngay cả khi GCLOUD_PROJECT, GOOGLE_CLOUD_PROJECT hoặc file credential được chỉ định bởi GOOGLE_APPLICATION_CREDENTIALS chứa một project khác. Trên máy có gcloud trỏ đến một project nhưng ANTHROPIC_VERTEX_PROJECT_ID còn sót lại lại chỉ đến project khác, chi phí sẽ được tính cho project thứ hai và session không cảnh báo bạn.

Xác minh sau mỗi lần thay đổi provider. Chạy /status để kiểm tra provider và cấu hình đang hoạt động. Nếu các biến không được truyền đến process, hãy kiểm tra xem chúng đã được export trong shell khởi chạy claude chưa. Chuyển chúng vào block env của file settings. Đây cũng là cách giữ một giá trị như AWS_PROFILE không xuất hiện trong mọi process khác mà bạn khởi chạy.

Các model bạn nhận được và thời điểm chúng xuất hiện

Các alias như sonnet và opus không có nghĩa là model mới nhất. Trên endpoint của bên thứ ba, chúng trỏ đến model mặc định tích hợp sẵn của Claude Code cho provider đó. Model này có thể cũ hơn bản phát hành hiện tại và tài khoản của bạn có thể chưa được bật quyền truy cập. Khi model mặc định không khả dụng, Claude Code sẽ chuyển sang model cũ hơn hoặc cấp thấp hơn trong session đó và in thông báo. Model fallback không được lưu lại. Tuy nhiên, Claude Code có thể ghi nhớ việc từ chối quyền truy cập model trên máy trong tối đa một ngày. Khi khởi động, Claude Code sẽ kiểm tra lại việc từ chối model mặc định hiện tại nếu lần kiểm tra trước đã cách đó hơn mười phút.

Nếu triển khai cho cả team, hãy pin phiên bản.

# 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>'

Lấy ID từ tổng quan về các model và catalog của provider bạn dùng, vì định dạng khác nhau theo từng provider: Bedrock yêu cầu inference profile ID hoặc ARN, còn Vertex yêu cầu tên model thuần. Không sao chép các ID này từ một bài viết, kể cả bài viết này. Việc pin model cũng giúp kiểm soát chi phí, vì model primary mặc định là model cấp Opus và Opus có giá mỗi token cao hơn Sonnet. Do đó, deployment không pin model nào sẽ bị tính theo mức giá cao hơn. Để cố định một model làm session default, hãy đặt ANTHROPIC_MODEL thành full ID của model đó.

Thời điểm model xuất hiện là khác biệt rõ nhất trong so sánh này. Trên API riêng của Anthropic, một model hoạt động ngay trong ngày ra mắt. Trên Bedrock và Vertex, model chỉ hoạt động sau khi cloud provider đã bật model đó trong region của bạn và cấp quyền truy cập cho tài khoản. Nếu một số tác vụ bắt buộc phải chạy trên model mới nhất, hãy duy trì một routing có thể truy cập model đó. Đây là trường hợp thực tế để định tuyến các model khác nhau cho những tác vụ khác nhau.

Những gì bạn phải bỏ khi dùng Bedrock và Vertex

Mọi tính năng chạy local đều hoạt động trên tất cả provider: subagent, hook, slash command, skill, plugin, checkpoint, sandbox, managed settings file và metric OpenTelemetry. Các thiếu hụt đều nằm ở phía server.

Cả hai endpoint đều không hỗ trợ: Advisor, Channels, Code Mode, analytics dashboard, server-managed settings, cùng các command /design-sync và /import. Ngoài ra, mọi tính năng cần tài khoản claude.ai cũng không khả dụng, bao gồm Claude Code trên web, ứng dụng mobile, Remote Control, routine và artifact.

Chỉ Bedrock không hỗ trợ fast mode. Bedrock cũng không có tool WebSearch, nên Claude không thể chạy tìm kiếm từ session được định tuyến đến Bedrock. Claude vẫn có thể đọc một trang bằng WebFetch khi bạn cung cấp URL. Trên Vertex, tìm kiếm web hoạt động với các model thuộc thế hệ Claude 4 trở lên. Vertex cũng hỗ trợ fast mode trên Fable 5.2 với Claude Code v2.1.322 trở lên trong global, us hoặc eu. Nếu provider từ chối fast mode, hệ thống sẽ fallback về tốc độ tiêu chuẩn.

Cả hai đều chỉ hỗ trợ một phần: auto mode chỉ chạy trên một tập model mới hơn bị giới hạn; tính năng nhắn tin giữa các session chỉ gửi được đến các session khác trên cùng máy; và /loop tự chọn interval cần Claude Code v2.1.248 trở lên. Có thể truy cập Desktop thông qua Claude Desktop trên 3P hoặc thông qua gateway routing được cấu hình trong app hay bởi administrator. Hãy kiểm tra trang tính khả dụng của tính năng của Anthropic trước khi cam kết một tính năng với team, vì danh sách này thường thay đổi.

Chi phí được tính cho ai

Subscription và endpoint của bên thứ ba là hai khoản mua riêng. Khoản này không thay thế cho khoản kia.

Cần nói rõ điều này vì lỗi có thể xảy ra mà không có cảnh báo. Nếu đặt CLAUDE_CODE_USE_BEDROCK=1 trên một máy mà bạn cũng đang đăng nhập bằng một Max seat, lưu lượng sẽ được AWS tính phí: theo từng token với mức giá on-demand của Bedrock, hoặc trừ vào provisioned throughput nếu đó là gói tài khoản của bạn. Seat vẫn bị tính phí hằng tháng nhưng không chi trả cho bất kỳ lưu lượng nào trong số đó. Cũng không có chế độ xem tổng hợp: chi phí được hiển thị trong AWS Cost Explorer hoặc Google Cloud Billing, còn Anthropic analytics dashboard không có trên hai nhà cung cấp này. Lệnh /logout cũng không còn tác dụng vì không có phiên Anthropic để kết thúc. Credential được sử dụng là cloud credential.

Giá nằm trên trang riêng của nhà cung cấp và có thể thay đổi, vì vậy hãy xem giá Amazon Bedrock hoặc giá Vertex AI, thay vì dùng bất kỳ con số nào trong bài viết. Có một điểm về mô hình tính phí không thay đổi: inference on-demand trên các endpoint này được tính theo token, nên một agent chạy cả ngày sẽ tốn chi phí tương ứng, không có giới hạn của plan để ngăn chi phí tăng thêm. Lựa chọn thay thế mà cả hai cloud đều cung cấp là provisioned throughput, tức capacity được reserved với mức phí cố định trong thời gian bạn giữ capacity đó. AWS tính phí theo giờ, và Claude Code sẽ sử dụng capacity này khi bạn đặt ARN của provisioned throughput làm model ID. Trước khi rollout, nên tính xem lựa chọn nào có lợi hơn so với mua seat cho mọi người, thay vì chờ đến invoice đầu tiên. Bài so sánh seat với chi phí theo token cho Team và Enterprise thực hiện phép so sánh này ở quy mô team.

Giới hạn tốc độ và quota hoạt động khác nhau trên từng routing

Trên các gói Pro, Max, Ultra, Team và Enterprise dạng seat đời cũ, các giới hạn thuộc về account và được reset theo lịch. Khi chạm giới hạn, bạn phải chờ, trừ khi đã bật usage credits: subscriber Pro, Max và Ultra, cùng các organization Team và Enterprise dạng seat đời cũ, có thể tiếp tục làm việc sau khi vượt giới hạn ở mức giá API tiêu chuẩn cho đến một spend limit. Các plan Enterprise tính phí theo usage hiện tại không có usage limit ở cấp plan hoặc seat: usage được tính phí theo mức tiêu thụ, còn admin có thể đặt spend limit cho organization và từng cá nhân. Cách hoạt động này được giải thích trong cách usage limit hoạt động.

Với Anthropic API key, các giới hạn thuộc về organization, được biểu thị bằng số request và token mỗi phút, và tăng theo usage tier của bạn.

Trên Bedrock và Vertex, các giới hạn là cloud quota và không liên quan đến bất kỳ Anthropic plan nào. Trên Bedrock, quota được đặt theo account và region, chủ yếu theo model, cùng với daily token quota áp dụng cho các model được hỗ trợ trong account và region đó. Trên Vertex, quota được đặt theo project và location. Với global endpoint và multi-region endpoint, các model Claude được phát hành sau May 26, 2026 dùng chung một quota theo model lineage: mọi version trong cùng một model family đều trừ vào cùng một bucket tại một location, còn global endpoint và từng multi-region endpoint có bucket riêng. Lỗi 429 thường có nghĩa là một trong các quota đó đã hết. Tuy nhiên, trên shared pay-as-you-go capacity, lỗi này cũng có thể có nghĩa là provider đang thiếu capacity, vì vậy hãy retry với backoff trước khi thay đổi cấu hình. Nếu quota của bạn đã hết, cách xử lý nằm trong console của provider: request tăng quota hoặc chuyển sang location còn headroom. Bedrock tính quota theo quy tắc token burndown thay vì số request cố định. Reserved capacity trên cả hai cloud được mua dưới dạng provisioned throughput. Trên Vertex, khi điều tra lỗi 429, hãy kiểm tra single-region endpoint có phục vụ cả primary model và small fast model hay không; CLOUD_ML_REGION=global là điểm bắt đầu được ghi nhận trong tài liệu để cải thiện availability. Trang quotas của Google hướng dẫn cách request tăng quota.

Các lỗi thường gặp và chuỗi bạn sẽ thấy

Could not load the default credentials, trên Vertex. Application Default Credentials bị thiếu hoặc đã hết hạn. Chạy gcloud auth application-default login hoặc trỏ GOOGLE_APPLICATION_CREDENTIALS đến file key của service account.

Lỗi 404 có tên model, trên Vertex. Model chưa được bật trong Model Garden cho project đó, hoặc không được cung cấp tại location bạn đã đặt. Một số model chỉ được phục vụ trên global endpoint hoặc tại location nhiều vùng như eu, không bao giờ được phục vụ trong một region cụ thể.

on-demand throughput isn't supported, trên Bedrock. Bạn đã truyền bare foundation model ID cho một model chỉ được phục vụ thông qua inference profile. Thay vào đó, hãy dùng inference profile ID.

AWS default-chain credential resolve timed out. Một bước trong AWS credential chain bị treo, chẳng hạn helper credential_process đang chờ input nhưng không thể nhận được. Phần phân giải dùng để điền credential cache sẽ timeout sau 60 giây theo mặc định. Nếu chain của bạn thực sự cần nhiều thời gian hơn, chẳng hạn browser SSO flow có MFA (xác thực đa yếu tố) chạy phía sau một wrapper, hãy tăng giới hạn theo đơn vị milliseconds bằng CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS. Khi đặt CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1, mỗi API request sẽ phân giải chain mà không áp dụng giới hạn này.

Lỗi khi khởi động Bedrock streaming response has content-type. Một thành phần nào đó giữa Claude Code và Bedrock đang viết lại stream. Bedrock stream dữ liệu theo định dạng binary event-stream với content type application/vnd.amazon.eventstream, nên gateway chuyển tiếp lại thành server-sent events sẽ trả về body mà Claude Code không thể decode. Sửa gateway để truyền nguyên vẹn response body và header Content-Type.

Các tab trình duyệt mở lặp lại trong quá trình AWS SSO. Corporate VPN hoặc proxy kiểm tra TLS làm gián đoạn quá trình đăng nhập. Claude Code hiểu connection bị lỗi là lỗi xác thực, chạy lại command awsAuthRefresh rồi lặp vô hạn. Xóa awsAuthRefresh khỏi settings file và chạy aws sso login thủ công trước khi khởi động Claude Code.

Chọn tuyến kết nối

Chọn Anthropic direct nếu bạn muốn dùng model mới ngay ngày phát hành và có đầy đủ tính năng. Chọn API key nếu bạn muốn tính phí theo token mà không phải mua seat. Chọn Bedrock hoặc Vertex nếu yêu cầu là inference phải diễn ra trong cloud account mà bạn đã quản trị, đồng thời bạn chấp nhận model có thể không được cung cấp ở mọi nơi và danh sách tính năng ngắn hơn để đổi lấy điều đó. Các trang thiết lập nên lưu lại là tài liệu chính thức của Anthropic cho Amazon Bedrock và Google Vertex AI, cùng với danh sách model theo region của AWS.

Cả ba lựa chọn đều không thay đổi nơi agent thực thi. Claude Code là một tiến trình local đọc file và chạy command của bạn, bất kể endpoint nào trả lời nó. Vì vậy, các team muốn chạy agent ở nơi khác ngoài laptop đặt coding agent trên VPS và export các biến tương tự tại đó.

FAQ

Gói thuê bao Claude có chi trả cho Claude Code trên Bedrock hoặc Vertex không?

Không. Gói Pro, Max, Ultra, Team hoặc Enterprise và endpoint của bên thứ ba là hai khoản mua riêng, không khoản nào bao gồm khoản nào. Khi đã đặt CLAUDE_CODE_USE_BEDROCK=1 hoặc CLAUDE_CODE_USE_VERTEX=1, lưu lượng được AWS hoặc Google Cloud tính phí theo token với mức giá on-demand của họ, hoặc trừ vào throughput đã provision mà bạn đã mua. Chi phí này xuất hiện trên hóa đơn cloud tương ứng, còn gói thuê bao vẫn tiếp tục tính phí cho các surface mà gói đó bao phủ. Việc theo dõi chi phí cũng chuyển sang AWS Cost Explorer hoặc Google Cloud Billing, vì dashboard analytics của Anthropic không khả dụng trên hai provider này.

Claude Code gửi request đến region nào trên Amazon Bedrock?

Đó là region mà Claude Code đã resolve, và /status sẽ hiển thị region đó. Claude Code kiểm tra AWS_REGION, sau đó AWS_DEFAULT_REGION, rồi region trong AWS profile đang active. Nếu không có giá trị nào được đặt, nó dùng us-east-1. Các model mặc định tích hợp sẵn sau đó được resolve thành cross-region inference profile có prefix theo region đó, chẳng hạn us. hoặc eu.. Cross-region profile có thể xử lý request tại một region khác trong cùng geography. Khi bắt buộc phải dùng một region cụ thể, hãy dùng application inference profile được liên kết với foundation model trong region đó thay vì cross-region profile, rồi đặt ANTHROPIC_MODEL thành ARN của profile.

Vì sao model Claude mới nhất không xuất hiện trong account Bedrock hoặc Vertex của tôi?

Vì mỗi cloud provider bật model theo lịch riêng, và account của bạn còn phải được cấp quyền truy cập. Trên Vertex, bạn yêu cầu quyền truy cập trong Model Garden; quá trình phê duyệt có thể mất 24 đến 48 giờ. Trong thời gian đó, các alias như sonnet và opus sẽ resolve thành model mặc định tích hợp sẵn của Claude Code cho provider đó. Nếu model mặc định chưa khả dụng trong account, Claude Code sẽ fallback về model cũ hơn hoặc tier thấp hơn cho session và hiển thị thông báo. Hãy pin ANTHROPIC_DEFAULT_SONNET_MODEL và các biến tương tự vào những ID mà bạn đã xác nhận là được enable.

Claude Code trên Amazon Bedrock có hỗ trợ tìm kiếm web không?

Không. Tool WebSearch không khả dụng trên Bedrock, nên Claude không thể chạy tìm kiếm từ session được route đến đó. Claude vẫn có thể đọc một trang cụ thể bằng WebFetch khi bạn cung cấp URL. Trên Google Vertex AI, web search có hoạt động với các model thuộc thế hệ Claude 4 trở lên. Đây là một trong số ít khác biệt về capability có lợi cho Vertex.

Tôi có cần account Anthropic để chạy Claude Code trên Bedrock hoặc Vertex không?

Không. Thông tin xác thực là credential của AWS hoặc Google Cloud, nên /logout không khả dụng trên cả hai provider. Dù bạn dùng provider nào, vẫn có một kết nối đến Anthropic: trước khi fetch URL, tool WebFetch gửi hostname, và chỉ hostname, đến api.anthropic.com để kiểm tra với safety blocklist. Đặt skipWebFetchPreflight trong file settings để tắt việc này. Nếu vẫn muốn giới hạn domain mà Claude có thể truy cập, hãy kết hợp với các permission rule của WebFetch.

Bài viết này có hữu ích không?