convez.ai
Comando
jpvelasco

juggernaut

jpvelasco/juggernaut

Ver no GitHub
BomPluginScore · de 0 a 100

Juggernaut is a one-command setup tool that configures Claude Code to use AWS Bedrock, with cross-platform support (bash/zsh/fish/PowerShell), dry-run mode, and validation scripts.

Instalação

$npx convez-ai jpvelasco/juggernaut

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 4 dias
Versão
v6.6.4
Issues abertas
0
Contribuidores
2

README

A tradução para o português deste README ainda está na fila.

Single cross-platform binary that configures Claude Code to route through Amazon Bedrock instead of Anthropic's direct API — IAM, SSO, or Bedrock API key auth.

Install from npm: juggernaut-bedrock — npm install -g juggernaut-bedrock

Why Bedrock?

FeatureDirect Anthropic APIAmazon Bedrock
BillingSeparate Anthropic accountConsolidated AWS billing
AuthenticationAPI keys onlyIAM, SSO, roles, federation
Data ResidencyAnthropic infrastructureYour chosen AWS region
ComplianceAnthropic's certificationsAWS compliance (SOC, HIPAA, FedRAMP)
NetworkPublic internetVPC endpoints, PrivateLink
GovernanceLimitedIAM policies, CloudTrail, quotas

Install

Via npm (recommended)

Published as juggernaut-bedrock on npm. Works everywhere Claude Code is installed.

npm install -g juggernaut-bedrock

curl (Unix / macOS / Linux / Git Bash / WSL):

curl -fsSL https://raw.githubusercontent.com/jpvelasco/juggernaut/latest/scripts/install.sh | bash

PowerShell (Windows):

irm https://raw.githubusercontent.com/jpvelasco/juggernaut/latest/scripts/install.ps1 | iex

Configure

# IAM / SSO (recommended)
juggernaut apply --auth=iam

# Bedrock API key (stored securely in OS keychain)
juggernaut apply

# Interactive first-run — omit flags for a guided prompt
juggernaut apply

juggernaut apply will not write CLAUDE_CODE_USE_BEDROCK=1 unless a valid credential source is confirmed.

Common options:

juggernaut apply --auth=iam --region=us-east-1
juggernaut apply --auth=iam --opusplan              # Opus in /plan, Sonnet in execute
juggernaut apply --auth=iam --effort=xhigh          # low | medium | high | xhigh | max
juggernaut apply --auth=iam --mode=auto             # enable agentic safety-classifier mode
juggernaut apply --auth=iam --always-thinking       # extended thinking on by default
juggernaut apply --auth=iam --service-tier=flex     # Bedrock service tier: default | flex | priority
juggernaut apply --auth=iam --no-mantle             # disable Mantle routing
juggernaut apply --auth=iam --dry-run               # preview without writing
juggernaut apply --auth=iam --scope=project         # write to ./.claude/settings.json

Launch

claude

Juggernaut installs a claude shim (~/.local/bin/claude on Unix, claude.cmd on Windows) that reads your bearer token from the OS keychain and injects it before launching Claude Code. No manual environment setup required.

Commands

CommandDescription
applyWrite Juggernaut config to settings.json and install the launcher shim.
showPrint the current Juggernaut block from user and project scopes.
doctorRead-only diagnostics — checks block, credentials, launcher shim.
uninstallRemove the Juggernaut block, bearer token, and launcher shim.
migrateMigrate from v3 (shell-based) to v4 (Go). Runs automatically on first apply.
versionPrint the installed version.

Default Models

TierModelGlobal CRIS Profile
PrimaryClaude Sonnet 4.6global.anthropic.claude-sonnet-4-6
OpusClaude Opus 4.8global.anthropic.claude-opus-4-8
Fast / subagentClaude Haiku 4.5global.anthropic.claude-haiku-4-5-20251001-v1:0

Override any tier:

juggernaut apply --auth=iam --opus-model=us.anthropic.claude-opus-4-8
juggernaut apply --auth=iam --model=global.anthropic.claude-sonnet-4-6  # override all

