Source: https://aiprimetech.io/vi/learn/use-claude-api-with-aider/ [Trang chủ](/vi/) / [Tìm hiểu](/vi/learn/) / 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 # 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 macOS / LinuxSao chép ``` 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 ``` WindowsSao chép ``` 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 cửa sổ dòng lệnhSao chép ``` export ANTHROPIC_API_KEY=your_gateway_key export ANTHROPIC_API_BASE=https://aiprimetech.io aider --model anthropic/claude-sonnet-5 ``` WindowsSao chép ``` 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 ``` Dùng URL gốc máy chủ: không có /v1 và không có dấu gạch chéo ở cuối. LiteLLM tự thêm /v1/messages , vì vậy https://aiprimetech.io/v1 trở thành /v1/v1/messages và trả về 404, còn dấu gạch chéo ở cuối tạo ra hai dấu gạch chéo liên tiếp trong đường dẫn. 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. ~/.aider.conf.ymlSao chép ``` 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 ``` ~/.envSao chép ``` 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: ~/.aider.model.settings.ymlSao chép ``` - 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: ~/.aider.model.metadata.jsonSao chép ``` { "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 cửa sổ dòng lệnhSao chép ``` 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ố: cửa sổ dòng lệnhSao chép ``` 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 | ID mô hình | Dùng cho | claude-sonnet-5 | Lựa chọn mặc định cho lập trình và tác vụ của tác nhân: nhanh, mạnh, giá tầm trung. | claude-opus-5-5 | Suy luận khó hơn, tái cấu trúc mã quy mô lớn, tác nhân chạy trong thời gian dài. | claude-fable-5-1 | Năng lực cao nhất và đắt nhất; dành cho các tác vụ khó nhất. | claude-haiku-4-5 | Rẻ và nhanh: tiêu đề, tóm tắt, phân loại, các bước 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ố | Những gì bạn thấy | Nguyên nhân | Cách khắc phục | 404 / NotFoundError | /v1 trong ANTHROPIC_API_BASE, nên đường dẫn trở thành /v1/v1/messages | Đặt địa chỉ gốc của máy chủ là https://aiprimetech.io, không có dấu gạch chéo ở cuối | LLM Provider NOT provided | Tên mô hình không có tiền tố nhà cung cấp | Sử dụng anthropic/claude-sonnet-5 | AuthenticationError: không thể xác thực bạn | Thiếu khóa trong shell chạy Aider, hoặc khóa dành cho endpoint khác | echo $ANTHROPIC_API_KEY; trên Windows, mở terminal mới sau khi setx | Viết lại toàn bộ tệp, không có bản đồ kho mã | Aider không nhận diện được tên mô hình | Thêm mục .aider.model.settings.yml ở trên | Unknown context window size and costs | Không có siêu dữ liệu cho mô hình | Thêm tệp siêu dữ liệu hoặc bỏ qua cảnh báo | Lỗi giới hạn token | Có quá nhiều tệp hoặc tệp quá lớn trong cuộc trò chuyện | /tokens để xem mức sử dụng, /drop các tệp, /clear lịch sử | RateLimitError | Đã đạt giới hạn đồng thời hoặc giới hạn tốc độ | Aider thử lại với thời gian chờ tăng dần; tránh chạy nhiều phiên bằng cùng một khóa | Mô hình không được hỗ trợ | ID mô hình cũ hoặc viết sai | Dùng một ID trong bảng phía trên 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](/vi/learn/claude-api-errors-troubleshooting/). ## Câu hỏi thường gặp Làm cách nào để dùng Aider với URL cơ sở Anthropic tùy chỉnh? Đặt ANTHROPIC_API_BASE thành địa chỉ gốc của máy chủ gateway, ví dụ https://aiprimetech.io, không có /v1 và không có dấu gạch chéo ở cuối, đặt ANTHROPIC_API_KEY, rồi chạy aider --model anthropic/claude-sonnet-5. LiteLLM sẽ nối thêm /v1/messages. Aider có đọc ANTHROPIC_BASE_URL không? Có, thông qua LiteLLM, như một phương án dự phòng. LiteLLM kiểm tra ANTHROPIC_API_BASE trước, rồi đến ANTHROPIC_BASE_URL. Tại sao Aider viết lại toàn bộ tệp khi dùng mô hình Claude mới? Aider không nhận diện được tên mô hình và chuyển sang định dạng chỉnh sửa toàn bộ tệp mà không có bản đồ kho mã. Thêm một mục có edit_format: diff và use_repo_map: true vào .aider.model.settings.yml. Aider có thể dùng endpoint tương thích với OpenAI không? Có: đặt OPENAI_API_BASE thành endpoint có cả /v1 và đặt OPENAI_API_KEY, rồi dùng tiền tố openai/, ví dụ aider --model openai/claude-sonnet-5. Bắt đầu sử dụng Claude chỉ trong vài phút Lấy khóa API — không cần tài khoản Anthropic hay đăng ký danh sách chờ.[Lấy khóa API của bạn](/register) 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. ## Các hướng dẫn khác về Claude API [Cách lấy khóa Claude API](/vi/learn/how-to-get-a-claude-api-key/)[Giải thích giá API Claude](/vi/learn/claude-api-pricing-explained/)[Cách tiết kiệm nhất để sử dụng Claude API](/vi/learn/cheapest-way-to-use-claude-api/)[Cursor không giới hạn với Claude API](/learn/use-claude-api-with-cursor/)[Truy cập Claude Code không giới hạn](/vi/learn/use-claude-api-with-claude-code/)[Cổng Claude API so với truy cập trực tiếp Anthropic](/vi/learn/claude-api-vs-anthropic-direct/)[Dùng Claude với SDK OpenAI: điểm cuối tương thích OpenAI, truyền luồng, công cụ và giới hạn](/vi/learn/openai-compatible-claude-api/)[Giải thích các mô hình Claude: so sánh Claude Opus, Sonnet, Haiku và Fable — tất cả mô hình API Claude, tên mô hình Anthropic và giá (2026)](/vi/learn/claude-api-models-compared/)[Thanh toán Claude API bằng tiền mã hóa](/vi/learn/claude-api-with-crypto-payment/)[Truy cập Claude API không cần vào danh sách chờ](/vi/learn/claude-api-without-waitlist/)[Cách giảm lượng token sử dụng với Claude](/vi/learn/how-to-reduce-claude-token-usage/)[Cline không giới hạn với Claude API](/vi/learn/use-claude-api-with-cline/)[Roo Code không giới hạn với Claude API](/vi/learn/use-claude-api-with-roo-code/)[Claude không giới hạn trong các IDE JetBrains](/vi/learn/use-claude-api-with-jetbrains/)[Claude không giới hạn trong VS Code](/vi/learn/use-claude-api-with-vscode/)[Cấu hình OpenCode cho Claude: thiết lập opencode.json, mô hình và các lỗi thường gặp](/vi/learn/use-claude-api-with-opencode/)[Hermes Agent với Claude qua cổng API: thiết lập nhà cung cấp tùy chỉnh, kiểm soát chi phí và cách khắc phục lỗi](/vi/learn/run-hermes-agent-with-claude-api/)[Chạy OpenClaw không giới hạn trên Claude](/vi/learn/run-openclaw-with-claude-api/)[API tương thích với Anthropic có nghĩa là gì](/vi/learn/anthropic-compatible-api/)[Khóa API Claude Code — ANTHROPIC_API_KEY: cách lấy, thiết lập và khi nào nên dùng claude setup-token thay thế](/vi/learn/claude-code-api-key-setup/)[Chi phí API Claude Code — Giá và cách cắt giảm](/vi/learn/claude-code-api-costs/)[Giải thích các lỗi API Claude: lỗi máy chủ 500, quá tải 529, giới hạn tốc độ 429, yêu cầu không hợp lệ 400 — và cách khắc phục từng lỗi](/vi/learn/claude-api-errors-troubleshooting/)[Cách mua tín dụng Claude API — và vì sao tín dụng Claude tốt hơn mọi lời chào mời "mua tài khoản Claude"](/vi/learn/buy-claude-api-credits/)[API Claude miễn phí: có khóa API Claude miễn phí không, và điều gì thực sự miễn phí trong 2026?](/vi/learn/claude-api-free-trial/)[Claude API so với gói thuê bao Claude Pro/Max — Nên chọn loại nào](/vi/learn/claude-api-vs-subscription/)[Codex CLI với nhà cung cấp tùy chỉnh: config.toml, mô hình GPT và Claude, tiện ích mở rộng IDE và cách khắc phục lỗi](/vi/learn/use-claude-api-with-codex/)[Kết nối Claude với n8n](/vi/learn/use-claude-api-with-n8n/)[Định tuyến LiteLLM tới Claude](/vi/learn/use-claude-api-with-litellm/)[Sử dụng Claude trong Kilo Code](/vi/learn/use-claude-api-with-kilo-code/)[GitHub Copilot Chat với Claude qua cổng API: thiết lập Custom Endpoint, chế độ tác tử và cách khắc phục lỗi](/vi/learn/use-claude-api-with-github-copilot/)[Kết nối Zed với Claude qua cổng API](/vi/learn/use-claude-api-with-zed/)[Kết nối Cherry Studio với Claude](/vi/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic trong LangChain: nhập, base_url, truyền dữ liệu dạng luồng, công cụ và lỗi](/vi/learn/use-claude-api-with-langchain/)[SDK Python của Anthropic: cài đặt, thiết lập base_url, truyền dữ liệu dạng luồng và xử lý lỗi](/vi/learn/anthropic-python-sdk/)[Claude với Vercel AI SDK: baseURL của createAnthropic, truyền dữ liệu dạng luồng và cách khắc phục lỗi](/vi/learn/use-claude-api-with-vercel-ai-sdk/)[Chạy Factory Droid với Claude](/vi/learn/use-claude-api-with-factory-droid/)[Giải thích API của Claude Code](/vi/learn/claude-code-api/)[Tích hợp API Claude vào ứng dụng của bạn](/vi/learn/claude-api-integration/)[Cách sử dụng Claude không giới hạn — và vì sao không có "Claude Code bẻ khóa"](/vi/learn/get-unlimited-claude-usage/)