Aider: lập trình cặp AI trong terminal — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về Aider-AI/aider — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: Aider: lập trình cùng AI trong terminal — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Aider là công cụ lập trình cặp với mô hình ngôn ngữ lớn ngay trong terminal, có thể làm việc với dự án mới hoặc codebase có sẵn. Công cụ hỗ trợ nhiều mô hình cloud và local, lập bản đồ codebase, tích hợp Git và tự chạy lint, test. Cài đặt khá đơn giản nếu bạn có Python phù hợp và API key của mô hình muốn dùng.
Aider là một CLI lập trình cặp với AI, chạy ngay trong terminal và làm việc trực tiếp với codebase của bạn. Bạn có thể dùng Aider để bắt đầu dự án mới, sửa code hiện có, viết tính năng, tạo test hoặc tìm lỗi bằng cách trò chuyện với mô hình ngôn ngữ.
Repo này hợp với lập trình viên mới, dev làm việc một mình, đội nhóm muốn tăng tốc các việc lặp lại và người thích kiểm soát code bằng Git. Điểm đáng giá nhất là Aider không chỉ trả lời bằng đoạn code rời rạc. Nó lập bản đồ toàn bộ codebase để hiểu quan hệ giữa các file, sau đó đề xuất hoặc thực hiện thay đổi trong dự án. Repo hiện có khoảng 50.104 sao và 5.163 fork, dùng giấy phép Apache-2.0.
Aider-AI/aider
Aider là CLI AI giúp bạn viết, sửa, kiểm thử và quản lý thay đổi mã nguồn ngay trong terminal.
I.Aider làm được gì
A.Làm việc với mô hình cloud và local
Aider kết nối được với nhiều mô hình ngôn ngữ. README nói công cụ hoạt động tốt với Claude 3.7 Sonnet, DeepSeek R1, DeepSeek Chat V3, OpenAI o1, o3-mini và GPT-4o. Aider cũng có thể kết nối với gần như bất kỳ mô hình nào, bao gồm cả mô hình chạy cục bộ.
Lợi ích thực tế là bạn có thể chọn mô hình theo ngân sách, chất lượng hoặc yêu cầu riêng của dự án. Nếu một mô hình không phù hợp, bạn có thể khởi chạy lại Aider với mô hình khác mà vẫn làm việc trên cùng codebase.
B.Hiểu cấu trúc codebase
Aider tạo một bản đồ của toàn bộ codebase. Bản đồ này giúp công cụ làm việc tốt hơn với các dự án lớn, nơi một thay đổi trong file này có thể ảnh hưởng đến nhiều file khác.
Với người mới, đây là điểm hữu ích khi bạn chưa quen cấu trúc dự án. Bạn có thể mô tả mục tiêu bằng ngôn ngữ tự nhiên, còn Aider dùng ngữ cảnh của codebase để tìm những phần liên quan.
C.Hỗ trợ hơn 100 ngôn ngữ lập trình
Aider làm việc với hầu hết ngôn ngữ phổ biến như Python, JavaScript, Rust, Ruby, Go, C++, PHP, HTML và CSS. README cũng nói công cụ hỗ trợ hàng chục ngôn ngữ khác.
Bạn không bị buộc phải đổi công cụ khi chuyển dự án hoặc ngôn ngữ. Một phiên làm việc có thể tập trung vào backend, giao diện web, script tự động hóa hoặc các file cấu hình trong cùng quy trình terminal.
D.Tích hợp Git
Aider có thể tự commit các thay đổi với thông điệp commit dễ hiểu. Bạn vẫn dùng được những lệnh Git quen thuộc để xem diff, quản lý phiên bản và hoàn tác thay đổi do AI tạo ra.
Điều này hữu ích khi bạn muốn thử một thay đổi lớn nhưng vẫn giữ đường lui rõ ràng. Trước khi chấp nhận kết quả, bạn có thể kiểm tra diff và dùng quy trình Git quen thuộc để quyết định giữ, sửa hoặc hoàn tác.
E.Dùng trong IDE hoặc trình soạn thảo
Bạn có thể dùng Aider bên trong IDE hoặc editor yêu thích. README mô tả cách yêu cầu thay đổi bằng việc thêm comment vào code để Aider đọc và xử lý.
Cách này phù hợp khi bạn đã mở sẵn dự án trong trình soạn thảo nhưng muốn giao một phần việc cho AI. Terminal vẫn là nơi chạy Aider, còn editor là nơi bạn xem và tiếp tục chỉnh code.
F.Đưa ảnh và trang web vào ngữ cảnh trò chuyện
Aider có thể nhận ảnh và trang web để làm ngữ cảnh. Bạn có thể dùng ảnh chụp màn hình, tài liệu tham khảo hoặc nội dung trang web khi yêu cầu AI xử lý code.
Ví dụ thực tế là đưa ảnh giao diện cần dựng hoặc tài liệu API liên quan đến tính năng. Tuy nhiên, README được cung cấp không ghi cú pháp cụ thể cho việc thêm ảnh hoặc trang web, nên bạn cần xem hướng dẫn sử dụng tương ứng trong repo.
G.Điều khiển bằng giọng nói
Aider hỗ trợ trao đổi về code bằng giọng nói. Bạn có thể yêu cầu tạo tính năng, viết test hoặc sửa lỗi bằng cách nói thay vì gõ toàn bộ yêu cầu.
Tính năng này có thể hữu ích khi bạn đang phác thảo ý tưởng hoặc muốn mô tả một lỗi dài. Tư liệu không nêu chi tiết thiết bị, dịch vụ nhận dạng giọng nói hay cách bật tính năng.
H.Tự chạy lint và test
Aider có thể tự động lint và test mỗi khi thực hiện thay đổi. Nếu bộ lint hoặc test phát hiện lỗi, Aider có thể tiếp tục sửa các vấn đề đó.
Đây là tính năng quan trọng khi bạn muốn giảm số lần chuyển qua lại giữa terminal, trình soạn thảo và công cụ kiểm thử. Kết quả vẫn cần được bạn đọc và kiểm tra, vì test không thể bảo đảm mọi thay đổi đều đúng với yêu cầu kinh doanh.
I.Làm việc với giao diện web của mô hình
Nếu bạn dùng một mô hình qua giao diện chat trên web, Aider có thể hỗ trợ quy trình copy và paste code, ngữ cảnh cũng như phần chỉnh sửa qua lại với trình duyệt.
Nhờ đó, bạn vẫn có thể tổ chức công việc quanh codebase thay vì tự chọn từng đoạn code để gửi. README không nêu rõ giới hạn, mô hình hoặc quy trình xác thực cụ thể cho cách dùng này.
II.Cần chuẩn bị gì
Bạn cần một máy có Python từ 3.10 đến thấp hơn 3.15. Đây là yêu cầu được khai báo trong pyproject.toml. Tên gói Python của dự án là aider-chat.
Bạn cần terminal và một thư mục codebase muốn Aider làm việc cùng. README hướng dẫn chuyển vào thư mục dự án trước khi chạy Aider. Nếu bắt đầu dự án mới, tư liệu được cung cấp không nêu riêng một lệnh tạo thư mục hoặc khởi tạo Git.
Bạn cần API key tương ứng với mô hình muốn dùng. Ví dụ trong README dùng key cho DeepSeek, Anthropic hoặc OpenAI. Key được truyền qua tùy chọn --api-key khi khởi động Aider.
Bạn không được tự suy ra rằng phải có GPU. README nói Aider có thể kết nối với mô hình local nhưng không nêu yêu cầu phần cứng, dung lượng bộ nhớ hay GPU cụ thể. Tương tự, tư liệu không nói rõ hệ điều hành nào được hỗ trợ.
Mã nguồn dùng giấy phép Apache-2.0. Chi phí sử dụng mô hình, hạn mức API và chính sách lưu dữ liệu không được nêu trong phần tư liệu này. Bạn nên kiểm tra dịch vụ mô hình mình chọn trước khi dùng key thật.
III.Cài đặt từng bước
- Kiểm tra môi trườngBảo đảm Python nằm trong khoảng được dự án yêu cầu
- Cài trình cài AiderCài gói aider-install bằng pip
- Chạy trình càiDùng aider-install để cài Aider
- Vào codebaseMở terminal tại thư mục dự án cần làm việc
- Chọn mô hìnhChạy Aider cùng mô hình và API key tương ứng
A.Kiểm tra Python và mở terminal
Cài đặt cần được thực hiện trong terminal. Trước tiên, bạn nên kiểm tra mình đang dùng Python phiên bản nào và bảo đảm phiên bản đó từ 3.10 đến thấp hơn 3.15, vì đây là điều kiện trong pyproject.toml.
README không cung cấp lệnh kiểm tra phiên bản Python cụ thể. Bạn có thể xem phiên bản bằng công cụ có sẵn trên hệ điều hành, nhưng không nên coi một lệnh chưa xuất hiện trong README là quy trình cài đặt chính thức của dự án.
Hãy mở terminal tại thư mục chứa codebase. Người dùng Windows có thể mở PowerShell tại thư mục dự án; README không nêu riêng hướng dẫn Windows, nên tên lệnh và cách kích hoạt Python có thể khác tùy môi trường.
B.Cài gói trình cài
README cung cấp lệnh sau để cài aider-install:
python -m pip install aider-installLệnh này gọi pip thông qua Python và cài gói aider-install. Dùng python -m pip giúp bạn cài gói vào đúng môi trường Python đang được gọi bởi lệnh python.
Nếu terminal báo không tìm thấy python, bạn cần sửa lại cài đặt Python hoặc dùng đúng lệnh gọi Python của môi trường hiện tại. Tư liệu được cung cấp không đưa ra lệnh thay thế, vì vậy không nên tự thêm tên gói hoặc cờ chưa được README nói đến.
C.Chạy trình cài Aider
Sau khi cài gói trình cài, chạy:
aider-installLệnh này thực hiện bước cài Aider theo quy trình của dự án. Bạn nên chờ lệnh hoàn tất trước khi sang bước tiếp theo. Nếu terminal báo lỗi quyền, môi trường Python hoặc mạng, README được cung cấp không nêu cách xử lý chi tiết; hãy xem phần Installation Guide hoặc cấu trúc khai báo trong pyproject.toml và requirements.txt của repo.
D.Chuyển vào codebase
README yêu cầu đổi thư mục vào codebase trước khi chạy Aider:
cd /to/your/projectBạn thay /to/your/project bằng đường dẫn thật đến dự án của mình. Đây là đường dẫn mẫu có trong README, không phải thư mục bắt buộc phải tồn tại. Hãy mở terminal ở đúng nơi hoặc thay đường dẫn bằng đường dẫn của dự án cần sửa.
Nếu bạn chạy Aider ở sai thư mục, công cụ có thể không thấy các file bạn muốn làm việc cùng. Trước khi gửi yêu cầu, hãy xác nhận thư mục hiện tại là codebase cần chỉnh sửa.
E.Khởi động với DeepSeek
README đưa ra ví dụ chạy với DeepSeek:
aider --model deepseek --api-key deepseek=<key>Thay <key> bằng API key thật của dịch vụ DeepSeek. Không dán key vào đoạn code, commit hoặc nơi người khác có thể xem. Lệnh này chọn tên mô hình deepseek và truyền key dưới tên dịch vụ deepseek.
F.Khởi động với Claude
Ví dụ cho Claude 3.7 Sonnet là:
aider --model sonnet --api-key anthropic=<key>Thay <key> bằng API key Anthropic của bạn. Tên mô hình và tên dịch vụ trong lệnh là hai phần riêng: sonnet chọn mô hình, còn anthropic=<key> cung cấp thông tin xác thực.
G.Khởi động với o3-mini
README cũng có ví dụ cho o3-mini:
aider --model o3-mini --api-key openai=<key>Thay <key> bằng API key OpenAI. Chỉ chạy một trong các ví dụ trên tùy dịch vụ bạn đã có quyền sử dụng. README không nói rằng một key có thể dùng cho dịch vụ khác.
API key có thể phát sinh chi phí theo chính sách của nhà cung cấp mô hình. Hãy kiểm tra đúng dịch vụ, bảo vệ key và xem diff trước khi cho phép Aider ghi thay đổi vào codebase.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra cơ bản là chạy một trong ba lệnh khởi động trong README sau khi đã vào codebase và điền API key. Nếu Aider khởi động được với mô hình đã chọn, bạn đã hoàn thành phần cài đặt tối thiểu.
Bạn cũng có thể kiểm tra bằng cách gửi một yêu cầu nhỏ, chẳng hạn yêu cầu Aider giải thích cấu trúc dự án hoặc chỉ ra file liên quan đến một chức năng. Kết quả mong đợi là Aider có thể làm việc với codebase trong terminal và dùng ngữ cảnh từ bản đồ codebase.
Khi Aider thực hiện thay đổi, hãy dùng Git để xem diff và kiểm tra commit nếu công cụ tạo commit tự động. README xác nhận Aider có tích hợp Git, nhưng không đưa ra một lệnh kiểm tra cụ thể hoặc màn hình đầu ra cố định.
Nếu muốn xác nhận lint và test, hãy dùng một thay đổi nhỏ trong dự án đã có sẵn bộ lint hoặc test. Tư liệu nói Aider có thể tự động chạy chúng, nhưng không cung cấp lệnh test, tên framework hoặc kết quả mẫu.
V.Dùng vào việc thật
A.Chủ shop cần chỉnh trang bán hàng
Một chủ shop có website bán hàng bằng HTML, CSS và JavaScript muốn đổi màu nút mua hàng, sửa bố cục trên màn hình nhỏ và giữ nguyên luồng thanh toán. Bạn mở terminal trong codebase rồi khởi động Aider với mô hình đã cấu hình.
Bạn có thể yêu cầu: Hãy tìm phần giao diện nút mua hàng, đổi màu theo bộ nhận diện hiện có và kiểm tra các file CSS, JavaScript liên quan. Chỉ sửa những file cần thiết.
Aider có thể dùng bản đồ codebase để tìm các file liên quan, sau đó tạo thay đổi. Bạn xem diff bằng Git trước khi chấp nhận. Tình huống này phù hợp vì Aider hỗ trợ HTML, CSS, JavaScript và giúp bạn trao đổi trực tiếp với code thay vì tự tìm từng file.
B.Nhân viên văn phòng có script báo cáo
Một nhân viên văn phòng có script Python để tổng hợp dữ liệu nhưng chưa hiểu rõ cấu trúc mã. Bạn mở codebase và yêu cầu: Hãy giải thích luồng xử lý từ file đầu vào đến báo cáo cuối cùng, chưa sửa code.
Sau khi hiểu dự án, bạn có thể yêu cầu: Hãy thêm kiểm tra khi file đầu vào bị thiếu cột, viết test cho trường hợp đó và chạy bộ test hiện có.
Aider có thể hỗ trợ giải thích, viết test và sửa lỗi phát hiện qua test. README xác nhận công cụ làm việc với Python và có khả năng tự chạy lint, test, nhưng không bảo đảm nó biết quy tắc nghiệp vụ riêng của báo cáo. Bạn vẫn cần kiểm tra số liệu đầu ra.
C.Dev mới thêm tính năng vào API
Một dev mới nhận dự án backend bằng Python hoặc Go và cần thêm một endpoint. Bạn có thể yêu cầu: Hãy tìm cách các endpoint hiện tại được tổ chức, đề xuất các file cần sửa để thêm endpoint tạo đơn hàng, sau đó chờ tôi xác nhận.
Khi đã hiểu kế hoạch, bạn tiếp tục: Hãy triển khai endpoint theo mẫu hiện có, thêm test cho trường hợp thành công và lỗi dữ liệu không hợp lệ.
Aider có thể dùng bản đồ codebase để theo dõi nhiều file liên quan, rồi dùng Git để ghi nhận thay đổi. Cách yêu cầu theo từng phần giúp bạn kiểm soát tốt hơn thay vì giao một mục tiêu quá rộng ngay từ đầu.
D.Dev sửa lỗi qua ảnh chụp màn hình
Một dev frontend nhận ảnh chụp màn hình cho thấy giao diện bị lệch. Aider hỗ trợ đưa ảnh và trang web vào ngữ cảnh, nên bạn có thể dùng ảnh làm tài liệu tham khảo rồi yêu cầu: Hãy tìm nguyên nhân khiến bố cục trên màn hình này bị lệch và đề xuất thay đổi tối thiểu.
README không nêu cú pháp cụ thể để đính kèm ảnh hoặc trang web. Vì vậy, bạn cần xem tài liệu sử dụng trong repo trước khi thực hiện chính xác thao tác này. Sau khi Aider sửa code, hãy kiểm tra giao diện và xem diff.
Aider hữu ích nhất khi bạn giao cho AI một mục tiêu rõ ràng, rồi vẫn giữ quyền kiểm tra từng thay đổi trong Git.
Ông T
VI.Lỗi hay gặp và cách xử lý
A.Python không đúng phiên bản
pyproject.toml yêu cầu Python từ 3.10 đến thấp hơn 3.15. Nếu môi trường dùng phiên bản ngoài khoảng này, cài đặt có thể không tương thích. Hãy kiểm tra lại Python đang được terminal gọi và dùng phiên bản đáp ứng yêu cầu của dự án.
B.Cài gói nhưng không tìm thấy lệnh
Bạn có thể cài aider-install vào một môi trường Python nhưng terminal lại gọi môi trường khác. Hãy kiểm tra lại môi trường Python hiện tại và chạy lại theo đúng hai lệnh README cung cấp. Tư liệu chưa nêu cách sửa PATH cụ thể cho từng hệ điều hành.
C.API key sai hoặc đặt sai dịch vụ
Mỗi ví dụ dùng cặp tên riêng, như deepseek=<key>, anthropic=<key> hoặc openai=<key>. Hãy kiểm tra bạn đã thay <key> bằng key thật và chọn đúng tên dịch vụ tương ứng với mô hình. Không công khai key trong codebase hoặc commit Git.
D.Chạy ở sai thư mục
README yêu cầu chuyển vào codebase trước khi chạy Aider. Nếu chạy tại thư mục khác, công cụ có thể không có đúng ngữ cảnh hoặc file bạn muốn sửa. Hãy đóng phiên và chạy lại sau khi dùng cd đến dự án chính xác.
E.Thay đổi của AI chưa đúng yêu cầu
Aider có thể sửa nhiều file hoặc hiểu sai quy tắc nghiệp vụ. Hãy yêu cầu theo phạm vi nhỏ, xem diff, chạy lint và test, rồi mới giữ thay đổi. Tích hợp Git giúp bạn quản lý và hoàn tác thay đổi, nhưng không thay thế việc review của con người.
VII.Có nên dùng không
Bạn nên chọn Aider nếu muốn một trợ lý AI chạy trong terminal, làm việc trực tiếp với codebase, hỗ trợ nhiều mô hình và kết hợp với Git. Công cụ đặc biệt phù hợp với dev thích quy trình dựa trên terminal, muốn AI hiểu nhiều file cùng lúc và muốn lint, test, diff nằm trong cùng vòng lặp.
Điểm mạnh là hỗ trợ cả mô hình cloud lẫn local, làm việc với nhiều ngôn ngữ, có bản đồ codebase và có thể tự commit thay đổi. Giấy phép Apache-2.0 cũng là một điểm đáng chú ý khi bạn cần xem xét cách sử dụng mã nguồn.
Giới hạn là bạn vẫn cần tự cung cấp API key hoặc cấu hình mô hình. Chi phí mô hình, yêu cầu phần cứng cho mô hình local, chính sách dữ liệu và hướng dẫn Windows cụ thể chưa được nêu trong tư liệu này. README cũng cho biết repo đã lâu chưa cập nhật, nên bạn cần kiểm tra tình trạng tương thích với môi trường hiện tại trước khi đưa vào quy trình quan trọng.
Nếu bạn cần một giao diện đồ họa hoàn chỉnh, một IDE tích hợp sẵn hoặc công cụ có tài liệu hệ điều hành cụ thể hơn, hãy cân nhắc giải pháp khác. Nếu mục tiêu là lập trình cặp bằng AI trong terminal và bạn muốn giữ quy trình kiểm soát bằng Git, Aider là lựa chọn đáng thử.
Câu hỏi thường gặp
Aider có miễn phí không?
Mã nguồn dùng giấy phép Apache-2.0. Tuy nhiên, README không nói chi phí sử dụng các mô hình cloud; API key của nhà cung cấp có thể có hạn mức hoặc chi phí riêng.
Aider có cần GPU không?
Tư liệu chỉ nói Aider có thể kết nối với mô hình local và mô hình cloud. README không nêu yêu cầu GPU, RAM hay phần cứng cụ thể.
Aider có chạy được trên Windows không?
Tư liệu được cung cấp không nêu rõ hệ điều hành được hỗ trợ hoặc hướng dẫn Windows riêng. Bạn cần kiểm tra thêm tài liệu cài đặt của dự án trước khi triển khai trên Windows.
Aider cần Python phiên bản nào?
`pyproject.toml` yêu cầu Python từ 3.10 đến thấp hơn 3.15. Tên gói Python của dự án là `aider-chat`.
Tôi cần API key nào để dùng Aider?
Bạn cần key tương ứng với mô hình đã chọn. README có ví dụ cho DeepSeek, Anthropic và OpenAI bằng các tùy chọn `deepseek=<key>`, `anthropic=<key>` và `openai=<key>`.
Aider có tự sửa code và chạy test không?
Aider có thể thực hiện thay đổi trong codebase, tự động lint và test sau thay đổi theo README. Bạn vẫn nên xem diff và kiểm tra kết quả vì tư liệu không bảo đảm mọi thay đổi đều đúng.
Aider có làm việc với codebase lớn không?
Có. Aider tạo bản đồ của toàn bộ codebase để làm việc tốt hơn với dự án lớn. README không nêu giới hạn kích thước cụ thể.


