Skip to content

docs: make Bedrock configuration optional for Claude Code (#428)#436

Open
aadil79 wants to merge 2 commits into
awslabs:v2from
aadil79:docs/428-bedrock-optional
Open

docs: make Bedrock configuration optional for Claude Code (#428)#436
aadil79 wants to merge 2 commits into
awslabs:v2from
aadil79:docs/428-bedrock-optional

Conversation

@aadil79

@aadil79 aadil79 commented Jun 26, 2026

Copy link
Copy Markdown

Default settings.json now works with plain Claude Code (direct Anthropic API) without Bedrock-specific env vars. Bedrock config moved to an optional section in the README with copy-paste env block.

Fixes #428

Summary

Default settings.json for the Claude harness now works with plain Claude Code (direct Anthropic API) without
requiring Bedrock configuration.

Changes

  • Removed Bedrock-specific env vars (CLAUDE_CODE_USE_BEDROCK, AWS_REGION, model IDs) from default
    harness/claude/settings.json
  • Changed default model from opus[1m] (Bedrock format) to opus
  • Updated README: Bedrock setup moved to an optional collapsible section with copy-paste env block
  • Updated general prereqs language to clarify Bedrock is optional for Claude Code

User experience

Before:

Users running plain Claude Code (direct Anthropic API) would hit API errors immediately on first run because
settings.json ships with CLAUDE_CODE_USE_BEDROCK=1 and Bedrock-specific model IDs baked in. The only workaround
was manually editing settings.json to remove these env vars — but the README didn't explain this, making it look
like Bedrock was a hard requirement.

/aidlc --doctor
✻ API error · Retrying in 0s · attempt 4/10

After:

settings.json works out of the box with plain Claude Code — no Bedrock setup needed. Users who want Bedrock can
opt in by adding the env vars from a clearly documented optional section in the README. Both paths work; neither
is broken by default.

Checklist

If your change doesn't seem to apply, please leave them unchecked.

  • I have reviewed the contributing guidelines
  • I have performed a self-review of this change
  • Changes have been tested
  • Changes are documented

Test Plan

bun scripts/package.ts --check passes (all harnesses in sync)

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of the project license.

Default settings.json now works with plain Claude Code (direct
Anthropic API) without Bedrock-specific env vars. Bedrock config
moved to an optional section in the README with copy-paste env block.

Fixes awslabs#428
@aadil79 aadil79 force-pushed the docs/428-bedrock-optional branch from 6a29802 to ca66d15 Compare June 26, 2026 01:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant