如何用 OpenClaude 接入 AWS Bedrock 并安装对应的可选 provider 包?
【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude
如果你已经通过 npm 全局安装了 OpenClaude,想改用 AWS Bedrock 作为模型提供方,会碰到两件事:Bedrock 属于 Anthropic 家族的专用云路由,需要用环境变量显式启用;同时 Bedrock 的 SDK 不在默认安装里,按需加载时还得手动装对应的可选 provider 包。这篇文章按 docs/advanced-setup.md 和 .env.example 给出的步骤,完成从安装包、配置凭证到启动验证的完整接入路径。适用前提是 Node.js>=22.0.0(npm 安装和运行时的要求)。
安装 Bedrock 可选 provider 包
OpenClaude 的默认npm install -g @gitlawb/openclaude安装保持精简,部分 provider SDK 不随包捆绑。启用某个功能而对应包缺失时,CLI 会打印一条npm install <pkg>提示(全局 CLI 场景加-g),并在遇到缺失时直接打印具体缺哪个包。按需安装即可:
# Bedrock 路由(触发条件:CLAUDE_CODE_USE_BEDROCK=1)的最小依赖 npm i -g @anthropic-ai/bedrock-sdk按你的认证与使用方式,可能还需要追加这些包(引自 docs/advanced-setup.md 的 Optional provider packages 表):
| 使用场景 | 额外安装 |
|---|---|
Profile-based auth(读取~/.aws/credentials) | npm i -g @aws-sdk/credential-providers @aws-sdk/client-sts |
| 模型列表(model listing) | npm i -g @aws-sdk/client-bedrock |
| Proxy / skip-auth 配置 | 可能还需要@aws-sdk/credential-provider-node、@smithy/node-http-handler或@smithy/core,CLI 遇到缺失时会打印确切包名 |
如果你是从源码构建(bun install),这些依赖已经以 dev dependencies 形式存在,不需要额外步骤。
配置 Bedrock 环境变量
.env.example 的 Option 7(AWS Bedrock)给出了这组变量,示例中 region 为us-east-1:
# Bedrock 路由开关 export CLAUDE_CODE_USE_BEDROCK=1 # 按你实际使用的 AWS region 替换(.env.example 示例值为 us-east-1) export AWS_REGION=us-east-1 export AWS_DEFAULT_REGION=us-east-1 # 替换为你自己的 Bedrock bearer token export AWS_BEARER_TOKEN_BEDROCK=your-bearer-token-here # 按 region 替换 endpoint(.env.example 示例值为 us-east-1) export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com.env.example对该组变量标注了 “may also need:aws configure”。如果你走 profile-based auth(即用~/.aws/credentials里的凭证而不是 bearer token),先完成aws configure配置本地凭证文件,并按上一节追加安装@aws-sdk/credential-providers与@aws-sdk/client-sts。
启动并选择模型
对 Bedrock、Vertex、Foundry 这类手动启动的路由,模型不用环境变量指定(ANTHROPIC_MODEL/OPENAI_MODEL/GEMINI_MODEL/MISTRAL_MODEL都只对应各自的路由),而是通过--model参数选择:
# 将 <MODEL_ID> 替换为你要使用的 Bedrock 模型标识 openclaude --model <MODEL_ID>如果想在会话内切换或查看模型,还可以使用交互式的/model;需要列出 Bedrock 可用模型时确保已安装@aws-sdk/client-bedrock。
验证接入是否生效
文档给出的验证与排错手段:
- 缺失包提示:如果启用 Bedrock 时某个可选包没装,CLI 会打印确切缺失的
npm install <pkg>提示,按提示补装(全局安装加-g)后重试。 - 诊断报告:用 docs/advanced-setup.md Runtime Hardening 一节提供的报告命令核对 provider/运行时/构建/设置状态:
# 打印脱敏的 Markdown 问题报告 openclaude doctor report --markdown该报告默认脱敏,汇总 provider、运行时、构建和设置状态,不含提示词、原始配置或 API key。
限制与注意事项
- 只有 npm 全局安装需要额外装可选包;源码构建(
bun install)已经包含这些依赖。 - Bedrock 是专用 Anthropic 路由,不要按 OpenAI-compatible 路由的方式配置(即不要靠
CLAUDE_CODE_USE_OPENAI=1走 Bedrock)。 - 设置
CLAUDE_CODE_USE_BEDROCK=1但未装@anthropic-ai/bedrock-sdk时,功能无法按需加载,按 CLI 提示补装即可。 - 如需进一步理解各路由的分类,可参考 docs/integrations/overview.md 与 README.md 中 Bedrock / Vertex / Foundry 属于 env vars 驱动的 Anthropic 家族云路由这一行说明。
【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考