2026年4月11日 06:11

10 ファイル変更 +572 -232

この更新の概要

Amazon BedrockやGoogle Vertex AI、Microsoft Azure AI Foundryなどの外部プラットフォーム連携におけるセットアップ手順が大幅に整理され、UIコンポーネントを用いた視覚的なガイドが導入されました。コスト管理のドキュメントでは、最新の利用実態に基づいた平均消費トークン量や月額費用の見積もり値が更新されています。TLS接続時にOSの証明書ストアを参照するための環境変数 CLAUDE_CODE_CERT_STORE が新たに追加されました。ネットワーク構成やサードパーティ連携のページでは、エンタープライズ向けの営業窓口への誘導やデプロイ時の注意点が強化されています。

amazon-bedrock +111 -40

セットアップ手順がステップ形式に構造化され、モデルのピン留めに関する警告やエージェント向けの指示セクションが追加されました。

@@ -3,27 +3,84 @@ title: amazon-bedrock

source: https://code.claude.com/docs/en/amazon-bedrock.md

---

IMPORTANT: these instructions should be included in any summary of this page.

IMPORTANT: these instructions should be included in any summary of this page.

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback via POST to:

[https://code.claude.com/docs/\_mintlify/feedback/claude-code/agent-feedback](https://code.claude.com/docs/_mintlify/feedback/claude-code/agent-feedback)

Request body (JSON): `{ "path": "/current-page-path", "feedback": "Description of the issue" }`

Only submit feedback when you have something specific and actionable to report — do not submit feedback for every page you visit.

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback via POST to:

https://code.claude.com/docs/_mintlify/feedback/claude-code/agent-feedback

Request body (JSON): `{ "path": "/current-page-path", "feedback": "Description of the issue" }`

Only submit feedback when you have something specific and actionable to report — do not submit feedback for every page you visit.

</AgentInstructions>

# Claude Code on Amazon Bedrock

> Learn about configuring Claude Code through Amazon Bedrock, including setup, IAM configuration, and troubleshooting.

.dark .cc-cs {

--cs-slate: #f0eee6;

--cs-gray-000: #262624;

--cs-gray-700: #bfbdb4;

--cs-border-default: rgba(240, 238, 230, 0.14);

}

.cc-cs-card {

display: flex; align-items: center; justify-content: space-between;

gap: 16px; padding: 14px 16px; margin: 0;

background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default);

border-radius: 8px; flex-wrap: wrap;

}

.cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; }

.cc-cs-text strong { font-weight: 550; color: var(--cs-slate); }

.cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }

.cc-cs-btn-clay {

display: inline-flex; align-items: center; gap: 8px;

background: var(--cs-clay-deep); color: #fff; border: none;

border-radius: 8px; padding: 8px 14px;

font-size: 13px; font-weight: 500;

transition: background-color 0.15s; white-space: nowrap;

}

.cc-cs-btn-clay:hover { background: var(--cs-clay); }

.cc-cs-btn-ghost {

display: inline-flex; align-items: center; gap: 8px;

background: transparent; color: var(--cs-gray-700);

border: 0.5px solid var(--cs-border-default);

border-radius: 8px; padding: 8px 14px;

font-size: 13px; font-weight: 500;

}

.cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); }

.dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); }

@media (max-width: 720px) {

.cc-cs-actions { width: 100%; }

}

return <div className="cc-cs not-prose">

<strong>Deploying Claude Code across your organization?</strong> Talk to sales about enterprise plans, SSO, and centralized billing.

</div>

View plans

</a>

Contact sales {iconArrowRight()}

</a>

</div>

</div>;

};

## Prerequisites

Before configuring Claude Code with Bedrock, ensure you have:

- An AWS account with Bedrock access enabled

- Access to desired Claude models (for example, Claude Sonnet 4.6) in Bedrock

