Source: https://aiprimetech.io/zh/learn/use-claude-api-with-aider/

[首页](/zh/) / [学习](/zh/learn/) / 通过网关在 Aider 中使用 Claude：ANTHROPIC_API_BASE、配置文件、架构师模式和问题修复 

# 通过网关在 Aider 中使用 Claude：ANTHROPIC_API_BASE、配置文件、架构师模式与问题修复 

Aider 的每次模型调用都通过 LiteLLM 发送，因此将其指向网关需要调整 LiteLLM 设置，而非 Aider 设置。对于 Claude，这意味着将 ANTHROPIC_API_BASE 设为网关的主机根地址，并使用带有以下前缀的模型名称： anthropic/ 。另有两项不太显眼的设置同样重要：较新的 Claude ID 需要添加模型设置条目，否则 Aider 会回退到整文件编辑，并且不使用代码仓库映射。 

## 安装 Aider 

macOS / Linux复制

```
python -m pip install aider-install
aider-install

# or the one-line installer (installs Python 3.12 if needed)
curl -LsSf https://aider.chat/install.sh | sh
```

Windows复制

```
powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"
```

如果之后找不到 aider 命令（这在 Windows 上很常见）， python -m aider 可运行同一个程序。 

## 通过网关连接 Claude 

终端复制

```
export ANTHROPIC_API_KEY=your_gateway_key
export ANTHROPIC_API_BASE=https://aiprimetech.io

aider --model anthropic/claude-sonnet-5
```

Windows复制

```
setx ANTHROPIC_API_KEY your_gateway_key
setx ANTHROPIC_API_BASE https://aiprimetech.io
# open a new terminal, then:
aider --model anthropic/claude-sonnet-5
```

使用主机根地址：不带 /v1 ，也不带末尾斜杠。LiteLLM 会追加 /v1/messages ，因此 https://aiprimetech.io/v1 会变成 /v1/v1/messages 并返回 404，而末尾斜杠会导致路径中出现双斜杠。 

Aider 自身的文档未介绍自定义 Anthropic 基础 URL。该变量由 LiteLLM 读取，它会先检查 ANTHROPIC_API_BASE ，然后检查 ANTHROPIC_BASE_URL，也就是 Claude Code 使用的变量。两者均可；如果都已设置，则 ANTHROPIC_API_BASE 优先。 

保留模型名称中的 anthropic/ 前缀。如果没有提供商前缀，LiteLLM 不知道应将不熟悉的名称发送到哪里，并会失败，报错为 LLM Provider NOT provided. 

## 将设置写入配置文件 

Aider 会读取 .aider.conf.yml 和 .env ，依次从您的主目录、git 仓库根目录和当前目录读取，后读取的文件优先。主目录中的文件适用于所有项目。 

~/.aider.conf.yml复制

```
model: anthropic/claude-sonnet-5
weak-model: anthropic/claude-haiku-4-5
set-env:
  - ANTHROPIC_API_BASE=https://aiprimetech.io
model-settings-file: ~/.aider.model.settings.yml
model-metadata-file: ~/.aider.model.metadata.json
```

~/.env复制

```
ANTHROPIC_API_KEY=your_gateway_key
```

weak-model 负责处理提交消息和聊天历史摘要，因此在此处使用低价模型可节省每次会话的费用。 set-env 会在任何模型调用之前将该变量复制到环境中，这样就无需将基础 URL 写入 shell 配置文件。 

## 在较新模型上保留差异编辑和代码仓库映射 

Aider 根据模型名称选择编辑格式。它能识别的名称，包括含有 sonnet-4-, opus-4- 或 haiku-4-的名称，会使用 diff 编辑和代码仓库映射。它无法识别的名称，例如 claude-sonnet-5，会回退到重写整个文件，并弃用代码仓库映射。这会让编辑速度更慢、费用更高。添加设置条目即可恢复正确行为： 

~/.aider.model.settings.yml复制

```
- name: anthropic/claude-sonnet-5
  edit_format: diff
  use_repo_map: true
  weak_model_name: anthropic/claude-haiku-4-5

- name: anthropic/claude-opus-5-5
  edit_format: diff
  use_repo_map: true
  weak_model_name: anthropic/claude-haiku-4-5
  editor_model_name: anthropic/claude-sonnet-5
  editor_edit_format: editor-diff
```

未知模型还会触发警告： Unknown context window size and costs, using sane defaults。这条警告本身无害，但 Aider 随后会假定上下文窗口无限、价格为零。元数据文件可为其提供实际数值： 

~/.aider.model.metadata.json复制

```
{
  "anthropic/claude-sonnet-5": {
    "max_tokens": 64000,
    "max_input_tokens": 200000,
    "max_output_tokens": 64000,
    "input_cost_per_token": 0.000002,
    "output_cost_per_token": 0.00001,
    "litellm_provider": "anthropic",
    "mode": "chat"
  },
  "anthropic/claude-opus-5-5": {
    "max_tokens": 64000,
    "max_input_tokens": 200000,
    "max_output_tokens": 64000,
    "input_cost_per_token": 0.000004,
    "output_cost_per_token": 0.00002,
    "litellm_provider": "anthropic",
    "mode": "chat"
  }
}
```

