news 2026/9/12 18:22:15

如何用 OpenClaude 接入 AWS Bedrock 并安装对应的可选 provider 包?

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
如何用 OpenClaude 接入 AWS Bedrock 并安装对应的可选 provider 包?

如何用 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/credentialsnpm 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

验证接入是否生效

文档给出的验证与排错手段:

  1. 缺失包提示:如果启用 Bedrock 时某个可选包没装,CLI 会打印确切缺失的npm install <pkg>提示,按提示补装(全局安装加-g)后重试。
  2. 诊断报告:用 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),仅供参考

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/9/12 18:21:26

OmniRoute 卸载完全指南:内置脚本、手动清理与数据目录详解

OmniRoute 卸载完全指南&#xff1a;内置脚本、手动清理与数据目录详解 【免费下载链接】OmniRoute Never stop coding. Free MIT AI gateway: one endpoint, 352 providers (150 free), 1200 models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Co…

作者头像 李华
网站建设 2026/9/12 18:20:44

大一参加电赛值不值?备赛、实战与避坑全攻略

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/9/12 18:20:11

RNA-seq变异检测实战:Sentieon全流程详解

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/9/12 18:20:04

C++模板编程:从基础到实践

1. C模板基础概念模板是C语言中最强大的特性之一&#xff0c;它允许我们编写与数据类型无关的通用代码。我第一次接触模板时&#xff0c;就被它的这种"一次编写&#xff0c;多处使用"的特性深深吸引。简单来说&#xff0c;模板就像是一个模具&#xff0c;我们可以用它…

作者头像 李华
网站建设 2026/9/12 18:19:44

企业微信二次开发:群成员生命周期事件如何统一管理

前阵子我们在做私域业务的季度复盘&#xff0c;运营总监指着报表上一堆变成了“未知状态”的客户名单发飙。深挖系统底层代码才发现&#xff0c;群成员的进进出出&#xff0c;在业务库里根本没有形成闭环。新人进群欢迎语漏发&#xff0c;客户自己默默退群了&#xff0c;系统还…

作者头像 李华