> For the complete documentation index, see [llms.txt](https://docs.nimbalyst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nimbalyst.com/setup-nimbalyst/claude-code-in-vertex-bedrock.md).
# Claude Code in Vertex, Bedrock
Configure Claude Code in Nimbalyst to run through Google Vertex AI or Amazon Bedrock using your own cloud account and existing credentials.
Nimbalyst can run Claude through your preferred cloud provider, Claude on Vertex AI (Google Cloud) or Amazon Bedrock, instead of Anthropic directly. Use this when your organization already has cloud billing and compliance set up with one of those providers.
You configure this by adding environment variables in the Claude Agent settings panel. Nimbalyst sets them for the Claude Code sessions it launches; they are stored with your Claude Code settings, and Nimbalyst never reads API keys from your shell environment.
### How to configure
1. Open **Settings > Application > Claude Agent**.
2. Scroll to the **Environment Variables** section.
3. Add the required variables for your provider.
The Environment Variables section: enter a variable name and value, then click Add.
**For Google Vertex AI:**
| Variable | Value |
| ----------------------------- | ----------------------------------------------- |
| `CLAUDE_CODE_USE_VERTEX` | `1` |
| `CLOUD_ML_REGION` | `global` (or a specific region like `us-east5`) |
| `ANTHROPIC_VERTEX_PROJECT_ID` | Your GCP project ID |
Prerequisites: Enable the Vertex AI API in your GCP project, request access to Claude models in the Model Garden, and authenticate via `gcloud auth application-default login`.
**For Amazon Bedrock:**
| Variable | Value |
| ------------------------- | -------------------------------------- |
| `CLAUDE_CODE_USE_BEDROCK` | `1` |
| `AWS_REGION` | `us-east-1` (or your preferred region) |
Prerequisites: Enable Bedrock access in your AWS account, request access to Claude models, and configure AWS credentials (via AWS CLI, environment variables, or SSO profile).
### Benefits
* Use existing cloud credentials and billing
* Meet enterprise compliance requirements
* Choose the provider that fits your infrastructure
* No separate Anthropic API key required
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.nimbalyst.com/setup-nimbalyst/claude-code-in-vertex-bedrock.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