这些价格是 Anthropic 按 token 计费的标价，因此 Aider 的费用显示的是标价费用；网关的实际收费更低。即使模型支持更大的输入，200K 的输入限制仍是安全的工作上限。 

## 架构师模式：用一个模型规划，用另一个模型编辑 

终端复制

```
aider --architect --model anthropic/claude-opus-5-5 --editor-model anthropic/claude-sonnet-5
```

在架构师模式下，主模型提出更改方案，编辑模型将其转化为文件修改。使用更强的模型规划、较便宜的模型编辑，通常比两个环节都使用强模型更省钱。在会话中， /architect 会切换到该模式，仅用于一条消息，而 /chat-mode architect 会在会话剩余时间内切换到该模式。 

## OpenAI 兼容接入方式 

网关还支持 OpenAI Chat Completions 格式，可通过同一账户以这种方式使用 GPT 模型。采用这种接入方式时，基础 URL 确实需要包含 /v1，且模型名称需要带上 openai/ 前缀： 

终端复制

```
export OPENAI_API_KEY=your_gateway_key
export OPENAI_API_BASE=https://aiprimetech.io/v1

aider --model openai/claude-sonnet-5
```

对于 Claude，优先使用上面的原生接入方式：模型元数据和提示词缓存与 Anthropic 格式相匹配。如果环境中意外设置了 OPENAI_BASE_URL ，LiteLLM 会优先使用它，而不是 OPENAI_API_BASE. 

## 模型 

  | 模型 ID  | 适用场景  

 | claude-sonnet-5 | 编程和智能体任务的默认选择：速度快、能力强、价格适中。 

 | claude-opus-5-5 | 更复杂的推理、大规模重构、长时间运行的智能体任务。 

 | claude-fable-5-1 | 能力最强，价格也最高；留给最困难的任务使用。 

 | claude-haiku-4-5 | 价格低、速度快：标题、摘要、分类和小步骤。  

Aider 的简短别名（sonnet, opus, haiku）指向较旧的模型 ID，因此请明确指定模型名称。带有旧日期的 ID，例如 claude-3-5-sonnet-20241022 ，已不再提供服务。 

## 故障排查 

  | 你会看到什么  | 原因  | 解决方法  

 | 404 / NotFoundError | /v1 在 ANTHROPIC_API_BASE，因此路径变为 /v1/v1/messages | 设置主机根地址， https://aiprimetech.io，末尾不带斜杠 

 | LLM Provider NOT provided | 模型名称缺少提供商前缀 | 使用 anthropic/claude-sonnet-5 

 | AuthenticationError：无法验证你的身份 | 运行 Aider 的 shell 中缺少密钥，或使用了其他端点的密钥 | echo $ANTHROPIC_API_KEY；在 Windows 上，执行以下操作后打开新的终端： setx 

 | 重写整个文件，不使用仓库映射 | Aider 无法识别模型名称 | 添加上面的 .aider.model.settings.yml 条目 

 | Unknown context window size and costs | 缺少该模型的元数据 | 添加元数据文件，或忽略警告 

 | token 限制错误 | 聊天中的文件过多或过大 | /tokens 以查看用量， /drop 文件， /clear 历史记录 

 | RateLimitError | 已达到并发或速率限制 | Aider 会按退避策略重试；避免使用同一个密钥运行多个会话 

 | 模型不受支持 | 模型 ID 已过时或拼写有误 | 使用上表中的 ID  

对于来自模型端而非 Aider 的错误，请参阅 [Claude API 错误指南](/zh/learn/claude-api-errors-troubleshooting/). 

## 常见问题 

 如何在 Aider 中使用自定义 Anthropic 基础 URL？

将 ANTHROPIC_API_BASE 设置为网关的主机根地址，例如 https://aiprimetech.io，不带 /v1，末尾也不带斜杠；设置 ANTHROPIC_API_KEY，然后运行 aider --model anthropic/claude-sonnet-5.。LiteLLM 会追加 /v1/messages。 Aider 会读取 ANTHROPIC_BASE_URL 吗？

会，通过 LiteLLM 将其作为后备设置读取。LiteLLM 先检查 ANTHROPIC_API_BASE，再检查 ANTHROPIC_BASE_URL。 为什么 Aider 在使用新的 Claude 模型时会重写整个文件？

Aider 无法识别模型名称，因此会回退到 whole 编辑格式，且不使用仓库映射。在 .aider.model.settings.yml 中添加一个条目，设置 edit_format: diff 和 use_repo_map: true。 Aider 可以使用 OpenAI 兼容端点吗？

可以：将 OPENAI_API_BASE 设置为包含 /v1 的端点地址，并设置 OPENAI_API_KEY，然后使用 openai/ 前缀，例如 aider --model openai/claude-sonnet-5.  

几分钟内开始使用 Claude

