在终端中用 aider 连接 Amazon Bedrock：从 AWS 凭证配置到 Claude 模型调用完整指南

在终端中用 aider 连接 Amazon Bedrock从 AWS 凭证配置到 Claude 模型调用完整指南【免费下载链接】aideraider is AI pair programming in your terminal项目地址: https://gitcode.com/GitHub_Trending/ai/aider本文基于 aider 官方文档与仓库源码系统讲解如何让 aider终端里的 AI 结对编程助手接入 Amazon Bedrock 托管的模型如 Anthropic Claude 系列。你将掌握从 AWS 控制台启用模型、定位 Model ID / Inference Profile ID到用 AWS CLI、环境变量或.env文件配置凭证再到用--model bedrock/...启动并排查常见依赖与报错的完整链路。一、接入前提与整体思路Aider 本身不直接调用 Bedrock而是依赖 LiteLLM 这一中间层将请求统一路由到各家大模型厂商。对于 AWS 侧Bedrock 作为托管服务要求调用方具备合法的 AWS 身份凭证对于本地侧aider 需要能识别出bedrock/前缀的模型名并携带凭证完成鉴权与调用。仓库中对该能力的落地可以追溯到两处源码证据aider/models.py 中check_for_dependencies()专门识别bedrock/开头的模型名并提示安装boto3AWS 官方 Python SDKaider/resources/model-settings.yml 中为大量 Bedrock 托管模型注册了编辑格式、弱模型weak model、编辑器模型等行为参数说明 aider 对 Bedrock 模型是一等公民级别的支持而非临时拼接。因此接入 Bedrock 的完整流程可以归纳为四步开通并启用模型 → 拿到模型标识 → 配置 AWS 凭证 → 用--model启动 aider。二、从 Amazon Bedrock 选择一个模型2.1 先到 Model Access 启用模型在通过 Bedrock 调用任何模型之前必须先在AWS Management Console的Model Access模型访问页面把目标模型启用。未启用模型的账户直接发起调用通常会收到 AccessDenied 类型的错误。启用完成后为了拿到 Aider 真正需要的模型标识需要进入 Bedrock 控制台的Model Catalog模型目录区域选择你打算使用的模型查看页面中 Usage 标题下的modelId属性该modelId就是调用时使用的模型名例如anthropic.claude-3-5-sonnet-20240620-v1:0。2.2 认识 Inference Profile跨区域推理配置Amazon Bedrock 后来引入了 cross-region inference profiles跨区域推理配置部分新模型只支持通过这类推理配置来访问并不接受普通 Model ID。如果遇到这种情况需要在启动时使用Inference Profile ID而不是 Model Catalog 页面里的Model ID。官方文档给出的典型例子是 2025 年 2 月发布的 Claude Sonnet 3.7它只支持走 inference profiles需要使用的标识形如us.anthropic.claude-3-7-sonnet-20250219-v1:0在 Bedrock 控制台进入Inference and Assessment ➡️ Cross-region Inference即可找到对应的Inference Profile ID值。如果拿只支持 inference profile 的模型却错误地填入了它的普通 Model ID会收到类似下面的报错这也是文档中记录的典型报错形态litellm.BadRequestError: BedrockException - b{message:Invocation of model ID anthropic.claude-3-7-sonnet-20250219-v1:0 with on-demand throughput isnt supported. Retry your request with the ID or ARN of an inference profile that contains this model.}从仓库的模型注册表可以看到aider 同时兼容了这两种标识的写法。以 aider/resources/model-settings.yml 为例Claude 3.7 Sonnet 就有多组并存的条目bedrock/anthropic.claude-3-7-sonnet-20250219-v1:0按普通模型、bedrock/us.anthropic.claude-3-7-sonnet-20250219-v1:0按跨区域 Profile甚至还提供bedrock_converse/前缀以切换到底层的 Bedrock Converse API。三、安装 aider安装步骤与常规使用完全一致官方推荐的做法都收录在安装页面中可参考 aider 安装指南。无论你最终采用pipx install aider-chat、uv tool install aider-chat还是aider-install脚本后面所有 Bedrock 相关的启动命令都通用。四、配置 AWS 凭证两种方式要让 Bedrock 调用成功必须先让 SDK 拿到合法的 AWS 凭证。官方文档提供了两种主推方式AWS CLI 配置与环境变量。4.1 方式一AWS CLI 配置如果你还没有安装 AWS CLI请先安装它然后执行aws configure它会交互式地提示你依次输入AWS Access Key IDSecret Access Key默认 regiondefault region完成后凭证会写入本地~/.aws配置后续 aider 通过 boto3/botocore 的默认凭证链即可读取。4.2 方式二环境变量也可以直接设置环境变量适合 CI、容器或不想落盘凭证的场景export AWS_REGIONyour_preferred_region # 用户凭证认证 export AWS_ACCESS_KEY_IDyour_access_key export AWS_SECRET_ACCESS_KEYyour_secret_key # Profile 认证使用 ~/.aws/credentials 或 ~/.aws/config 中已有的命名 profile export AWS_PROFILEyour-profile其中AWS_PROFILE是重要的补充形态很多企业账号用 IAM Role 命名 Profile常配合aws sso login而不是明文 Access Key。aider 对这种用法有专门支持见下文源码侧对 AWS_PROFILE 的支持。这些变量还可以写入 aider 的 .env 配置文件这样无需每次启动都手动 export。aider 会在家目录、git 仓库根目录、当前目录逐级寻找.env并自动加载也可以直接用--env-file指定路径。仓库也提供了可直接参考的完整模板aider/website/assets/sample.env。4.3 PowerShell 用户的环境变量设置如果你在 macOS、Linux 或 Windows 上使用 PowerShell可以按如下方式设置同样的环境变量$env:AWS_ACCESS_KEY_ID your_access_key $env:AWS_SECRET_ACCESS_KEY your_secret_key $env:AWS_REGION us-west-2 # 换成任何 Bedrock 服务支持的 region4.4 源码侧对 AWS_PROFILE 的支持文档里提到可用AWS_PROFILE认证仓库源码进一步印证了这是一条被刻意设计的路径。在 aider/models.py 的validate_environment()中首先调用 LiteLLM 的litellm.validate_environment(model)检查凭证若返回的缺失列表里包含AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY但模型名以bedrock/或us.anthropic.开头且当前环境中设置了AWS_PROFILEaider 会认为凭证已经通过命名 Profile 提供了从而把这两个 key 从missing_keys中剔除。对应地tests/basic/test_aws_credentials.py 覆盖了完整的场景矩阵带 AWS_PROFILE 的 Bedrock 模型判定为鉴权通过、us.anthropic.前缀模型同样通过、普通模型如 gpt-4不享受该豁免、无 AWS_PROFILE 的 Bedrock 模型仍要求显式凭证并且其他缺失 key 不会被误剔除。这从测试层保证了SSO / 命名 Profile 用户也能顺畅使用 Bedrock 模型这一体验。五、用--model启动并指定 Bedrock 模型凭证就绪后进入你的代码仓库目录用--model指定想要调用的 Bedrock 模型即可# 切换到你的代码库目录 cd /to/your/project aider --model bedrock/anthropic.claude-3-5-sonnet-20240620-v1:0针对某些跨区域或特定部署形态官方文档还建议把模型名前缀加上 us. 有时会有帮助即把anthropic.换成us.anthropic.这类带区域/Profile 前缀的写法aider --model bedrock/us.anthropic.claude-3-5-sonnet-20240620-v1:05.1 查看当前可用的 Bedrock 模型清单想知道自己的 aider 具体支持哪些 Bedrock 模型直接运行aider --list-models bedrock/该命令会输出以bedrock/开头的模型列表。需要特别提醒的是列表只是可识别的模型集合并不代表你的 AWS 账户已被授权调用——请务必先在 Bedrock 控制台启用这些模型否则实际调用仍会被 AWS 拒绝。从模型注册表 aider/resources/model-settings.yml 可以看到当前仓库为 Bedrock 模型做了相当细的建模。以 Claude 3.7 Sonnet / Sonnet 4 等条目为例每条通常包含edit_format: diffaider 采用 diff 格式让模型产出编辑weak_model_name指定用于生成提交信息、聊天历史摘要的弱模型通常是更便宜的 Haikueditor_model_name与editor_edit_format编辑器任务所用模型及其编辑格式extra_params携带anthropic-beta: prompt-caching-2024-07-31,pdfs-2024-09-25,output-128k-2025-02-19等头部并预设max_tokenscache_control: true启用提示词缓存控制accepts_settings: [thinking_tokens]声明该模型接受 thinking tokens 这类参数。也就是说只要模型名匹配aider 会自动套用以上全套工程化设定你通常只需关注--model一个参数。六、安装 boto3 依赖Bedrock 调用链路需要 AWS 官方 Python SDKboto3。如果你的安装环境里还没有它aider 在启动时也会主动检测并提示安装——对应源码就是 aider/models.py 的check_for_dependencies()一旦模型名以bedrock/开头就提示 AWS Bedrock models require the boto3 package 并引导补装tests/basic/test_models.py 中也有对应测试。按不同安装方式手动补装命令如下# 如果使用 aider-install 或 uv tool 方式安装 uv tool run --from aider-chat pip install boto3 # 或者使用 pipx pipx inject aider-chat boto3 # 或者使用 pip pip install -U boto3七、Bedrock 接入速查表事项命令 / 取值说明启用模型AWS 控制台 → Bedrock → Model Access未启用会调用失败查 Model IDModel Catalog → Usage →modelId常规模型用这个查 Inference Profile IDInference and Assessment → Cross-region Inference仅支持 Profile 的模型如 Claude 3.7 Sonnet必须用这个交互式凭证aws configure写入 Access Key / Secret / Region环境变量AWS_REGION、AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_PROFILE也可放入 .env 文件启动示例aider --model bedrock/anthropic.claude-3-5-sonnet-20240620-v1:0必要时给模型名加us.前缀列出模型aider --list-models bedrock/需确认账户已授权补装 SDKpipx inject aider-chat boto3等缺失时 aider 会自动提示八、常见问题与排查要点模型未启用先到 Bedrock Model Access 页面确认目标模型状态为 Access granted。Model ID 与 Inference Profile 混用报错信息中包含 Invocation of model ID ... with on-demand throughput isnt supported 时说明该模型只支持 Inference Profile请改用us./ 区域前缀对应的 Profile ID。凭证缺失报错确认AWS_REGION指向 Bedrock 支持的区域且AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY或AWS_PROFILE已正确设置使用命名 Profile 时可参考仓库 AWS 凭证测试用例 理解 aider 的判定规则。提示缺少 boto3按上文第六节的安装方式补装或直接重装 aider 以让其携带完整依赖。模型可用性差异Bedrock 各模型按区域分批上线具体可用性与标识请以 AWS 控制台当前展示为准仓库模型注册表aider/resources/model-settings.yml中的条目会随版本演进本地可用aider --list-models bedrock/获取与当前安装版本一致的真实清单。九、延伸阅读若需更细粒度的模型行为控制如弱模型、编辑器模型、thinking tokens可阅读 高级模型设置说明关于.env的完整加载顺序与可配置项参见 .env 配置文档Bedrock 相关行为参数的最终权威来源是仓库内的 aider/resources/model-settings.yml 与 aider/models.py遇到某模型为什么这么设的问题时直接查这两处即可。【免费下载链接】aideraider is AI pair programming in your terminal项目地址: https://gitcode.com/GitHub_Trending/ai/aider创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考