Aider với Claude qua cổng API: ANTHROPIC_API_BASE, tệp cấu hình, chế độ architect và cách khắc phục lỗi

Aider gửi mọi lệnh gọi mô hình qua LiteLLM, nên việc trỏ đến cổng API là thiết lập của LiteLLM chứ không phải của Aider. Với Claude, điều đó có nghĩa là ANTHROPIC_API_BASE được đặt thành URL gốc máy chủ của cổng API và tên mô hình có tiền tố anthropic/ . Hai thiết lập ít rõ ràng hơn cũng quan trọng không kém: các ID Claude mới hơn cần một mục cấu hình mô hình, nếu không Aider sẽ chuyển sang chỉnh sửa toàn bộ tệp mà không có bản đồ kho mã.

Cài đặt Aider

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

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

Nếu lệnh aider không được tìm thấy sau đó, điều thường gặp trên Windows, python -m aider sẽ chạy cùng chương trình.

Kết nối với Claude qua cổng API

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

aider --model anthropic/claude-sonnet-5

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

Tài liệu của Aider không đề cập đến URL cơ sở Anthropic tùy chỉnh. Biến này được LiteLLM đọc, và LiteLLM kiểm tra ANTHROPIC_API_BASE trước, rồi đến ANTHROPIC_BASE_URL, biến mà Claude Code sử dụng. Cả hai đều dùng được; nếu cả hai cùng được đặt, ANTHROPIC_API_BASE được ưu tiên.

Giữ tiền tố anthropic/ trong tên mô hình. Nếu không có tiền tố nhà cung cấp, LiteLLM không biết phải gửi một tên lạ đến đâu và sẽ thất bại với lỗi LLM Provider NOT provided.

Đặt các thiết lập trong tệp cấu hình

Aider đọc .aider.conf.yml và .env từ thư mục cá nhân, thư mục gốc của kho git và thư mục hiện tại, theo thứ tự đó; các tệp đọc sau được ưu tiên. Một tệp trong thư mục cá nhân áp dụng cho mọi dự án.

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

ANTHROPIC_API_KEY=your_gateway_key

weak-model xử lý thông điệp commit và bản tóm tắt lịch sử trò chuyện, nên dùng một mô hình giá rẻ ở đây giúp tiết kiệm chi phí trong mỗi phiên. set-env sao chép biến vào môi trường trước mọi lệnh gọi mô hình, giúp bạn không phải đặt URL cơ sở trong tệp cấu hình shell.

Duy trì chỉnh sửa diff và bản đồ kho mã trên các mô hình mới hơn

Aider chọn định dạng chỉnh sửa theo tên mô hình. Những tên mà Aider nhận diện được, bao gồm các tên chứa sonnet-4-, opus-4- hoặc haiku-4-, được dùng định dạng chỉnh sửa diff và bản đồ kho mã. Một tên mà Aider không nhận diện được, chẳng hạn như claude-sonnet-5, sẽ khiến Aider chuyển sang viết lại toàn bộ tệp và bỏ bản đồ kho mã. Điều này làm việc chỉnh sửa chậm hơn và tốn kém hơn. Một mục cấu hình sẽ khôi phục hành vi đúng:

- 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

Các mô hình không xác định cũng kích hoạt cảnh báo: Unknown context window size and costs, using sane defaults. Cảnh báo này không gây hại, nhưng sau đó Aider giả định cửa sổ ngữ cảnh không giới hạn và giá bằng không. Tệp siêu dữ liệu cung cấp các giá trị thực:

{
  "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"
  }
}

Các mức giá này là giá niêm yết theo token của Anthropic, nên phần hiển thị chi phí của Aider cho biết chi phí theo giá niêm yết; gateway tính phí thấp hơn mức đó. Giới hạn đầu vào 200K là ngưỡng làm việc an toàn ngay cả khi mô hình hỗ trợ nhiều hơn.

Chế độ kiến trúc sư: lập kế hoạch bằng một mô hình, chỉnh sửa bằng mô hình khác

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

Trong chế độ kiến trúc sư, mô hình chính đề xuất thay đổi và mô hình chỉnh sửa chuyển đề xuất đó thành các chỉnh sửa tệp. Dùng mô hình mạnh hơn để lập kế hoạch và mô hình rẻ hơn để chỉnh sửa thường ít tốn kém hơn so với dùng mô hình mạnh cho cả hai việc. Trong một phiên, /architect chuyển sang mô hình đó cho một tin nhắn và /chat-mode architect chuyển sang mô hình đó cho phần còn lại của phiên.

Cách kết nối tương thích với OpenAI

Gateway cũng hỗ trợ định dạng Chat Completions của OpenAI, đây là cách kết nối dành cho các mô hình GPT trên cùng tài khoản. Với cách này, URL cơ sở có chứa /v1, và tên mô hình có openai/ làm tiền tố:

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

aider --model openai/claude-sonnet-5

Với Claude, hãy ưu tiên cách kết nối gốc ở trên: siêu dữ liệu mô hình và cơ chế lưu đệm prompt khớp với định dạng của Anthropic. Nếu trong môi trường của bạn vô tình có thiết lập OPENAI_BASE_URL , LiteLLM sẽ ưu tiên dùng biến đó thay cho OPENAI_API_BASE.

Mô hình

Các bí danh ngắn của Aider (sonnet, opus, haiku) trỏ đến các ID mô hình cũ hơn, vì vậy hãy chỉ định tên mô hình một cách tường minh. Các ID cũ có ngày tháng như claude-3-5-sonnet-20241022 không được cung cấp.

Khắc phục sự cố

Với các lỗi đến từ phía mô hình thay vì từ Aider, hãy xem hướng dẫn về lỗi Claude API.

Câu hỏi thường gặp

AI Prime Tech là một cổng API độc lập. AI Prime Tech không liên kết với, không được Anthropic chứng thực và không phải là đại lý bán lại của Anthropic. Claude và các tên mô hình liên quan là nhãn hiệu của chủ sở hữu tương ứng.