获取 API 密钥，无需 Anthropic 账户，也无需加入候补名单。[获取你的 API 密钥](/register) 

AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，未获得其背书，也不是其经销商。Claude 及相关模型名称是其各自所有者的商标。    

## 更多 Claude API 指南

[如何获取 Claude API 密钥](/zh/learn/how-to-get-a-claude-api-key/)[Claude API 定价详解](/zh/learn/claude-api-pricing-explained/)[使用 Claude API 最便宜的方式](/zh/learn/cheapest-way-to-use-claude-api/)[通过 Claude API 不限量使用 Cursor](/learn/use-claude-api-with-cursor/)[不限量访问 Claude Code](/zh/learn/use-claude-api-with-claude-code/)[Claude API 网关与 Anthropic 直连对比](/zh/learn/claude-api-vs-anthropic-direct/)[通过 OpenAI SDK 使用 Claude：OpenAI 兼容端点、流式传输、工具与限制](/zh/learn/openai-compatible-claude-api/)[Claude 模型详解：Claude Opus、Sonnet、Haiku 与 Fable 的模型对比——全部 Claude API 模型、Anthropic 模型名称与价格（2026）](/zh/learn/claude-api-models-compared/)[使用加密货币支付 Claude API 费用](/zh/learn/claude-api-with-crypto-payment/)[无需候补名单即可访问 Claude API](/zh/learn/claude-api-without-waitlist/)[如何减少 Claude 词元用量](/zh/learn/how-to-reduce-claude-token-usage/)[通过 Claude API 不限量使用 Cline](/zh/learn/use-claude-api-with-cline/)[通过 Claude API 不限量使用 Roo Code](/zh/learn/use-claude-api-with-roo-code/)[在 JetBrains IDE 中不限量使用 Claude](/zh/learn/use-claude-api-with-jetbrains/)[在 VS Code 中不限量使用 Claude](/zh/learn/use-claude-api-with-vscode/)[OpenCode 的 Claude 配置：opencode.json 设置、模型与常见错误](/zh/learn/use-claude-api-with-opencode/)[通过网关在 Hermes Agent 中使用 Claude：自定义提供商配置、成本控制与问题修复](/zh/learn/run-hermes-agent-with-claude-api/)[使用 Claude 不限量运行 OpenClaw](/zh/learn/run-openclaw-with-claude-api/)[兼容 Anthropic 的 API 意味着什么](/zh/learn/anthropic-compatible-api/)[Claude Code API 密钥 — ANTHROPIC_API_KEY：如何获取、配置，以及何时应改用 claude setup-token](/zh/learn/claude-code-api-key-setup/)[Claude Code API 成本 — 定价与降低成本的方法](/zh/learn/claude-code-api-costs/)[Claude API 错误详解：服务器错误 500、过载 529、速率限制 429、错误请求 400 — 以及各自的修复方法](/zh/learn/claude-api-errors-troubleshooting/)[如何购买 Claude API 额度，以及为什么购买 Claude 额度比任何“购买 Claude 账户”的方案都更好](/zh/learn/buy-claude-api-credits/)[Claude 免费 API：有免费的 Claude API 密钥吗？2026 年究竟有哪些内容免费？](/zh/learn/claude-api-free-trial/)[Claude API 与 Claude Pro/Max 订阅——如何选择](/zh/learn/claude-api-vs-subscription/)[通过自定义提供商使用 Codex CLI：config.toml、GPT 与 Claude 模型、IDE 扩展与问题修复](/zh/learn/use-claude-api-with-codex/)[将 Claude 连接到 n8n](/zh/learn/use-claude-api-with-n8n/)[通过 LiteLLM 路由到 Claude](/zh/learn/use-claude-api-with-litellm/)[在 Kilo Code 中使用 Claude](/zh/learn/use-claude-api-with-kilo-code/)[通过网关在 GitHub Copilot Chat 中使用 Claude：自定义端点配置、智能体模式与问题修复](/zh/learn/use-claude-api-with-github-copilot/)[通过网关将 Zed 连接到 Claude](/zh/learn/use-claude-api-with-zed/)[将 Cherry Studio 连接到 Claude](/zh/learn/use-claude-api-with-cherry-studio/)[LangChain 中的 ChatAnthropic：导入、base_url、流式传输、工具和错误](/zh/learn/use-claude-api-with-langchain/)[Anthropic Python SDK：安装、设置 base_url、流式传输和错误处理](/zh/learn/anthropic-python-sdk/)[通过 Vercel AI SDK 使用 Claude：createAnthropic baseURL、流式传输和问题修复](/zh/learn/use-claude-api-with-vercel-ai-sdk/)[使用 Claude 运行 Factory Droid](/zh/learn/use-claude-api-with-factory-droid/)[Claude Code API 详解](/zh/learn/claude-code-api/)[将 Claude API 集成到您的应用中](/zh/learn/claude-api-integration/)[如何不受限制地使用 Claude，以及为什么不存在“Claude Code 破解版本”](/zh/learn/get-unlimited-claude-usage/)