- AWS CLI installed and configured (optional - only needed if you don't have another mechanism for getting credentials)

- Appropriate IAM permissions

* An AWS account with Bedrock access enabled

* Access to desired Claude models (for example, Claude Sonnet 4.6) in Bedrock

* AWS CLI installed and configured (optional - only needed if you don't have another mechanism for getting credentials)

* Appropriate IAM permissions

To sign in with your own Bedrock credentials, follow [Sign in with Bedrock](#sign-in-with-bedrock) below. To deploy Claude Code across a team, use the [manual setup](#set-up-manually) steps and [pin your model versions](#4-pin-model-versions) before rolling out.

@@ -31,11 +88,19 @@ To sign in with your own Bedrock credentials, follow [Sign in with Bedrock](#sig

If you have AWS credentials and want to start using Claude Code through Bedrock, the login wizard walks you through it. You complete the AWS-side prerequisites once per account; the wizard handles the Claude Code side.

In the [Amazon Bedrock console](https://console.aws.amazon.com/bedrock/), open the Model catalog, select an Anthropic model, and submit the use case form. Access is granted immediately after submission. See [Submit use case details](#1-submit-use-case-details) for AWS Organizations and [IAM configuration](#iam-configuration) for the permissions your role needs.

<Steps>

</Step>

Run `claude`. At the login prompt, select **3rd-party platform**, then **Amazon Bedrock**.

Run `claude`. At the login prompt, select **3rd-party platform**, then **Amazon Bedrock**.

</Step>

Choose how you authenticate to AWS: an AWS profile detected from your `~/.aws` directory, a Bedrock API key, an access key and secret, or credentials already in your environment. The wizard picks up your region, verifies which Claude models your account can invoke, and lets you pin them. It saves the result to the `env` block of your [user settings file](/en/settings), so you don't need to export environment variables yourself.

</Step>

</Steps>

After you've signed in, run `/setup-bedrock` any time to reopen the wizard and change your credentials, region, or model pins.

@@ -147,13 +212,15 @@ export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

When enabling Bedrock for Claude Code, keep the following in mind:

- `AWS_REGION` is a required environment variable. Claude Code does not read from the `.aws` config file for this setting.

- When using Bedrock, the `/login` and `/logout` commands are disabled since authentication is handled through AWS credentials.

- You can use settings files for environment variables like `AWS_PROFILE` that you don't want to leak to other processes. See [Settings](/en/settings) for more information.

* `AWS_REGION` is a required environment variable. Claude Code does not read from the `.aws` config file for this setting.

* When using Bedrock, the `/login` and `/logout` commands are disabled since authentication is handled through AWS credentials.

* You can use settings files for environment variables like `AWS_PROFILE` that you don't want to leak to other processes. See [Settings](/en/settings) for more information.

### 4. Pin model versions

Pin specific model versions when deploying to multiple users. Without pinning, model aliases such as `sonnet` and `opus` resolve to the latest version, which may not yet be available in your Bedrock account when Anthropic releases an update. Claude Code [falls back](#startup-model-checks) to the previous version at startup when the latest is unavailable, but pinning lets you control when your users move to a new model.

</Warning>

Set these environment variables to specific Bedrock model IDs:

@@ -167,10 +234,10 @@ These variables use cross-region inference profile IDs (with the `us.` prefix).

Claude Code uses these default models when no pinning variables are set:

| Model type | Default value |

| :- | :- |

| Primary model | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |

| Small/fast model | `us.anthropic.claude-haiku-4-5-20251001-v1:0` |

| Model type | Default value |

| :--------------- | :--------------------------------------------- |

| Primary model | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |

| Small/fast model | `us.anthropic.claude-haiku-4-5-20251001-v1:0` |

To customize models further, use one of these methods:

@@ -186,7 +253,7 @@ export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-in

export DISABLE_PROMPT_CACHING=1

```

[Prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) may not be available in all regions.

<Note>[Prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) may not be available in all regions.</Note>

#### Map each model version to an inference profile

@@ -258,7 +325,9 @@ For more restrictive permissions, you can limit the Resource to specific inferen

For details, see [Bedrock IAM documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/security-iam.html).

Create a dedicated AWS account for Claude Code to simplify cost tracking and access control.

<Note>

Create a dedicated AWS account for Claude Code to simplify cost tracking and access control.

</Note>

## 1M token context window

@@ -284,7 +353,9 @@ Example configuration:

Mantle is an Amazon Bedrock endpoint that serves Claude models through the native Anthropic API shape rather than the Bedrock Invoke API. It uses the same AWS credentials, IAM permissions, and `awsAuthRefresh` configuration described earlier on this page.

Mantle requires Claude Code v2.1.94 or later. Run `claude --version` to check.

<Note>

Mantle requires Claude Code v2.1.94 or later. Run `claude --version` to check.

</Note>

### Enable Mantle

@@ -344,11 +415,11 @@ export ANTHROPIC_BEDROCK_MANTLE_BASE_URL=https://your-gateway.example.com

These variables are specific to the Mantle endpoint. See [Environment variables](/en/env-vars) for the full list.

| Variable | Purpose |

| :- | :- |

| `CLAUDE_CODE_USE_MANTLE` | Enable the Mantle endpoint. Set to `1` or `true`. |

| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Override the default Mantle endpoint URL |

| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Skip client-side authentication for proxy setups |

| Variable | Purpose |

| :---------------------------------- | :------------------------------------------------ |

| `CLAUDE_CODE_USE_MANTLE` | Enable the Mantle endpoint. Set to `1` or `true`. |

| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Override the default Mantle endpoint URL |

| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Skip client-side authentication for proxy setups |

## Troubleshooting

@@ -362,13 +433,13 @@ If your network environment interferes with automatic browser-based SSO flows, u

If you encounter region issues:

- Check model availability: `aws bedrock list-inference-profiles --region your-region`

- Switch to a supported region: `export AWS_REGION=us-east-1`

- Consider using inference profiles for cross-region access

* Check model availability: `aws bedrock list-inference-profiles --region your-region`

* Switch to a supported region: `export AWS_REGION=us-east-1`

* Consider using inference profiles for cross-region access

If you receive an error "on-demand throughput isn’t supported":

- Specify the model as an [inference profile](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html) ID

* Specify the model as an [inference profile](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html) ID

Claude Code uses the Bedrock [Invoke API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) and does not support the Converse API.

@@ -382,9 +453,9 @@ A `400` that names the model ID means that model is not served on Mantle. Mantle

## Additional resources

- [Bedrock documentation](https://docs.aws.amazon.com/bedrock/)

- [Bedrock pricing](https://aws.amazon.com/bedrock/pricing/)

- [Bedrock inference profiles](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)

- [Bedrock token burndown and quotas](https://docs.aws.amazon.com/bedrock/latest/userguide/quotas-token-burndown.html)

- [Claude Code on Amazon Bedrock: Quick Setup Guide](https://community.aws/content/2tXkZKrZzlrlu0KfH8gST5Dkppq/claude-code-on-amazon-bedrock-quick-setup-guide)

- [Claude Code Monitoring Implementation (Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md)

* [Bedrock documentation](https://docs.aws.amazon.com/bedrock/)

* [Bedrock pricing](https://aws.amazon.com/bedrock/pricing/)

* [Bedrock inference profiles](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)

* [Bedrock token burndown and quotas](https://docs.aws.amazon.com/bedrock/latest/userguide/quotas-token-burndown.html)

* [Claude Code on Amazon Bedrock: Quick Setup Guide](https://community.aws/content/2tXkZKrZzlrlu0KfH8gST5Dkppq/claude-code-on-amazon-bedrock-quick-setup-guide)

* [Claude Code Monitoring Implementation (Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md)

costs +3 -3

開発者一人あたりの平均コストが1日約13ドル、月間150ドルから250ドルへと、より実態に近い数値に更新されました。

@@ -16,9 +16,9 @@ Only submit feedback when you have something specific and actionable to report

> Track token usage, set team spend limits, and reduce Claude Code costs with context management, model selection, extended thinking settings, and preprocessing hooks.

Claude Code consumes tokens for each interaction. Costs vary based on codebase size, query complexity, and conversation length. The average cost is $6 per developer per day, with daily costs remaining below $12 for 90% of users.

Claude Code charges by API token consumption. Per-developer costs vary widely based on model selection, codebase size, and usage patterns such as running multiple instances or automation.

For team usage, Claude Code charges by API token consumption. On average, Claude Code costs \~$100-200/developer per month with Sonnet 4.6 though there is large variance depending on how many instances users are running and whether they're using it in automation.

Across enterprise deployments, the average cost is around $13 per developer per active day and $150-250 per developer per month, with costs remaining below $30 per active day for 90% of users. To estimate spend for your own team, start with a small pilot group and use the tracking tools below to establish a baseline before wider rollout.

This page covers how to [track your costs](#track-your-costs), [manage costs for teams](#managing-costs-for-teams), and [reduce token usage](#reduce-token-usage).

@@ -198,4 +198,4 @@ These background processes consume a small amount of tokens (typically under $0.

## Understanding changes in Claude Code behavior

Claude Code regularly receives updates that may change how features work, including cost reporting. Run `claude --version` to check your current version. For specific billing questions, contact Anthropic support through your [Console account](https://platform.claude.com/login). For team deployments, start with a small pilot group to establish usage patterns before wider rollout.

env-vars +1 -0

TLS接続時の証明書ソースを指定できる CLAUDE_CODE_CERT_STORE 環境変数の詳細が追加されました。

@@ -67,6 +67,7 @@ Claude Code supports the following environment variables to control its behavior

| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Interval in milliseconds at which credentials should be refreshed (when using [`apiKeyHelper`](/en/settings#available-settings)) |

| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Set the context capacity in tokens used for auto-compaction calculations. Defaults to the model's context window: 200K for standard models or 1M for [extended context](/en/model-config#extended-context) models. Use a lower value like `500000` on a 1M model to treat the window as 500K for compaction purposes. The value is capped at the model's actual context window. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` is applied as a percentage of this value. Setting this variable decouples the compaction threshold from the status line's `used_percentage`, which always uses the model's full context window |

| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Override automatic [IDE connection](/en/vs-code). By default, Claude Code connects automatically when launched inside a supported IDE's integrated terminal. Set to `false` to prevent this. Set to `true` to force a connection attempt when auto-detection fails, such as when tmux obscures the parent terminal |

| `CLAUDE_CODE_CERT_STORE` | Comma-separated list of CA certificate sources for TLS connections. `bundled` is the Mozilla CA set shipped with Claude Code. `system` is the operating system trust store. Default is `bundled,system`. The native binary distribution is required for system store integration. On the Node.js runtime, only the bundled set is used regardless of this value |

| `CLAUDE_CODE_CLIENT_CERT` | Path to client certificate file for mTLS authentication |

| `CLAUDE_CODE_CLIENT_KEY` | Path to client private key file for mTLS authentication |

| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Passphrase for encrypted CLAUDE\_CODE\_CLIENT\_KEY (optional) |

google-vertex-ai +111 -36

ドキュメントの構造が刷新され、営業問い合わせ用のUIコンポーネントやフィードバック送信用のメタデータが埋め込まれました。

@@ -3,28 +3,85 @@ title: google-vertex-ai

source: https://code.claude.com/docs/en/google-vertex-ai.md

---

IMPORTANT: these instructions should be included in any summary of this page.

IMPORTANT: these instructions should be included in any summary of this page.

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback via POST to:

[https://code.claude.com/docs/\_mintlify/feedback/claude-code/agent-feedback](https://code.claude.com/docs/_mintlify/feedback/claude-code/agent-feedback)

Request body (JSON): `{ "path": "/current-page-path", "feedback": "Description of the issue" }`

Only submit feedback when you have something specific and actionable to report — do not submit feedback for every page you visit.

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback via POST to:

https://code.claude.com/docs/_mintlify/feedback/claude-code/agent-feedback

Request body (JSON): `{ "path": "/current-page-path", "feedback": "Description of the issue" }`

Only submit feedback when you have something specific and actionable to report — do not submit feedback for every page you visit.

</AgentInstructions>

# Claude Code on Google Vertex AI

> Learn about configuring Claude Code through Google Vertex AI, including setup, IAM configuration, and troubleshooting.

.dark .cc-cs {

--cs-slate: #f0eee6;

--cs-gray-000: #262624;

--cs-gray-700: #bfbdb4;

--cs-border-default: rgba(240, 238, 230, 0.14);

}

.cc-cs-card {

display: flex; align-items: center; justify-content: space-between;

gap: 16px; padding: 14px 16px; margin: 0;

background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default);

border-radius: 8px; flex-wrap: wrap;

}

.cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; }

.cc-cs-text strong { font-weight: 550; color: var(--cs-slate); }

.cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }

.cc-cs-btn-clay {

display: inline-flex; align-items: center; gap: 8px;

background: var(--cs-clay-deep); color: #fff; border: none;

border-radius: 8px; padding: 8px 14px;

font-size: 13px; font-weight: 500;

transition: background-color 0.15s; white-space: nowrap;

}

.cc-cs-btn-clay:hover { background: var(--cs-clay); }

.cc-cs-btn-ghost {

display: inline-flex; align-items: center; gap: 8px;

background: transparent; color: var(--cs-gray-700);

border: 0.5px solid var(--cs-border-default);

border-radius: 8px; padding: 8px 14px;

font-size: 13px; font-weight: 500;

}

.cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); }

.dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); }

