aider 接入 Anthropic Claude 完整指南API Key 配置、模型指定与 Thinking Tokens 调优【免费下载链接】aideraider is AI pair programming in your terminal项目地址: https://gitcode.com/GitHub_Trending/ai/aideraider 是运行在终端里的 AI 结对编程工具官方文档将 AnthropicClaude 系列模型列为开箱即用的接入对象。本篇指南以 Anthropic 接入文档 为骨架结合仓库源码models.py、args.py、main.py 等梳理三条主线如何配置 Anthropic API Key、如何在 aider 中启动并切换 Claude 模型以及如何通过模型设置文件手工开启 Claude 3.7 Sonnet 的 Thinking tokens思考令牌。读完本文你将能在自己的代码库中直接用aider驱动 Claude 编码并掌握.aider.model.settings.yml的完整调参能力。安装 aider文档给出的标准安装方式是通过aider-install引导安装执行两条命令即可python -m pip install aider-install aider-install更多安装路径pip、Docker、Codespaces、Replit 等见 安装指南。安装完成后在任意终端里输入aider --version即可确认是否就绪。配置 Anthropic API Key在正式使用前需要把 Anthropic API Key 交给 aider文档提供了两种方式设置环境变量ANTHROPIC_API_KEY使用命令行开关--anthropic-api-key。在 shell 里写入环境变量的做法如下export ANTHROPIC_API_KEYkey # Mac/Linux setx ANTHROPIC_API_KEY key # Windows执行 setx 后需重启 shellWindows 下setx只对新开的终端进程生效所以文档特别强调“restart shell after setx”。仓库源码印证了该开关的实际作用args.py 注册了--anthropic-api-key参数而 main.py 会在启动阶段把它写入进程环境变量if args.anthropic_api_key: os.environ[ANTHROPIC_API_KEY] args.anthropic_api_key也就是说两种配置方式殊途同归最终都会变成进程内的ANTHROPIC_API_KEY由底层 LLM 网关litellm读取使用。仓库提供的 sample.env 中同样预留了#ANTHROPIC_API_KEY与#AIDER_ANTHROPIC_API_KEY两行说明你也可以借助.env文件统一管理密钥。配置文件的更多写法可参考 配置文件说明 与 options 文档。在你的代码库中启动 aider配置好 Key 之后进入项目目录直接运行aider即可开始工作# 进入你的代码库 cd /to/your/project # aider 默认使用 Sonnet 系列模型 aider # 列出 Anthropic 提供的可用模型 aider --list-models anthropic/关于“默认模型”需要区分两层事实文档明确写道 “Aider uses Claude 3.7 Sonnet by default”默认使用 Claude 3.7 Sonnet从当前仓库源码看默认模型的选择逻辑位于 onboarding.py当检测到环境变量ANTHROPIC_API_KEY时try_to_select_default_model()会返回模型别名sonnet随后由 models.py 通过MODEL_ALIASES把别名解析为具体模型名。因此如果你只设置了 Anthropic Key 而不显式指定--modelaider 会自动选用 Sonnet 别名指向的当前默认 Claude 模型。若想了解自己的实例实际解析到哪个模型可在启动后查看 aider 输出的模型横幅或直接运行aider --list-models sonnet检索匹配项。查看模型列表并切换任意 Claude 模型--list-models支持传入部分模型名做过滤例如aider --list-models anthropic/会列出所有带anthropic/前缀的模型。models.py 中的ANTHROPIC_MODELS常量给出了仓库内置识别的 Claude 家族清单含新旧多代模型其中包括旧世代claude-2、claude-2.1Claude 3claude-3-haiku-20240307、claude-3-sonnet-20240229、claude-3-opus-20240229Claude 3.5/3.7claude-3-5-sonnet-20240620、claude-3-5-sonnet-20241022、claude-3-5-haiku-20241022、claude-3-7-sonnet-20250219Claude 4 及更新claude-sonnet-4-20250514、claude-opus-4-20250514、claude-opus-4-5、claude-haiku-4-5等想切换模型时使用aider --model model-name。例如指定某个特定版本的 Opusaider --model claude-3-opus-20240229该参数在 args.py 中注册为“main chat 使用的模型”。注意两点使用前提模型名可采用裸名如claude-3-opus-20240229或带 provider 前缀的全限定名如anthropic/claude-3-7-sonnet-20250219在 .aider.model.settings.yml 中自定义模型设置时文档与源码都建议使用全限定名如anthropic/claude-3-5-haiku-20241022以确保与内置配置精确匹配。关于限流OpenRouter 与 Vertex AI 通道文档专门给出提示Anthropic 官方的速率限制较低very low rate limits。如果希望获得更宽松的额度可以经由聚合通道访问同一批 Claude 模型通过 OpenRouter 接入通过 Google Vertex AI 接入这两条通道在模型设置中的 provider 前缀分别对应openrouter/anthropic/...与vertex_ai/...后者还可写作vertex_ai/claude-......你可以在对应文档中按需选用。Thinking tokens为 Claude 3.7 Sonnet 开启思考模式Claude 3.7 Sonnet 引入了“思考令牌thinking tokens”能力让模型在作答前先进行内部推理。aider 可以配合这种机制工作但默认不会要求 Sonnet 使用 thinking tokens——只有在显式配置后才会启用。为什么要手工配置目前启用 thinking 尚未被包装成开箱即用的默认行为文档原话“More streamlined support will be coming soon”即更顺滑的支持即将到来所以需要把配置写进模型设置文件中。从源码看aider 对“思考”支持的实现主要位于 models.py 的set_thinking_tokens()它会将thinking参数type: enabledbudget_tokens注入模型的extra_params并在发送给模型时生效同时把use_temperature关闭。也就是说配置 thinking 的本质是向 API 请求追加 Anthropic 官方的 extended thinking 字段。编写模型设置文件文档给出了一份可直接落地的 YAML 配置。把以下内容追加到.aider.model.settings.yml并调整budget_tokens的值即可改变思考令牌的预算- name: anthropic/claude-3-7-sonnet-20250219 edit_format: diff weak_model_name: anthropic/claude-3-5-haiku-20241022 use_repo_map: true examples_as_sys_msg: true use_temperature: false extra_params: extra_headers: anthropic-beta: prompt-caching-2024-07-31,pdfs-2024-09-25,output-128k-2025-02-19 max_tokens: 64000 thinking: type: enabled budget_tokens: 32000 # 通过调整这个数值控制思考令牌数量 cache_control: true editor_model_name: anthropic/claude-3-7-sonnet-20250219 editor_edit_format: editor-diff这份配置与仓库内置的资源文件高度一致——在 aider/resources/model-settings.yml 中anthropic/claude-3-7-sonnet-20250219的默认条目同样包含edit_format: diff、weak_model_name: anthropic/claude-3-5-haiku-20241022、use_repo_map: true、cache_control: true以及带output-128k-2025-02-19的extra_headers并声明accepts_settings: [thinking_tokens]——意思是该模型“接受 thinking tokens 设置”这正是 main.py 判断是否应用--thinking-tokens参数的门槛。模型设置文件放在哪里.aider.model.settings.yml的查找优先级为后加载者覆盖先加载者按官方模型设置文档你的主目录home directoryGit 仓库根目录启动 aider 的当前目录通过--model-settings-file filename显式指定的文件。默认文件名为.aider.model.settings.yml对应参数声明见 args.py。YAML 内容是一个对象列表每个对象以- name:指定模型名其余字段都是可选的覆盖项。配置字段逐项解读对照 models.py 的ModelSettings数据类以及 官方模型设置文档上面 YAML 中每个字段的含义如下字段含义备注/默认值name目标模型全限定名建议带anthropic/前缀edit_format编辑格式对 Claude 编码模型通常为diffClaude 模型默认走 diff 格式weak_model_name弱模型用于 commit message 等轻量任务Claude 家族常配claude-3-5-haiku-20241022use_repo_map是否启用仓库地图true表示让模型获得仓库结构概要examples_as_sys_msg示例是否放入系统消息提升长会话稳定性use_temperature是否使用温度采样开启 thinking 后应设为false源码也会强制关闭extra_params.extra_headers追加的 HTTP 头anthropic-beta中声明启用的 beta 能力extra_params.max_tokens最大输出令牌3.7 Sonnet 配 64000配合output-128k-2025-02-19beta 头extra_params.thinking思考参数type: enabled且budget_tokens: 32000可自行调整cache_control是否启用 prompt caching 控制内置 Claude 条目普遍为trueeditor_model_name编辑器会话使用的模型可设为与主模型相同editor_edit_format编辑器会话编辑格式Claude 3.7 Sonnet 配editor-diff需要说明extra_params是“透传给litellm.completion()的任意额外参数”官方文档因此凡是 Anthropic API 支持的字段max_tokens、thinking、extra_headers等都可以放进去。aider内置了多数流行 Claude 模型的默认设置见 resources/model-settings.yml 中的anthropic/claude-*条目对已知模型你只需要覆盖想改的字段即可。补充命令行层面的 Thinking / Reasoning 控制除了 YAMLaider 还为“支持该设置”的模型暴露了 CLI 参数相关逻辑在 main.py--thinking-tokens budget为支持的模型设置思考令牌预算传0可禁用参数声明见 args.py--reasoning-effort设置reasoning_effortAPI 参数--check-model-accepts-settings默认开启仅当模型在accepts_settings中声明支持thinking_tokens/reasoning_effort时才应用设置否则给出警告并忽略可用--no-check-model-accepts-settings强制下发main.py。这条命令行路径与“Thinking tokens 小节”的 YAML 配置互为补充YAML 适合把配置沉淀到仓库供团队复用CLI 参数适合单次会话内快速调节。两者最终都会走 models.py 的set_thinking_tokens()把预算写入extra_params[thinking][budget_tokens]。小结把 Anthropic Claude 接入 aider 的完整链路可以概括为四步安装 aider → 通过ANTHROPIC_API_KEY或--anthropic-api-key配置密钥 → 用aider或aider --model claude 模型启动会话可用aider --list-models anthropic/检索模型→ 如需思考能力则在.aider.model.settings.yml中为anthropic/claude-3-7-sonnet-20250219追加extra_params.thinking并调整budget_tokens。其中有两个高频疑问值得记住一是官方 Anthropic 通道限流较低追求更宽松额度可转向 OpenRouter 或 Vertex AI二是 thinking 相关配置与内置的模型默认设置深度联动改配置前可以先阅读 高级模型设置文档并结合仓库中的 model-settings.yml 对照理解避免自定义条目与内置条目互相冲突。【免费下载链接】aideraider is AI pair programming in your terminal项目地址: https://gitcode.com/GitHub_Trending/ai/aider创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 aider 接入 Anthropic Claude 完整指南：API Key 配置、模型指定与 Thinking Tokens 调优
aider 接入 Anthropic Claude 完整指南API Key 配置、模型指定与 Thinking Tokens 调优【免费下载链接】aideraider is AI pair programming in your terminal项目地址: https://gitcode.com/GitHub_Trending/ai/aideraider 是运行在终端里的 AI 结对编程工具官方文档将 AnthropicClaude 系列模型列为开箱即用的接入对象。本篇指南以 Anthropic 接入文档 为骨架结合仓库源码models.py、args.py、main.py 等梳理三条主线如何配置 Anthropic API Key、如何在 aider 中启动并切换 Claude 模型以及如何通过模型设置文件手工开启 Claude 3.7 Sonnet 的 Thinking tokens思考令牌。读完本文你将能在自己的代码库中直接用aider驱动 Claude 编码并掌握.aider.model.settings.yml的完整调参能力。安装 aider文档给出的标准安装方式是通过aider-install引导安装执行两条命令即可python -m pip install aider-install aider-install更多安装路径pip、Docker、Codespaces、Replit 等见 安装指南。安装完成后在任意终端里输入aider --version即可确认是否就绪。配置 Anthropic API Key在正式使用前需要把 Anthropic API Key 交给 aider文档提供了两种方式设置环境变量ANTHROPIC_API_KEY使用命令行开关--anthropic-api-key。在 shell 里写入环境变量的做法如下export ANTHROPIC_API_KEYkey # Mac/Linux setx ANTHROPIC_API_KEY key # Windows执行 setx 后需重启 shellWindows 下setx只对新开的终端进程生效所以文档特别强调“restart shell after setx”。仓库源码印证了该开关的实际作用args.py 注册了--anthropic-api-key参数而 main.py 会在启动阶段把它写入进程环境变量if args.anthropic_api_key: os.environ[ANTHROPIC_API_KEY] args.anthropic_api_key也就是说两种配置方式殊途同归最终都会变成进程内的ANTHROPIC_API_KEY由底层 LLM 网关litellm读取使用。仓库提供的 sample.env 中同样预留了#ANTHROPIC_API_KEY与#AIDER_ANTHROPIC_API_KEY两行说明你也可以借助.env文件统一管理密钥。配置文件的更多写法可参考 配置文件说明 与 options 文档。在你的代码库中启动 aider配置好 Key 之后进入项目目录直接运行aider即可开始工作# 进入你的代码库 cd /to/your/project # aider 默认使用 Sonnet 系列模型 aider # 列出 Anthropic 提供的可用模型 aider --list-models anthropic/关于“默认模型”需要区分两层事实文档明确写道 “Aider uses Claude 3.7 Sonnet by default”默认使用 Claude 3.7 Sonnet从当前仓库源码看默认模型的选择逻辑位于 onboarding.py当检测到环境变量ANTHROPIC_API_KEY时try_to_select_default_model()会返回模型别名sonnet随后由 models.py 通过MODEL_ALIASES把别名解析为具体模型名。因此如果你只设置了 Anthropic Key 而不显式指定--modelaider 会自动选用 Sonnet 别名指向的当前默认 Claude 模型。若想了解自己的实例实际解析到哪个模型可在启动后查看 aider 输出的模型横幅或直接运行aider --list-models sonnet检索匹配项。查看模型列表并切换任意 Claude 模型--list-models支持传入部分模型名做过滤例如aider --list-models anthropic/会列出所有带anthropic/前缀的模型。models.py 中的ANTHROPIC_MODELS常量给出了仓库内置识别的 Claude 家族清单含新旧多代模型其中包括旧世代claude-2、claude-2.1Claude 3claude-3-haiku-20240307、claude-3-sonnet-20240229、claude-3-opus-20240229Claude 3.5/3.7claude-3-5-sonnet-20240620、claude-3-5-sonnet-20241022、claude-3-5-haiku-20241022、claude-3-7-sonnet-20250219Claude 4 及更新claude-sonnet-4-20250514、claude-opus-4-20250514、claude-opus-4-5、claude-haiku-4-5等想切换模型时使用aider --model model-name。例如指定某个特定版本的 Opusaider --model claude-3-opus-20240229该参数在 args.py 中注册为“main chat 使用的模型”。注意两点使用前提模型名可采用裸名如claude-3-opus-20240229或带 provider 前缀的全限定名如anthropic/claude-3-7-sonnet-20250219在 .aider.model.settings.yml 中自定义模型设置时文档与源码都建议使用全限定名如anthropic/claude-3-5-haiku-20241022以确保与内置配置精确匹配。关于限流OpenRouter 与 Vertex AI 通道文档专门给出提示Anthropic 官方的速率限制较低very low rate limits。如果希望获得更宽松的额度可以经由聚合通道访问同一批 Claude 模型通过 OpenRouter 接入通过 Google Vertex AI 接入这两条通道在模型设置中的 provider 前缀分别对应openrouter/anthropic/...与vertex_ai/...后者还可写作vertex_ai/claude-......你可以在对应文档中按需选用。Thinking tokens为 Claude 3.7 Sonnet 开启思考模式Claude 3.7 Sonnet 引入了“思考令牌thinking tokens”能力让模型在作答前先进行内部推理。aider 可以配合这种机制工作但默认不会要求 Sonnet 使用 thinking tokens——只有在显式配置后才会启用。为什么要手工配置目前启用 thinking 尚未被包装成开箱即用的默认行为文档原话“More streamlined support will be coming soon”即更顺滑的支持即将到来所以需要把配置写进模型设置文件中。从源码看aider 对“思考”支持的实现主要位于 models.py 的set_thinking_tokens()它会将thinking参数type: enabledbudget_tokens注入模型的extra_params并在发送给模型时生效同时把use_temperature关闭。也就是说配置 thinking 的本质是向 API 请求追加 Anthropic 官方的 extended thinking 字段。编写模型设置文件文档给出了一份可直接落地的 YAML 配置。把以下内容追加到.aider.model.settings.yml并调整budget_tokens的值即可改变思考令牌的预算- name: anthropic/claude-3-7-sonnet-20250219 edit_format: diff weak_model_name: anthropic/claude-3-5-haiku-20241022 use_repo_map: true examples_as_sys_msg: true use_temperature: false extra_params: extra_headers: anthropic-beta: prompt-caching-2024-07-31,pdfs-2024-09-25,output-128k-2025-02-19 max_tokens: 64000 thinking: type: enabled budget_tokens: 32000 # 通过调整这个数值控制思考令牌数量 cache_control: true editor_model_name: anthropic/claude-3-7-sonnet-20250219 editor_edit_format: editor-diff这份配置与仓库内置的资源文件高度一致——在 aider/resources/model-settings.yml 中anthropic/claude-3-7-sonnet-20250219的默认条目同样包含edit_format: diff、weak_model_name: anthropic/claude-3-5-haiku-20241022、use_repo_map: true、cache_control: true以及带output-128k-2025-02-19的extra_headers并声明accepts_settings: [thinking_tokens]——意思是该模型“接受 thinking tokens 设置”这正是 main.py 判断是否应用--thinking-tokens参数的门槛。模型设置文件放在哪里.aider.model.settings.yml的查找优先级为后加载者覆盖先加载者按官方模型设置文档你的主目录home directoryGit 仓库根目录启动 aider 的当前目录通过--model-settings-file filename显式指定的文件。默认文件名为.aider.model.settings.yml对应参数声明见 args.py。YAML 内容是一个对象列表每个对象以- name:指定模型名其余字段都是可选的覆盖项。配置字段逐项解读对照 models.py 的ModelSettings数据类以及 官方模型设置文档上面 YAML 中每个字段的含义如下字段含义备注/默认值name目标模型全限定名建议带anthropic/前缀edit_format编辑格式对 Claude 编码模型通常为diffClaude 模型默认走 diff 格式weak_model_name弱模型用于 commit message 等轻量任务Claude 家族常配claude-3-5-haiku-20241022use_repo_map是否启用仓库地图true表示让模型获得仓库结构概要examples_as_sys_msg示例是否放入系统消息提升长会话稳定性use_temperature是否使用温度采样开启 thinking 后应设为false源码也会强制关闭extra_params.extra_headers追加的 HTTP 头anthropic-beta中声明启用的 beta 能力extra_params.max_tokens最大输出令牌3.7 Sonnet 配 64000配合output-128k-2025-02-19beta 头extra_params.thinking思考参数type: enabled且budget_tokens: 32000可自行调整cache_control是否启用 prompt caching 控制内置 Claude 条目普遍为trueeditor_model_name编辑器会话使用的模型可设为与主模型相同editor_edit_format编辑器会话编辑格式Claude 3.7 Sonnet 配editor-diff需要说明extra_params是“透传给litellm.completion()的任意额外参数”官方文档因此凡是 Anthropic API 支持的字段max_tokens、thinking、extra_headers等都可以放进去。aider内置了多数流行 Claude 模型的默认设置见 resources/model-settings.yml 中的anthropic/claude-*条目对已知模型你只需要覆盖想改的字段即可。补充命令行层面的 Thinking / Reasoning 控制除了 YAMLaider 还为“支持该设置”的模型暴露了 CLI 参数相关逻辑在 main.py--thinking-tokens budget为支持的模型设置思考令牌预算传0可禁用参数声明见 args.py--reasoning-effort设置reasoning_effortAPI 参数--check-model-accepts-settings默认开启仅当模型在accepts_settings中声明支持thinking_tokens/reasoning_effort时才应用设置否则给出警告并忽略可用--no-check-model-accepts-settings强制下发main.py。这条命令行路径与“Thinking tokens 小节”的 YAML 配置互为补充YAML 适合把配置沉淀到仓库供团队复用CLI 参数适合单次会话内快速调节。两者最终都会走 models.py 的set_thinking_tokens()把预算写入extra_params[thinking][budget_tokens]。小结把 Anthropic Claude 接入 aider 的完整链路可以概括为四步安装 aider → 通过ANTHROPIC_API_KEY或--anthropic-api-key配置密钥 → 用aider或aider --model claude 模型启动会话可用aider --list-models anthropic/检索模型→ 如需思考能力则在.aider.model.settings.yml中为anthropic/claude-3-7-sonnet-20250219追加extra_params.thinking并调整budget_tokens。其中有两个高频疑问值得记住一是官方 Anthropic 通道限流较低追求更宽松额度可转向 OpenRouter 或 Vertex AI二是 thinking 相关配置与内置的模型默认设置深度联动改配置前可以先阅读 高级模型设置文档并结合仓库中的 model-settings.yml 对照理解避免自定义条目与内置条目互相冲突。【免费下载链接】aideraider is AI pair programming in your terminal项目地址: https://gitcode.com/GitHub_Trending/ai/aider创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考