From c82aeb4041f9aed1ea0f7dc121644144b66ee771 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Fri, 27 Feb 2026 09:38:48 +0000
Subject: [PATCH] Update Claude Code Bedrock configuration for proper Portkey
 integration

Generated-By: mintlify-agent
---
 .../libraries/claude-code-bedrock.mdx         | 57 ++++++++-----------
 1 file changed, 25 insertions(+), 32 deletions(-)

diff --git a/integrations/libraries/claude-code-bedrock.mdx b/integrations/libraries/claude-code-bedrock.mdx
index da345fe4..52cc398b 100644
--- a/integrations/libraries/claude-code-bedrock.mdx
+++ b/integrations/libraries/claude-code-bedrock.mdx
@@ -45,12 +45,13 @@ Edit `~/.claude/settings.json` (user-level) or `.claude/settings.json` (project-
 ```json
 {
   "env": {
-    "ANTHROPIC_BASE_URL": "https://api.portkey.ai",
-    "ANTHROPIC_AUTH_TOKEN": "YOUR_PORTKEY_API_KEY",
+    "ANTHROPIC_BEDROCK_BASE_URL": "https://api.portkey.ai/v1",
     "ANTHROPIC_CUSTOM_HEADERS": "x-portkey-api-key: YOUR_PORTKEY_API_KEY\nx-portkey-provider: @bedrock-prod",
     "ANTHROPIC_DEFAULT_SONNET_MODEL": "us.anthropic.claude-sonnet-4-20250514-v1:0",
     "ANTHROPIC_DEFAULT_OPUS_MODEL": "us.anthropic.claude-opus-4-20250514-v1:0",
-    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "us.anthropic.claude-haiku-4-20250514-v1:0"
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "us.anthropic.claude-haiku-4-20250514-v1:0",
+    "CLAUDE_CODE_USE_BEDROCK": 1,
+    "CLAUDE_CODE_SKIP_BEDROCK_AUTH": 1
   },
   "model": "us.anthropic.claude-sonnet-4-20250514-v1:0"
 }
@@ -98,9 +99,10 @@ Add the config to your settings:
 ```json
 {
   "env": {
-    "ANTHROPIC_BASE_URL": "https://api.portkey.ai",
-    "ANTHROPIC_AUTH_TOKEN": "YOUR_PORTKEY_API_KEY",
-    "ANTHROPIC_CUSTOM_HEADERS": "x-portkey-api-key: YOUR_PORTKEY_API_KEY\nx-portkey-config: YOUR_CONFIG_ID"
+    "ANTHROPIC_BEDROCK_BASE_URL": "https://api.portkey.ai/v1",
+    "ANTHROPIC_CUSTOM_HEADERS": "x-portkey-api-key: YOUR_PORTKEY_API_KEY\nx-portkey-config: YOUR_CONFIG_ID",
+    "CLAUDE_CODE_USE_BEDROCK": 1,
+    "CLAUDE_CODE_SKIP_BEDROCK_AUTH": 1
   }
 }
 ```
@@ -114,9 +116,10 @@ Add trace IDs to group and debug requests in the Portkey Dashboard:
 ```json
 {
   "env": {
-    "ANTHROPIC_BASE_URL": "https://api.portkey.ai",
-    "ANTHROPIC_AUTH_TOKEN": "YOUR_PORTKEY_API_KEY",
-    "ANTHROPIC_CUSTOM_HEADERS": "x-portkey-api-key: YOUR_PORTKEY_API_KEY\nx-portkey-provider: @bedrock-prod\nx-portkey-trace-id: claude-code-session-123"
+    "ANTHROPIC_BEDROCK_BASE_URL": "https://api.portkey.ai/v1",
+    "ANTHROPIC_CUSTOM_HEADERS": "x-portkey-api-key: YOUR_PORTKEY_API_KEY\nx-portkey-provider: @bedrock-prod\nx-portkey-trace-id: claude-code-session-123",
+    "CLAUDE_CODE_USE_BEDROCK": 1,
+    "CLAUDE_CODE_SKIP_BEDROCK_AUTH": 1
   }
 }
 ```
@@ -202,43 +205,32 @@ Budget limits prevent runaway costs from agentic coding sessions.
 
 ## Troubleshooting
 
-### Error: `API Error: 500 Message: fetch failed`
+### Error: `invalid beta flag`
 
-**Cause:** Using the wrong base URL or environment variables.
+**Cause:** Missing required environment variables for Bedrock mode.
 
-**Fix:** Ensure you're using:
-- `ANTHROPIC_BASE_URL` (not `ANTHROPIC_BEDROCK_BASE_URL`)
-- `https://api.portkey.ai` (not `https://api.portkey.ai/v1`)
+**Fix:** Ensure you have all required environment variables set:
 
-❌ **Wrong:**
 ```json
 {
   "env": {
     "ANTHROPIC_BEDROCK_BASE_URL": "https://api.portkey.ai/v1",
-    "CLAUDE_CODE_USE_BEDROCK": "1"
+    "ANTHROPIC_CUSTOM_HEADERS": "x-portkey-api-key: YOUR_PORTKEY_API_KEY\nx-portkey-provider: @bedrock-prod",
+    "CLAUDE_CODE_USE_BEDROCK": 1,
+    "CLAUDE_CODE_SKIP_BEDROCK_AUTH": 1
   }
 }
 ```
 
-✅ **Correct:**
-```json
-{
-  "env": {
-    "ANTHROPIC_BASE_URL": "https://api.portkey.ai",
-    "ANTHROPIC_AUTH_TOKEN": "YOUR_PORTKEY_API_KEY",
-    "ANTHROPIC_CUSTOM_HEADERS": "x-portkey-api-key: YOUR_PORTKEY_API_KEY\nx-portkey-provider: @bedrock-prod"
-  }
-}
-```
+Both `CLAUDE_CODE_USE_BEDROCK` and `CLAUDE_CODE_SKIP_BEDROCK_AUTH` are required when using Portkey with Bedrock.
 
 ### Lightning Symbol (⚡) in Logs
 
 **Cause:** Requests are going through as passthrough, meaning Portkey isn't handling them properly.
 
 **Fix:** 
-1. Remove `/v1` from the base URL — use `https://api.portkey.ai`
-2. Ensure `x-portkey-provider` or `x-portkey-config` is set in headers
-3. Verify your Portkey API key is correct
+1. Ensure `x-portkey-provider` or `x-portkey-config` is set in headers
+2. Verify your Portkey API key is correct
 
 ### Claude Code Version Issues
 
@@ -261,12 +253,13 @@ Full configuration with all features enabled:
 ```json
 {
   "env": {
-    "ANTHROPIC_BASE_URL": "https://api.portkey.ai",
-    "ANTHROPIC_AUTH_TOKEN": "YOUR_PORTKEY_API_KEY",
+    "ANTHROPIC_BEDROCK_BASE_URL": "https://api.portkey.ai/v1",
     "ANTHROPIC_CUSTOM_HEADERS": "x-portkey-api-key: YOUR_PORTKEY_API_KEY\nx-portkey-config: YOUR_CONFIG_ID\nx-portkey-trace-id: my-project",
     "ANTHROPIC_DEFAULT_SONNET_MODEL": "us.anthropic.claude-sonnet-4-20250514-v1:0",
     "ANTHROPIC_DEFAULT_OPUS_MODEL": "us.anthropic.claude-opus-4-20250514-v1:0",
-    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "us.anthropic.claude-haiku-4-20250514-v1:0"
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "us.anthropic.claude-haiku-4-20250514-v1:0",
+    "CLAUDE_CODE_USE_BEDROCK": 1,
+    "CLAUDE_CODE_SKIP_BEDROCK_AUTH": 1
   },
   "model": "us.anthropic.claude-sonnet-4-20250514-v1:0"
 }