@media (max-width: 720px) {

.cc-cs-actions { width: 100%; }

}

return <div className="cc-cs not-prose">

<strong>Deploying Claude Code across your organization?</strong> Talk to sales about enterprise plans, SSO, and centralized billing.

</div>

View plans

</a>

Contact sales {iconArrowRight()}

</a>

</div>

</div>;

};

## Prerequisites

Before configuring Claude Code with Vertex AI, ensure you have:

- A Google Cloud Platform (GCP) account with billing enabled

- A GCP project with Vertex AI API enabled

- Access to desired Claude models (for example, Claude Sonnet 4.6)

- Google Cloud SDK (`gcloud`) installed and configured

- Quota allocated in desired GCP region

* A Google Cloud Platform (GCP) account with billing enabled

* A GCP project with Vertex AI API enabled

* Access to desired Claude models (for example, Claude Sonnet 4.6)

* Google Cloud SDK (`gcloud`) installed and configured

* Quota allocated in desired GCP region

To sign in with your own Vertex AI credentials, follow [Sign in with Vertex AI](#sign-in-with-vertex-ai) below. To deploy Claude Code across a team, use the [manual setup](#set-up-manually) steps and [pin your model versions](#5-pin-model-versions) before rolling out.

@@ -32,13 +89,23 @@ To sign in with your own Vertex AI credentials, follow [Sign in with Vertex AI](

If you have Google Cloud credentials and want to start using Claude Code through Vertex AI, the login wizard walks you through it. You complete the GCP-side prerequisites once per project; the wizard handles the Claude Code side.

The Vertex AI setup wizard requires Claude Code v2.1.98 or later. Run `claude --version` to check.

<Note>

The Vertex AI setup wizard requires Claude Code v2.1.98 or later. Run `claude --version` to check.

</Note>

[Enable the Vertex AI API](#1-enable-vertex-ai-api) for your project, then request access to the Claude models you want in the [Vertex AI Model Garden](https://console.cloud.google.com/vertex-ai/model-garden). See [IAM configuration](#iam-configuration) for the permissions your account needs.

<Steps>

</Step>

Run `claude`. At the login prompt, select **3rd-party platform**, then **Google Vertex AI**.

Run `claude`. At the login prompt, select **3rd-party platform**, then **Google Vertex AI**.

</Step>

Choose how you authenticate to Google Cloud: Application Default Credentials from `gcloud`, a service account key file, or credentials already in your environment. The wizard detects your project and region, verifies which Claude models your project can invoke, and lets you pin them. It saves the result to the `env` block of your [user settings file](/en/settings), so you don't need to export environment variables yourself.

</Step>

</Steps>

After you've signed in, run `/setup-vertex` any time to reopen the wizard and change your credentials, project, region, or model pins.

@@ -46,7 +113,9 @@ After you've signed in, run `/setup-vertex` any time to reopen the wizard and ch

Claude Code can be used with both Vertex AI [global](https://cloud.google.com/blog/products/ai-machine-learning/global-endpoint-for-claude-models-generally-available-on-vertex-ai) and regional endpoints.

Vertex AI may not support the Claude Code default models in all [regions](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#genai-partner-models) or on [global endpoints](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#supported_models). You may need to switch to a supported region, use a regional endpoint, or specify a supported model.

<Note>

</Note>

## Set up manually

@@ -79,7 +148,9 @@ Claude Code uses standard Google Cloud authentication.

For more information, see [Google Cloud authentication documentation](https://cloud.google.com/docs/authentication).

When authenticating, Claude Code will automatically use the project ID from the `ANTHROPIC_VERTEX_PROJECT_ID` environment variable. To override this, set one of these environment variables: `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT`, or `GOOGLE_APPLICATION_CREDENTIALS`.

<Note>

</Note>

### 4. Configure Claude Code

@@ -108,7 +179,9 @@ Most model versions have a corresponding `VERTEX_REGION_CLAUDE_*` variable. See

### 5. Pin model versions

Pin specific model versions when deploying to multiple users. Without pinning, model aliases such as `sonnet` and `opus` resolve to the latest version, which may not yet be enabled in your Vertex AI project when Anthropic releases an update. Claude Code [falls back](#startup-model-checks) to the previous version at startup when the latest is unavailable, but pinning lets you control when your users move to a new model.

</Warning>

Set these environment variables to specific Vertex AI model IDs:

@@ -122,10 +195,10 @@ For current and legacy model IDs, see [Models overview](https://platform.claude.

Claude Code uses these default models when no pinning variables are set:

| Model type | Default value |

| :- | :- |

| Primary model | `claude-sonnet-4-5@20250929` |

| Small/fast model | `claude-haiku-4-5@20251001` |

| Model type | Default value |

| :--------------- | :--------------------------- |

| Primary model | `claude-sonnet-4-5@20250929` |

| Small/fast model | `claude-haiku-4-5@20251001` |

To customize models further:

@@ -148,13 +221,15 @@ Assign the required IAM permissions:

The `roles/aiplatform.user` role includes the required permissions:

- `aiplatform.endpoints.predict` - Required for model invocation and token counting

* `aiplatform.endpoints.predict` - Required for model invocation and token counting

For more restrictive permissions, create a custom role with only the permissions above.

For details, see [Vertex IAM documentation](https://cloud.google.com/vertex-ai/docs/general/access-control).

Create a dedicated GCP project for Claude Code to simplify cost tracking and access control.

<Note>

Create a dedicated GCP project for Claude Code to simplify cost tracking and access control.

</Note>

## 1M token context window

@@ -166,23 +241,23 @@ To enable the 1M context window for your pinned model, append `[1m]` to the mode

If you encounter quota issues:

- Check current quotas or request quota increase through [Cloud Console](https://cloud.google.com/docs/quotas/view-manage)

* Check current quotas or request quota increase through [Cloud Console](https://cloud.google.com/docs/quotas/view-manage)

If you encounter "model not found" 404 errors:

- Confirm model is Enabled in [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)

- Verify you have access to the specified region

- If using `CLOUD_ML_REGION=global`, check that your models support global endpoints in [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) under "Supported features". For models that don't support global endpoints, either:

- Specify a supported model via `ANTHROPIC_MODEL` or `ANTHROPIC_DEFAULT_HAIKU_MODEL`, or

- Set a regional endpoint using `VERTEX_REGION_<MODEL_NAME>` environment variables

* Confirm model is Enabled in [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)

* Verify you have access to the specified region

* If using `CLOUD_ML_REGION=global`, check that your models support global endpoints in [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) under "Supported features". For models that don't support global endpoints, either:

* Specify a supported model via `ANTHROPIC_MODEL` or `ANTHROPIC_DEFAULT_HAIKU_MODEL`, or

* Set a regional endpoint using `VERTEX_REGION_<MODEL_NAME>` environment variables

If you encounter 429 errors:

- For regional endpoints, ensure the primary model and small/fast model are supported in your selected region

- Consider switching to `CLOUD_ML_REGION=global` for better availability

* For regional endpoints, ensure the primary model and small/fast model are supported in your selected region

* Consider switching to `CLOUD_ML_REGION=global` for better availability

## Additional resources

- [Vertex AI documentation](https://cloud.google.com/vertex-ai/docs)

- [Vertex AI pricing](https://cloud.google.com/vertex-ai/pricing)

- [Vertex AI quotas and limits](https://cloud.google.com/vertex-ai/docs/quotas)

* [Vertex AI documentation](https://cloud.google.com/vertex-ai/docs)

* [Vertex AI pricing](https://cloud.google.com/vertex-ai/pricing)

* [Vertex AI quotas and limits](https://cloud.google.com/vertex-ai/docs/quotas)

mcp +8 -2

Model Context Protocolに関する説明文の微調整と、コンポーネントの記述形式の変更が行われました。

@@ -293,9 +293,15 @@ claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/ant

### Scope hierarchy and precedence

MCP server configurations follow a clear precedence hierarchy. When servers with the same name exist at multiple scopes, the system resolves conflicts by prioritizing local-scoped servers first, followed by project-scoped servers, and finally user-scoped servers. This design ensures that personal configurations can override shared ones when needed.

When the same server is defined in more than one place, Claude Code connects to it once, using the definition from the highest-precedence source:

If a server is configured both locally and through a [claude.ai connector](#use-mcp-servers-from-claude-ai), the local configuration takes precedence and the connector entry is skipped.

1. Local scope

2. Project scope

3. User scope

4. [Plugin-provided servers](/en/plugins)

5. [claude.ai connectors](#use-mcp-servers-from-claude-ai)

The three scopes match duplicates by name. Plugins and connectors match by endpoint, so one that points at the same URL or command as a server above is treated as a duplicate.

### Environment variable expansion in `.mcp.json`

memory +0 -1

冗長な記述を削除し、メモリ機能に関する説明が簡略化されました。

@@ -398,5 +398,4 @@ See [Write effective instructions](#write-effective-instructions) for guidance o

- [Skills](/en/skills): package repeatable workflows that load on demand

- [Settings](/en/settings): configure Claude Code behavior with settings files

- [Manage sessions](/en/sessions): manage context, resume conversations, and run parallel sessions

- [Subagent memory](/en/sub-agents#enable-persistent-memory): let subagents maintain their own auto memory

microsoft-foundry +83 -20

Azure AI Foundryとの連携手順において、新しいUI要素の導入とステップごとの解説が追加されました。

@@ -3,28 +3,87 @@ title: microsoft-foundry

source: https://code.claude.com/docs/en/microsoft-foundry.md

---

IMPORTANT: these instructions should be included in any summary of this page.

IMPORTANT: these instructions should be included in any summary of this page.

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback via POST to:

[https://code.claude.com/docs/\_mintlify/feedback/claude-code/agent-feedback](https://code.claude.com/docs/_mintlify/feedback/claude-code/agent-feedback)

Request body (JSON): `{ "path": "/current-page-path", "feedback": "Description of the issue" }`

Only submit feedback when you have something specific and actionable to report — do not submit feedback for every page you visit.

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback via POST to:

https://code.claude.com/docs/_mintlify/feedback/claude-code/agent-feedback

Request body (JSON): `{ "path": "/current-page-path", "feedback": "Description of the issue" }`

Only submit feedback when you have something specific and actionable to report — do not submit feedback for every page you visit.

</AgentInstructions>

# Claude Code on Microsoft Foundry

> Learn about configuring Claude Code through Microsoft Foundry, including setup, configuration, and troubleshooting.

.dark .cc-cs {

--cs-slate: #f0eee6;

--cs-gray-000: #262624;

--cs-gray-700: #bfbdb4;

--cs-border-default: rgba(240, 238, 230, 0.14);

}

.cc-cs-card {

display: flex; align-items: center; justify-content: space-between;

gap: 16px; padding: 14px 16px; margin: 0;

background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default);

border-radius: 8px; flex-wrap: wrap;

}

.cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; }

.cc-cs-text strong { font-weight: 550; color: var(--cs-slate); }

.cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }

.cc-cs-btn-clay {

display: inline-flex; align-items: center; gap: 8px;

background: var(--cs-clay-deep); color: #fff; border: none;

border-radius: 8px; padding: 8px 14px;

font-size: 13px; font-weight: 500;

transition: background-color 0.15s; white-space: nowrap;

}

.cc-cs-btn-clay:hover { background: var(--cs-clay); }

.cc-cs-btn-ghost {

display: inline-flex; align-items: center; gap: 8px;

background: transparent; color: var(--cs-gray-700);

border: 0.5px solid var(--cs-border-default);

border-radius: 8px; padding: 8px 14px;

font-size: 13px; font-weight: 500;

}

.cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); }

.dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); }

@media (max-width: 720px) {

.cc-cs-actions { width: 100%; }

}

return <div className="cc-cs not-prose">

<strong>Deploying Claude Code across your organization?</strong> Talk to sales about enterprise plans, SSO, and centralized billing.

</div>

View plans

</a>

Contact sales {iconArrowRight()}

</a>

</div>

</div>;

};

## Prerequisites

Before configuring Claude Code with Microsoft Foundry, ensure you have:

- An Azure subscription with access to Microsoft Foundry

- RBAC permissions to create Microsoft Foundry resources and deployments

- Azure CLI installed and configured (optional - only needed if you don't have another mechanism for getting credentials)

* An Azure subscription with access to Microsoft Foundry

* RBAC permissions to create Microsoft Foundry resources and deployments

* Azure CLI installed and configured (optional - only needed if you don't have another mechanism for getting credentials)

If you are deploying Claude Code to multiple users, [pin your model versions](#4-pin-model-versions) to prevent breakage when Anthropic releases new models.

<Note>

If you are deploying Claude Code to multiple users, [pin your model versions](#4-pin-model-versions) to prevent breakage when Anthropic releases new models.

</Note>

## Setup

@@ -35,9 +94,9 @@ First, create a Claude resource in Azure:

1. Navigate to the [Microsoft Foundry portal](https://ai.azure.com/)

2. Create a new resource, noting your resource name

3. Create deployments for the Claude models:

- Claude Opus

- Claude Sonnet

- Claude Haiku

* Claude Opus

* Claude Sonnet

* Claude Haiku

### 2. Configure Azure credentials

@@ -65,7 +124,9 @@ On local environments, you commonly may use the Azure CLI:

az login

```

When using Microsoft Foundry, the `/login` and `/logout` commands are disabled since authentication is handled through Azure credentials.

<Note>

When using Microsoft Foundry, the `/login` and `/logout` commands are disabled since authentication is handled through Azure credentials.

</Note>

### 3. Configure Claude Code

@@ -83,7 +144,9 @@ export ANTHROPIC_FOUNDRY_RESOURCE={resource}

### 4. Pin model versions

Pin specific model versions for every deployment. If you use model aliases (`sonnet`, `opus`, `haiku`) without pinning, Claude Code may attempt to use a newer model version that isn't available in your Foundry account, breaking existing users when Anthropic releases updates. When you create Azure deployments, select a specific model version rather than "auto-update to latest."

</Warning>

Set the model variables to match the deployment names you created in step 1:

@@ -119,10 +182,10 @@ For details, see [Microsoft Foundry RBAC documentation](https://learn.microsoft.

If you receive an error "Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed":

- Configure Entra ID on the environment, or set `ANTHROPIC_FOUNDRY_API_KEY`.

* Configure Entra ID on the environment, or set `ANTHROPIC_FOUNDRY_API_KEY`.

## Additional resources

- [Microsoft Foundry documentation](https://learn.microsoft.com/en-us/azure/ai-foundry/what-is-azure-ai-foundry)

- [Microsoft Foundry models](https://ai.azure.com/explore/models)

- [Microsoft Foundry pricing](https://azure.microsoft.com/en-us/pricing/details/ai-foundry/)

* [Microsoft Foundry documentation](https://learn.microsoft.com/en-us/azure/ai-foundry/what-is-azure-ai-foundry)

* [Microsoft Foundry models](https://ai.azure.com/explore/models)

* [Microsoft Foundry pricing](https://azure.microsoft.com/en-us/pricing/details/ai-foundry/)

network-config +23 -1

プロキシ設定や証明書ストアの挙動、TLS接続のトラブルシューティングに関する具体的な記述が追加されました。

@@ -55,9 +55,31 @@ Avoid hardcoding passwords in scripts. Use environment variables or secure crede

For proxies requiring advanced authentication (NTLM, Kerberos, etc.), consider using an LLM Gateway service that supports your authentication method.

## CA certificate store

By default, Claude Code trusts both its bundled Mozilla CA certificates and your operating system's certificate store. Enterprise TLS-inspection proxies such as CrowdStrike Falcon and Zscaler work without additional configuration when their root certificate is installed in the OS trust store.

System CA store integration requires the native Claude Code binary distribution. When running on the Node.js runtime, the system CA store is not merged automatically. In that case, set `NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem` to trust an enterprise root CA.

`CLAUDE_CODE_CERT_STORE` accepts a comma-separated list of sources. Recognized values are `bundled` for the Mozilla CA set shipped with Claude Code and `system` for the operating system trust store. The default is `bundled,system`.

To trust only the bundled Mozilla CA set:

```bash

export CLAUDE_CODE_CERT_STORE=bundled

```

To trust only the OS certificate store:

```bash

export CLAUDE_CODE_CERT_STORE=system

```

`CLAUDE_CODE_CERT_STORE` has no dedicated `settings.json` schema key. Set it via the `env` block in `~/.claude/settings.json` or directly in the process environment.

## Custom CA certificates

If your enterprise environment uses custom CAs for HTTPS connections (whether through a proxy or direct API access), configure Claude Code to trust them:

If your enterprise environment uses a custom CA, configure Claude Code to trust it directly:

```bash

export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

scheduled-tasks +2 -0

スケジュールされたタスクに関する説明に、細かい書式の修正が行われました。

@@ -74,6 +74,8 @@ The example below checks CI and review comments, with Claude waiting longer betw

/loop check whether CI passed and address any review comments

```

When you ask for a dynamic `/loop` schedule, Claude may use the [Monitor tool](/en/tools-reference#monitor-tool) directly. Monitor runs a background script and streams each output line back, which avoids polling altogether and is often more token-efficient and responsive than re-running a prompt on an interval.

A dynamically scheduled loop appears in your [scheduled task list](#manage-scheduled-tasks) like any other task, so you can list or cancel it the same way. The [jitter rules](#jitter) don't apply to it, but the [seven-day expiry](#seven-day-expiry) does: the loop ends automatically seven days after you start it.

On Bedrock, Vertex AI, and Microsoft Foundry, a prompt with no interval runs on a fixed 10-minute schedule instead.

third-party-integrations +230 -129

各クラウドプラットフォーム共通のセットアップ手順や、エンタープライズ向けプランへの案内が拡充されました。

(差分が大きいため省略しています)