Cài đặt Aider và cấu hình OmniProxy
Bạn muốn công cụ hỗ trợ sửa mã nhưng lo khó kiểm tra nếu các thay đổi trở nên lộn xộn? Aider xử lý tác vụ theo từng bước trong terminal và dùng Git để ghi lại khác biệt, giúp bạn dễ dàng xem xét và hoàn tác.
Aider là công cụ hỗ trợ chỉnh sửa mã trong terminal. Công cụ này tạo một bản đồ cho toàn bộ kho mã để giúp mô hình hiểu các dự án lớn hơn; còn Git là công cụ quản lý phiên bản dùng để ghi lại thay đổi trong mã, cho phép xem khác biệt và khôi phục các chỉnh sửa. Sau khi bạn giao một tác vụ cho Aider, công cụ sẽ xử lý theo từng bước và viết nội dung mô tả commit. Nếu không thích thay đổi lần này, bạn có thể dùng /undo để hoàn tác.
Chuẩn bị trước khi cài đặt
Có hai cách cài đặt phổ biến:
- Nếu máy tính đã có Python từ 3.8 đến 3.13: trước tiên hãy cài đặt
aider-install. Python là môi trường chương trình cần thiết để chạy Aider. - Nếu không có phiên bản Python phù hợp: dùng lệnh cài đặt một dòng; lệnh này cũng sẽ chuẩn bị Python 3.12 khi cần.
Mac và Linux
install.sh
- Dùng sh để chạy sau curl
- Sẽ cài Python khi cần
- Nếu không có curl thì dùng wget
Windows
install.ps1
- Chạy bằng PowerShell
- Mở lại terminal sau khi cài
- Dùng setx cho biến môi trường
Đã có Python
aider-install
- Trước tiên dùng pip cài gói này
- Sau đó chạy aider-install
- Nó sẽ tự tạo môi trường
Hãy chuẩn bị một phiên bản OmniProxy đang hoạt động. Sau khi cài đặt xong, trước tiên hãy chuyển đến thư mục dự án mà bạn định chỉnh sửa, rồi khởi động Aider.
Cài đặt và khởi động lần đầu
Nếu đã có Python từ 3.8 đến 3.13
Lần lượt chạy:
python -m pip install aider-install
aider-installaider-install sẽ cài Aider vào một môi trường Python riêng biệt để tránh trộn lẫn với các dự án Python khác trên máy tính. Khi cần, công cụ cũng sẽ cài thêm Python 3.12 dành cho Aider.
Cài đặt bằng một dòng lệnh
Trên Mac và Linux, chạy:
curl -LsSf https://aider.chat/install.sh | shNếu máy tính không có curl, bạn có thể dùng lệnh sau:
wget -qO- https://aider.chat/install.sh | shTrong Windows PowerShell, chạy:
powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"Các lệnh một dòng này dựa trên uv; uv là chương trình dùng để cài đặt và quản lý các công cụ cũng như môi trường Python. Bạn cũng có thể dùng lệnh sau:
uv tool install --force --python python3.12 --with pip aider-chat@latest
Ngoài ra, bạn cũng có thể dùng pipx. Khi cài đặt trực tiếp bằng python -m pip install aider-chat, các phiên bản Python được hỗ trợ là từ 3.9 đến 3.12, nhưng đây là phương thức cài đặt khác; nên ưu tiên các phương thức nêu trên. Aider trong trình quản lý gói của hệ thống có thể gặp tình trạng phụ thuộc không tương thích, vì vậy không nên ưu tiên cài đặt theo cách đó.
Ngày 2026-10-09, lệnh cài đặt một dòng đã cài Aider v0.86.2. Trong quá trình cài đặt, nếu có thông báo rằng bộ nhớ đệm và đích đến không nằm trên cùng một ổ đĩa nên hệ thống chuyển sang sao chép tệp, quá trình cài đặt vẫn sẽ hoàn tất.
Sau khi cài đặt xong, hãy chuyển đến thư mục dự án. Giao diện tương thích là giao diện sử dụng định dạng OpenAI để giao tiếp với các dịch vụ mô hình khác. Cách khởi động như sau:
aider --model openai/<model-name>
Trong đó, hãy thay <model-name> bằng ID mô hình đầy đủ được sao chép từ OmniProxy trong phần tiếp theo; ID mô hình là tên dùng để chỉ định chính xác mô hình.
Lấy thông số kết nối từ OmniProxy
Bạn cần đặt hai biến môi trường sau. Có thể hiểu biến môi trường là một nhóm cài đặt kết nối được chương trình trong terminal đọc:
export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>OPENAI_API_BASE là địa chỉ giao diện và bắt buộc phải kết thúc bằng /v1. OPENAI_API_KEY là khóa dùng để truy cập giao diện.
Trên Windows, dùng setx để lưu các biến. Sau khi chạy, bạn cần mở lại terminal:
setx OPENAI_API_BASE https://your-omniproxy-origin.example/v1
setx OPENAI_API_KEY <YOUR_OMNIPROXY_API_KEY>Hãy sao chép nguyên vẹn tên mô hình từ danh sách hiện tại của OmniProxy, bao gồm cả các dấu gạch chéo trong ID mô hình. Khi khởi động Aider, hãy thêm openai/ vào trước ID đầy đủ.
Ngày 2026-10-09, hai ID đối chiếu trong tài liệu của nhà cung cấp là gemini-3.8-flash và grok-4.7. Nếu danh sách hiện tại không có các tên này, đừng sao chép trực tiếp; hãy dùng ID đầy đủ thực sự có trong danh sách.
Địa chỉ
OPENAI_API_BASE
- Trỏ đến OmniProxy
- Kết thúc bằng /v1
- Không ghi vào kho mã
Khóa
OPENAI_API_KEY
- Dùng khóa do gateway cấp
- Trên Windows, phải mở lại terminal sau khi sửa
- Giữ khóa của nhà cung cấp tại gateway
Khởi động
openai/mô hình
- cd đến thư mục dự án
- Thêm openai/ trước tên mô hình
- Tên phải theo danh sách của gateway
Điền cấu hình công cụ
Bạn không cần tạo thêm tệp cấu hình tại đây. Trước tiên hãy chuyển đến thư mục dự án, sau đó khởi động Aider và thay ID mô hình bằng tên thực sự có trong danh sách hiện tại của OmniProxy:
cd /path/to/your/project
aider --model openai/gemini-3.8-flashNếu muốn chuyển sang mô hình ví dụ khác, hãy chạy:
aider --model openai/grok-4.7Khi gặp một mô hình mà Aider không nhận diện, giao diện sẽ hiển thị cảnh báo. Bản thân cảnh báo này không có nghĩa là bạn đã nhập sai địa chỉ; bạn cần kiểm tra nhật ký yêu cầu của OmniProxy để xác nhận yêu cầu này có xuất hiện hay không.
Aider chỉ đưa các tệp đã được Git theo dõi vào ngữ cảnh; ngữ cảnh là mã và thông tin mà mô hình có thể đọc trong tác vụ hiện tại. Nếu thư mục hiện tại chưa phải là kho Git, Aider sẽ tự tạo kho, nhưng các tệp chưa được Git theo dõi vẫn không thể được đọc. Hãy dùng git add để thêm các tệp và commit chúng trước khi khởi động Aider.
Aider vẫn có thể sửa đổi tệp. --no-auto-commits chỉ tắt commit tự động, không ngăn tệp bị thay đổi. Khi sử dụng lần đầu, bạn nên chọn một kho không quan trọng và chạy git diff sau khi hoàn tất tác vụ để xem các thay đổi thực tế.
Không ghi khóa thật vào tệp dự án hoặc trang công khai. Khóa của nhà cung cấp chỉ nên được lưu trong OmniProxy. Nếu cổng kết nối không xác thực khóa, bạn có thể điền vào OPENAI_API_KEY một chuỗi giữ chỗ chỉ được dùng trên máy cục bộ.
Xác minh bằng một tác vụ thực tế
Trước tiên, hãy bảo đảm tệp cần đọc đã được commit vào Git, sau đó chạy lệnh dưới đây trong thư mục dự án. Bạn cần thay ID mô hình bằng ID đầy đủ trong danh sách hiện tại của OmniProxy:
aider --model openai/gemini-3.8-flash --message "Dòng đầu tiên của tệp này là gì? Không sửa đổi tệp." --no-auto-commits--message dùng để giao trực tiếp một tác vụ cho Aider, còn --no-auto-commits có nghĩa là không tự động tạo commit Git trong lần chạy này.
Ngày 2026-10-09, Aider v0.86.2 đã đọc thành công dòng đầu tiên của một tệp được theo dõi. Nếu tệp chưa được Git theo dõi, Aider sẽ trả lời rằng không thể xem nội dung; điều này không có nghĩa là địa chỉ giao diện bị sai. Sau khi hoàn tất câu hỏi, hãy kiểm tra nhật ký yêu cầu của OmniProxy để đối chiếu nguồn yêu cầu và ID mô hình.
Khởi động
aider khởi chạy được
- Tìm thấy lệnh
- Biến môi trường đã có hiệu lực
- Đang ở thư mục dự án
Tác vụ
Đã đọc tệp
- Hỏi về một tệp cụ thể
- Xem phần giải thích của nó
- Mô hình không quen thuộc sẽ có cảnh báo
Nhật ký
Có thể thấy trên gateway
- Nguồn là Aider
- ID mô hình khớp
- Khóa không xuất hiện trên trang
Lỗi thường gặp
- Không tìm thấy
aider: trước tiên hãy mở lại terminal. Nếu cài đặt trực tiếp bằng pip, bạn có thể thửpython -m aider. - Windows vẫn kết nối đến địa chỉ cũ sau khi thay đổi biến: sau khi chạy
setx, bạn phải mở lại terminal; chỉ cửa sổ mới mới đọc các biến đã cập nhật. - Tên mô hình không có
openai/ở đầu: giao diện tương thích yêu cầu định dạngopenai/<model-name>. - Xuất hiện cảnh báo về mô hình không được nhận diện: đây là cảnh báo bình thường, không đồng nghĩa với việc kết nối thất bại. Tiếp theo, hãy kiểm tra xem OmniProxy có nhận được yêu cầu hay không.
- ID mô hình không hợp lệ: sao chép lại ID đầy đủ từ danh sách hiện tại của OmniProxy, giữ nguyên tiền tố
openai/và mọi dấu gạch chéo vốn có trong ID. - Công cụ báo không có nội dung tệp: trước tiên hãy xác nhận tệp đã được Git theo dõi. Kho trống hoặc tệp chưa được theo dõi sẽ không được đưa vào ngữ cảnh.
Tài liệu tham khảo chính thức
Xem các bước cài đặt tại Aider installation. Xem biến môi trường và tiền tố mô hình tại OpenAI compatible APIs. Có thể xem các ID mô hình dùng làm ví dụ trong danh sách mô hình Gemini và trang mô hình xAI.
Thay thế mọi chỗ giữ chỗ bằng giá trị từ cấu hình OmniProxy của riêng bạn. Không bao giờ công bố khóa thật.
Kết quả được lưu hoặc mã HTTP 200 đơn lẻ không chứng minh khả năng tương thích đầy đủ của Agent. Hãy kiểm tra nguồn và mô hình trong bản ghi lệnh gọi của OmniProxy.