高级模型设置

上下文窗口大小与令牌成本

在大多数情况下，您可以安全地忽略 aider 关于未知上下文窗口大小和模型成本的警告。

Aider 从不强制令牌限制，它仅报告来自 API 提供商的令牌限制错误。对于非常规模型，您通常不需要为 aider 配置正确的令牌限制。

但是，您可以为 aider 未知的模型注册上下文窗口限制和成本。在以下任一位置创建 .aider.model.metadata.json 文件：

您的主目录
Git 仓库的根目录
启动 aider 的当前目录
或使用 --model-metadata-file <文件名> 参数指定特定文件

如果上述文件存在，它们将按该顺序加载。最后加载的文件将具有优先权。

JSON 文件应为一个字典，为每个模型提供如下条目：

{
    "deepseek/deepseek-chat": {
        "max_tokens": 4096,
        "max_input_tokens": 32000,
        "max_output_tokens": 4096,
        "input_cost_per_token": 0.00000014,
        "output_cost_per_token": 0.00000028,
        "litellm_provider": "deepseek",
        "mode": "chat"
    }
}

在 .aider.model.metadata.json 文件中使用带有 provider/ 前缀的完全限定模型名称。例如，使用 deepseek/deepseek-chat，而不仅仅是 deepseek-chat。该前缀应与 litellm_provider 字段匹配。

贡献模型元数据

Aider 依赖 litellm 的 model_prices_and_context_window.json 文件获取模型元数据。

考虑向该文件提交 PR 以添加缺失的模型。

模型设置

Aider 有许多控制其与不同模型协作方式的设置。这些模型设置已为大多数流行模型预先配置。但有时覆盖这些设置或为 aider 未知的模型添加设置会有所帮助。

配置文件位置

您可以通过在以下任一位置创建 .aider.model.settings.yml 文件来覆盖或添加任何模型的设置：

您的主目录
Git 仓库的根目录
启动 aider 的当前目录
或者使用 --model-settings-file <filename> 参数指定特定文件

如果上述文件存在，它们将按此顺序加载。最后加载的文件将具有优先级。

YAML 文件应为每个模型的字典对象列表。

向 litellm.completion 传递额外参数

模型设置中的 extra_params 属性用于在向指定模型发送数据时，向 litellm.completion() 调用传递任意额外参数。

例如：

- name: some-provider/my-special-model
  extra_params:
    extra_headers:
      Custom-Header: value
    max_tokens: 8192

您可以使用特殊模型名称 aider/extra_params 来定义将传递给所有模型的 litellm.completion() 的 extra_params。此特殊模型名称仅使用 extra_params 字典。

例如：

- name: aider/extra_params
  extra_params:
    extra_headers:
      Custom-Header: value
    max_tokens: 8192

这些设置将与任何模型特定设置合并，对于直接冲突的情况，aider/extra_params 设置将优先。

默认模型设置

以下是所有预配置的模型设置，以便了解支持的配置选项。

您也可以查看 models.py 文件中的 ModelSettings 类，了解 aider 支持的所有模型设置的详细信息。

第一个条目展示了所有设置及其默认值。对于实际模型，您只需包含需要覆盖默认值的字段即可。

- name: (默认值)
  edit_format: whole
  weak_model_name: null
  use_repo_map: false
  send_undo_reply: false
  lazy: false
  overeager: false
  reminder: user
  examples_as_sys_msg: false
  extra_params: null
  cache_control: false
  caches_by_default: false
  use_system_prompt: true
  use_temperature: true
  streaming: true
  editor_model_name: null
  editor_edit_format: null
  reasoning_tag: null
  remove_reasoning: null
  system_prompt_prefix: null
  accepts_settings: null

- name: anthropic.claude-opus-4-20250514-v1:0
  edit_format: diff
  weak_model_name: anthropic.claude-3-5-haiku-20241022-v1:0
  use_repo_map: true
  extra_params:
    extra_headers:
      anthropic-beta: prompt-caching-2024-07-31,pdfs-2024-09-25,output-128k-2025-02-19
    max_tokens: 32000
  cache_control: true
  editor_model_name: anthropic.claude-sonnet-4-20250514-v1:0
  editor_edit_format: editor-diff
  accepts_settings:
  - thinking_tokens

[... 其余模型配置保持不变 ...]

[注意：为保持文档完整性，此处省略了完整的YAML配置内容，实际文档中包含所有模型配置的完整列表。所有模型名称、参数和值均保持原样未翻译，仅对描述性文本进行了中文化处理。]

高级模型设置

上下文窗口大小与令牌成本

贡献模型元数据

模型设置

配置文件位置

向 litellm.completion 传递额外参数

默认模型设置

目录