Effort Levels

Controls adaptive thinking depth. Valid for all Claude 4 models on Bedrock.

LevelBehavior
lowMinimal thinking — fastest, lowest cost
mediumModerate thinking
highAlmost always thinks
xhighAlways thinks deeply (default)
maxMaximum thinking — deepest reasoning, highest cost
juggernaut apply --auth=iam --effort=max

On Opus 4.8 and 4.7, only adaptive thinking is supported. Manual thinking mode is rejected by the API.

Permission Modes

Controls how Claude Code handles tool-use approvals. Set with --mode.

ModeBehavior
defaultPrompts for permission on each action (Claude Code default)
acceptEditsAuto-approves file edits and common filesystem commands
planPropose changes only — no execution without explicit approval
autoAgentic safety classifier — auto-approves safe actions, blocks destructive ones
dontAskAuto-deny unless pre-approved via rules
bypassPermissionsSkip all prompts — containers/VMs only
juggernaut apply --auth=iam --mode=auto

Bedrock note: auto mode requires CLAUDE_CODE_ENABLE_AUTO_MODE=1. Juggernaut sets this automatically — no manual env var needed.

What Gets Written

Juggernaut writes only to ~/.claude/settings.json (user scope) or ./.claude/settings.json (project scope). No shell profile modification.

{
  "juggernaut": { "auth": { "mode": "iam", "region": "us-west-2" }, "meta": { ... } },
  "effortLevel": "xhigh",
  "skipWebFetchPreflight": true,
  "permissions": { "defaultMode": "default" },
  "env": {
    "CLAUDE_CODE_USE_BEDROCK": "1",
    "AWS_REGION": "us-west-2",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32768",
    "MAX_THINKING_TOKENS": "65536",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "global.anthropic.claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "global.anthropic.claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "global.anthropic.claude-haiku-4-5-20251001-v1:0",
    "CLAUDE_CODE_EFFORT_LEVEL": "xhigh",
    "ENABLE_PROMPT_CACHING_1H": "1",
    "DISABLE_TELEMETRY": "1"
  }
}

Migrating from v3

If you have a v3 (shell-based) installation, just install v4 and run:

juggernaut migrate

Or simply run juggernaut apply — migration runs automatically on first use when a v3 config is detected. Credentials are transferred, shell launcher blocks are removed from your profiles, and no re-entry of credentials is required.

Minimum supported migration source: v3.2.3. If you're on an older version, upgrade the shell version first:

curl -fsSL https://raw.githubusercontent.com/jpvelasco/juggernaut/v3.2.3/install.sh | bash

The v3 shell-based release is preserved on the legacy/v3 branch and tagged v3.2.3. All v3 install URLs continue to work.

IAM Permissions

{
  "Effect": "Allow",
  "Action": [
    "bedrock:InvokeModel",
    "bedrock:InvokeModelWithResponseStream",
    "bedrock:ListInferenceProfiles"
  ],
  "Resource": "*"
}

See iam-policy.json for the complete policy. For tighter security, restrict the resource to specific regions.

Uninstall

# Remove config and launcher shim
juggernaut uninstall

# Preview first
juggernaut uninstall --dry-run

# Remove everything including the shim binary
juggernaut uninstall --full

Troubleshooting

403 Access Denied — Complete the Anthropic model access request in the AWS Bedrock console.

Model not found — Use global inference profile IDs (Juggernaut does this by default).

Keychain unavailable on headless Linux — IAM auth works without a keychain. For Bedrock API key auth, use --storage=profile to store in a local file instead.

SSO session expired — aws sso login --profile=<your-profile> and re-run claude.

juggernaut doctor — always the first diagnostic step.

Notes

  • /login and /logout are disabled when using Bedrock
  • AWS_REGION is set explicitly by Juggernaut (Claude Code does not read it from ~/.aws/config)
  • Juggernaut is an independent tool, not affiliated with Anthropic or Amazon Web Services
Ver o original no GitHub

Bom para

Relacionados