Skip to content

Commit 844fd65

Browse files
suryaiyer95claude
andcommitted
docs: address PR review comments on Bedrock docs
- Fix CLI auth command: `altimate-code auth login --provider amazon-bedrock` - Clarify cross-region prefixing is conditional on model family + region - Add "Models prefixed" column to region prefix table - Fix backwards "unprefixed ID" guidance with accurate pass-through behavior - Add warning about no option to disable auto-prefixing - Fix log line format to match actual `service=config loading config from ...` - Remove ambiguous "provide credentials directly" wording - Fix Provider Options Reference: `options.region/profile/baseURL` not top-level Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 66643b1 commit 844fd65

2 files changed

Lines changed: 24 additions & 17 deletions

File tree

docs/docs/configure/bedrock-custom-endpoints.md

Lines changed: 20 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ You need one of the following:
3434
```
3535

3636
!!! tip
37-
If your organization uses the Altimate Code TUI, you can store the token via `altimate-code auth amazon-bedrock` instead of exporting it in your shell profile.
37+
If your organization uses the Altimate Code TUI, you can store the token via `altimate-code auth login --provider amazon-bedrock` instead of exporting it in your shell profile.
3838

3939
=== "AWS Credential Chain"
4040

@@ -107,27 +107,34 @@ The status bar should display your selected model under Amazon Bedrock.
107107

108108
## Cross-region model ID prefixing
109109

110-
Altimate Code automatically prepends a region prefix to model IDs for cross-region inference. For example, with `region: "us-east-1"` the model ID `anthropic.claude-sonnet-4-6-v1` is sent to the gateway as `us.anthropic.claude-sonnet-4-6-v1`.
110+
Altimate Code may prepend a region prefix to model IDs for cross-region inference when the selected model and region require it. For example, with `region: "us-east-1"` the model ID `anthropic.claude-sonnet-4-6-v1` is sent to the gateway as `us.anthropic.claude-sonnet-4-6-v1`.
111111

112-
| Your region | Prefix applied |
113-
|-------------|---------------|
114-
| `us-*` (except GovCloud) | `us.` |
115-
| `eu-*` | `eu.` |
116-
| `ap-northeast-1` (Tokyo) | `jp.` |
117-
| `ap-southeast-2`, `ap-southeast-4` (Australia) | `au.` |
118-
| Other `ap-*` | `apac.` |
112+
Prefixing is conditional on **both** the region and the model family:
119113

120-
**If your gateway expects the prefixed ID** (e.g., `us.anthropic.claude-sonnet-4-6-v1`), no changes are needed — this is the default behavior.
114+
| Your region | Prefix | Models prefixed |
115+
|-------------|--------|-----------------|
116+
| `us-*` (except GovCloud) | `us.` | Claude, Nova, DeepSeek |
117+
| `eu-*` | `eu.` | Claude, Nova Lite/Micro, Llama 3, Pixtral |
118+
| `ap-northeast-1` (Tokyo) | `jp.` | Claude, Nova Lite/Micro/Pro |
119+
| `ap-southeast-2`, `ap-southeast-4` (Australia) | `au.` | Claude Sonnet 4.5, Claude Haiku |
120+
| Other `ap-*` | `apac.` | Claude, Nova Lite/Micro/Pro |
121121

122-
**If your gateway expects the unprefixed ID**, include the prefix in the model name yourself to skip auto-prefixing:
122+
Models not listed in the table for a given region are **not** prefixed.
123+
124+
**If your gateway expects the prefixed ID** (e.g., `us.anthropic.claude-sonnet-4-6-v1`), no changes are needed — this is the default behavior for supported models.
125+
126+
**If your gateway handles routing independently and expects the bare model ID**, you can force a specific model ID by including a recognized prefix yourself:
123127

124128
```json
125129
{
126130
"model": "amazon-bedrock/us.anthropic.claude-sonnet-4-6-v1"
127131
}
128132
```
129133

130-
When the model ID already starts with a recognized prefix (`us.`, `eu.`, `global.`, `jp.`, `apac.`, `au.`), auto-prefixing is skipped and the ID is passed through as-is.
134+
When the model ID already starts with a recognized prefix (`us.`, `eu.`, `global.`, `jp.`, `apac.`, `au.`), auto-prefixing is skipped and the ID is passed through as-is. Note that this does **not** strip the prefix — the full prefixed ID is what gets sent to the gateway.
135+
136+
!!! warning
137+
There is currently no config option to disable auto-prefixing entirely. If your gateway requires bare (unprefixed) model IDs and the model would normally be prefixed, contact your platform team or open an issue.
131138

132139
## Troubleshooting
133140

@@ -145,7 +152,7 @@ Look for these lines in the logs (`~/.local/share/altimate-code/log/*.log`):
145152

146153
| Log line | Meaning |
147154
|----------|---------|
148-
| `service=config path=...altimate-code.json loading` | Config file is being read |
155+
| `service=config loading config from ...altimate-code.json` | Config file is being read |
149156
| `service=provider providerID=amazon-bedrock found` | Provider detected successfully |
150157
| `service=provider providerID=amazon-bedrock` + error | Auth or endpoint failure |
151158

docs/docs/configure/providers.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ Available models: `claude-opus-4-6`, `claude-sonnet-4-6`, `claude-haiku-4-5-2025
8484
}
8585
```
8686

87-
Uses the standard AWS credential chain. Set `AWS_PROFILE` or provide credentials directly.
87+
Uses the standard AWS credential chain: environment variables (`AWS_ACCESS_KEY_ID`/`AWS_SECRET_ACCESS_KEY`), named profiles (`AWS_PROFILE`), SSO sessions, IAM roles, and container credentials.
8888

8989
!!! note
9090
If you have AWS SSO, IAM roles, or environment credentials (`AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`) configured, Bedrock will use your default credential chain automatically.
@@ -330,8 +330,8 @@ The `small_model` is used for lightweight tasks like summarization and context c
330330
| `baseURL` | `string` | Custom API endpoint URL |
331331
| `api` | `string` | API type (e.g., `"openai"` for compatible endpoints) |
332332
| `headers` | `object` | Custom HTTP headers to include with requests |
333-
| `region` | `string` | AWS region (Bedrock only) |
334-
| `accessKeyId` | `string` | AWS access key (Bedrock only) |
335-
| `secretAccessKey` | `string` | AWS secret key (Bedrock only) |
333+
| `options.region` | `string` | AWS region (Amazon Bedrock only, default: `us-east-1`) |
334+
| `options.profile` | `string` | AWS named profile (Amazon Bedrock only) |
335+
| `options.baseURL` | `string` | Custom endpoint URL for Bedrock gateway/proxy (Amazon Bedrock only) |
336336
| `project` | `string` | GCP project ID (Google Vertex AI only) |
337337
| `location` | `string` | GCP region (Google Vertex AI only, default: `us-central1`) |

0 commit comments

Comments
 (0)