# Aider: lập trình cùng AI trong terminal — hướng dẫn cài đặt và dùng

> Aider là công cụ pair programming với AI trong terminal, có thể làm việc trên dự án mới hoặc codebase đang có. Công cụ hỗ trợ nhiều mô hình cloud và local, lập bản đồ codebase, chỉnh sửa hơn 100 ngôn ngữ và tích hợp Git. README có hướng dẫn cài nhanh bằng Python, nhưng bạn vẫn cần API key của nhà cung cấp mô hình nếu dùng các lệnh mẫu.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-07-09 · Cập nhật: 2026-11-14
- URL: https://ongt.vn/bai-viet/aider-ai-aider-lap-trinh-cung-ai-trong-terminal

Aider là công cụ lập trình cùng AI chạy trực tiếp trong terminal. Bạn có thể dùng nó để bắt đầu dự án mới, đọc một codebase đang có, yêu cầu sửa lỗi, thêm tính năng hoặc viết test bằng ngôn ngữ tự nhiên.

Điểm đáng giá nhất của Aider là nó không chỉ trả về một đoạn code rời rạc. Công cụ lập bản đồ toàn bộ codebase để hiểu mối liên hệ giữa các tệp, sau đó cập nhật code trong dự án của bạn. Aider cũng tự động tạo commit Git với thông điệp phù hợp, nên bạn có thể xem diff, quản lý và hoàn tác thay đổi bằng các lệnh Git quen thuộc.

Aider phù hợp với lập trình viên mới muốn có trợ lý giải thích và sửa code, dev làm việc trên dự án Python, JavaScript, Rust, Go hoặc nhiều ngôn ngữ khác, và đội nhóm muốn thử quy trình AI trong terminal. Người dùng không muốn rời terminal khi làm việc với mô hình AI cũng sẽ thấy công cụ này thuận tiện.

```repo
- repo | Aider-AI/aider
- kind | CLI
- desc | Aider là trợ lý lập trình AI chạy trong terminal, giúp đọc code, sửa tính năng, tạo test và làm việc cùng Git.
- stars | 50k
- lang | Python
- license | Apache-2.0
```

## Aider làm được gì

### Làm việc với mô hình cloud và local

Aider có thể kết nối với nhiều mô hình ngôn ngữ khác nhau, gồm các mô hình cloud và mô hình chạy local. README nêu các lựa chọn như Claude, DeepSeek, OpenAI và Gemini trong chủ đề của dự án. Bạn có thể chọn mô hình phù hợp với ngân sách, chất lượng mong muốn hoặc yêu cầu riêng tư của dự án.

Lợi ích thực tế là bạn không bị khóa vào một mô hình duy nhất. Khi một mô hình không xử lý tốt nhiệm vụ, bạn có thể thử mô hình khác bằng tùy chọn `--model`.

### Lập bản đồ codebase

Aider tạo 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 trên các dự án lớn, nơi một tính năng có thể liên quan đến nhiều tệp và nhiều thư mục.

Với người mới, đây là điểm quan trọng vì bạn không phải tự sao chép từng tệp vào một cuộc trò chuyện web. Aider có thể làm việc từ thư mục dự án và dùng cấu trúc codebase làm ngữ cảnh.

### Hỗ trợ hơn 100 ngôn ngữ lập trình

README cho biết Aider làm việc với hầu hết ngôn ngữ phổ biến, trong đó có Python, JavaScript, Rust, Ruby, Go, C++, PHP, HTML và CSS.

Bạn có thể dùng cùng một quy trình để yêu cầu sửa một API Python, điều chỉnh giao diện HTML/CSS hoặc viết thêm logic cho chương trình Go. Cách dùng cụ thể vẫn phụ thuộc vào chất lượng mô hình và codebase của bạn.

### Tích hợp Git

Aider tự động commit các thay đổi với commit message hợp lý. Bạn vẫn có thể dùng các công cụ 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 giúp giảm rủi ro khi thử một yêu cầu lớn. Nếu kết quả chưa đúng, bạn có thể kiểm tra thay đổi trước khi đưa vào nhánh chính hoặc hoàn tác bằng Git.

### Dùng trong IDE hoặc editor

Bạn có thể dùng Aider bên trong IDE hoặc trình soạn thảo yêu thích. Theo README, một cách làm là thêm comment yêu cầu thay đổi vào code, sau đó để Aider xử lý.

Cách này phù hợp khi bạn đang đọc một tệp trong editor nhưng vẫn muốn giao phần chỉnh sửa cho trợ lý chạy ở terminal.

### Thêm hình ảnh và trang web vào cuộc trò chuyện

Aider có thể nhận hình ả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 của một trang web khi giải thích yêu cầu.

Ví dụ, khi giao diện bị lệch, ảnh chụp màn hình có thể giúp mô tả vấn đề rõ hơn. Khi cần triển khai một API, trang tài liệu có thể cung cấp thêm thông tin tham khảo cho cuộc trò chuyện.

### Điều khiển bằng giọng nói

README cho biết Aider hỗ trợ voice-to-code. Bạn có thể nói yêu cầu về tính năng, test hoặc bug fix để Aider triển khai.

Tính năng này hữu ích khi bạn muốn mô tả ý tưởng nhanh hoặc đang không tiện gõ một yêu cầu dài. Tư liệu được cung cấp chưa nêu chi tiết thiết bị hay cách bật tính năng này.

### Tự động lint và test

Aider có thể tự động chạy lint và test mỗi khi thay đổi code. Nếu linter hoặc test phát hiện lỗi, Aider có thể tiếp tục sửa các vấn đề đó.

Đây là cách giảm vòng lặp thủ công: yêu cầu thay đổi, chạy kiểm tra, đọc lỗi và sửa lại có thể được kết hợp trong cùng một quy trình. Tuy vậy, bạn vẫn nên xem diff và kết quả test trước khi chấp nhận thay đổi.

### Làm việc với web chat bằng copy/paste

Nếu bạn muốn dùng một mô hình thông qua giao diện web chat, Aider cũng hỗ trợ quy trình copy/paste code và ngữ cảnh qua lại với trình duyệt.

Tính năng này mở rộng lựa chọn mô hình khi bạn không dùng kết nối API trực tiếp. README không nêu chi tiết giới hạn hoặc quy trình cụ thể của từng dịch vụ web chat.

## Cần chuẩn bị gì

Bạn cần Python thuộc khoảng phiên bản từ 3.10 đến trước 3.15. Đây là yêu cầu được khai báo trong `pyproject.toml` của repo.

Bạn cần một codebase để Aider làm việc cùng. Có thể là dự án mới hoặc dự án đã tồn tại. Khi dùng dự án có sẵn, bạn cần mở terminal và chuyển vào đúng thư mục codebase trước khi chạy Aider.

Bạn cần cài gói Python `aider-chat`. README cung cấp cách cài nhanh thông qua gói `aider-install`, sau đó chạy lệnh `aider-install`.

Bạn cần API key tương ứng với mô hình muốn dùng nếu chạy các ví dụ trong README. Các ví dụ dùng key cho DeepSeek, Anthropic hoặc OpenAI. README không nói API key có miễn phí hay không, nên bạn cần tự kiểm tra chính sách và chi phí của nhà cung cấp mô hình trước khi sử dụng.

Bạn cần Git nếu muốn tận dụng quy trình commit, xem diff, quản lý và hoàn tác thay đổi. README mô tả tích hợp Git nhưng phần tư liệu được cung cấp không ghi một lệnh cài Git cụ thể.

README không nêu yêu cầu GPU, dung lượng RAM tối thiểu hay hệ điều hành cụ thể. Vì vậy, chưa thể kết luận rằng Aider cần GPU hoặc hỗ trợ chính thức một hệ điều hành nhất định chỉ từ tư liệu này.

```note
API key có thể phát sinh chi phí từ nhà cung cấp mô hình. Không đưa key vào code, commit Git hoặc tệp chia sẻ công khai. Hãy xem kỹ thay đổi do AI tạo ra trước khi chạy trên dự án thật.
```

## Cài đặt từng bước

```steps
- Cài trình cài Aider | Cài gói aider-install bằng pip
- Chạy trình cài | Chạy aider-install để cài Aider
- Mở codebase | Chuyển terminal vào thư mục dự án
- Chọn mô hình | Chạy Aider với model và API key tương ứng
```

### Cài gói trình cài

Mở terminal trên máy đã có Python phù hợp, sau đó chạy lệnh sau. Đây là lệnh cài `aider-install` được README cung cấp:

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

`python -m pip` yêu cầu Python chạy công cụ pip để cài gói. Cách viết này giúp pip được gọi từ phiên bản Python mà bạn đang dùng.

Nếu terminal báo không tìm thấy `python`, hãy kiểm tra lại Python đã được cài và có thể gọi từ terminal hay chưa. README chỉ yêu cầu Python từ 3.10 đến trước 3.15, không cung cấp hướng dẫn xử lý riêng cho từng hệ điều hành.

### Chạy trình cài Aider

Sau khi cài gói trình cài, chạy:

```bash
aider-install
```

Lệnh này là bước cài Aider theo hướng dẫn nhanh trong README. Khi lệnh hoàn tất, bạn cần kiểm tra xem lệnh `aider` có thể được gọi từ terminal hay chưa.

Nếu terminal không nhận `aider`, nguyên nhân thường gặp là thư mục chứa chương trình chưa có trong PATH hoặc quá trình cài chưa hoàn tất. README được cung cấp không ghi lệnh chẩn đoán cụ thể, nên bạn nên xem phần installation instructions và troubleshooting trong tài liệu của dự án.

### Chuyển vào thư mục codebase

Aider làm việc với thư mục codebase hiện tại. Dùng `cd` để chuyển vào dự án của bạn:

```bash
cd /to/your/project
```

Trong README, `/to/your/project` là đường dẫn mẫu. Bạn cần thay bằng đường dẫn thật đến thư mục dự án trên máy. Hãy mở terminal tại vị trí bạn dễ xác định, rồi kiểm tra mình đang ở đúng thư mục trước khi yêu cầu Aider sửa code.

Nếu chạy Aider ở nhầm thư mục, công cụ có thể không thấy các tệp bạn muốn làm việc cùng hoặc lập bản đồ không đúng codebase. Đây là lỗi dễ gặp với người mới.

### Chạy với DeepSeek

README đưa ra ví dụ dùng mô hình DeepSeek:

```bash
aider --model deepseek --api-key deepseek=<key>
```

`--model deepseek` chọn mô hình có tên `deepseek`. `--api-key deepseek=<key>` truyền API key cho nhà cung cấp này. Bạn cần thay `<key>` bằng key thật của mình.

Không dán key vào nơi người khác có thể nhìn thấy. Đặc biệt, không đưa nguyên dòng lệnh có key vào lịch sử chia sẻ, tài liệu nội bộ công khai hoặc commit Git.

### Chạy với Claude

README cung cấp ví dụ dùng Claude:

```bash
aider --model sonnet --api-key anthropic=<key>
```

Lệnh chọn model bằng `--model sonnet` và cung cấp key Anthropic qua `--api-key anthropic=<key>`. Thay phần `<key>` bằng API key thật.

Tên model và quyền truy cập phụ thuộc vào cấu hình được Aider và nhà cung cấp hỗ trợ. Nếu lệnh báo model hoặc key không hợp lệ, hãy kiểm tra lại tài liệu kết nối mô hình của dự án.

### Chạy với o3-mini

Ví dụ thứ ba trong README là:

```bash
aider --model o3-mini --api-key openai=<key>
```

Ở đây, `--model o3-mini` chọn mô hình và `openai=<key>` cung cấp key cho OpenAI. Bạn cần chạy lệnh từ thư mục codebase đã chọn.

Ba ví dụ trên minh họa cùng một mẫu: chọn mô hình bằng `--model`, rồi cung cấp key với tên nhà cung cấp tương ứng. README còn nói Aider có thể kết nối với gần như bất kỳ LLM nào, kể cả mô hình local, nhưng tư liệu được cung cấp không có lệnh cấu hình chi tiết cho từng loại.

Nếu cần cách cài hoặc cấu hình khác, hãy xem `README.md`, thư mục `aider/`, `requirements.txt`, `pyproject.toml` và phần tài liệu installation, usage, connecting to LLMs hoặc configuration được README dẫn tới. Trong repo cũng có các thư mục `docker/`, `scripts/` và `tests/`, nhưng README được cung cấp không mô tả cách dùng cụ thể của chúng.

## 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 mẫu với API key hợp lệ từ đúng thư mục codebase:

```bash
aider --model deepseek --api-key deepseek=<key>
```

```bash
aider --model sonnet --api-key anthropic=<key>
```

```bash
aider --model o3-mini --api-key openai=<key>
```

Nếu Aider khởi động được và mở cuộc trò chuyện trong terminal, phần cài đặt cơ bản đã hoạt động. Bạn có thể nhập yêu cầu về code để tiếp tục kiểm tra.

Kết quả mong đợi cụ thể về giao diện khởi động, thông báo phiên bản hoặc câu lệnh thoát không được README cung cấp. Vì vậy, không nên dựa vào một dòng màn hình cụ thể ngoài việc lệnh `aider` chạy được và có thể bắt đầu tương tác.

Một dấu hiệu khác là Aider có thể đọc codebase hiện tại và đề xuất hoặc thực hiện thay đổi. Với dự án Git, bạn có thể dùng công cụ Git quen thuộc để xem diff và commit mà Aider tạo ra. Hãy kiểm tra diff trước khi coi bài kiểm tra là hoàn tất.

## Dùng vào việc thật

### Chủ shop cần chỉnh trang bán hàng

Một chủ shop có website HTML/CSS đang hoạt động nhưng muốn đổi phần tiêu đề, màu nút và bố cục trên màn hình nhỏ. Chủ shop có thể mở terminal trong thư mục website, chạy Aider rồi mô tả yêu cầu bằng ngôn ngữ tự nhiên.

Ví dụ yêu cầu:

```text
Hãy tìm phần giao diện trang chủ. Đổi tiêu đề chính thành thông điệp ngắn hơn, làm nút liên hệ nổi bật hơn và kiểm tra CSS trên màn hình nhỏ. Giải thích các tệp bạn sẽ sửa trước khi thực hiện.
```

Aider hỗ trợ HTML và CSS, có thể lập bản đồ codebase để tìm các tệp liên quan. Sau khi thay đổi, chủ shop nên xem diff và kiểm tra trang trên trình duyệt. Tư liệu không cho biết Aider tự triển khai website, nên phần đưa code lên máy chủ vẫn cần quy trình riêng.

### Nhân viên văn phòng cần một công cụ nhỏ

Một nhân viên văn phòng có thể nhờ đồng nghiệp hoặc dev tạo một script Python để đổi tên tệp theo quy tắc, nhưng chưa biết bắt đầu từ đâu. Trong thư mục dự án, người dùng có thể yêu cầu Aider tạo phiên bản đầu tiên và giải thích cách dùng.

Ví dụ yêu cầu:

```text
Tạo một công cụ Python đọc các tệp trong thư mục hiện tại và đổi tên theo mẫu ngày_tên_tài_liệu. Trước tiên hãy đề xuất cấu trúc và nêu các trường hợp có thể làm mất tệp.
```

Aider có thể hỗ trợ bắt đầu một dự án mới và làm việc với Python. Người dùng không nên chạy ngay một script đổi tên hàng loạt trên dữ liệu thật. Hãy yêu cầu giải thích, thử trên bản sao và kiểm tra code trước.

### Dev mới cần sửa lỗi trong dự án

Một dev mới có thể đưa cho Aider mô tả lỗi và yêu cầu tìm nguyên nhân trong codebase. Khả năng lập bản đồ codebase giúp Aider xem xét nhiều tệp liên quan thay vì chỉ nhìn một đoạn code được dán vào chat.

Ví dụ yêu cầu:

```text
Khi người dùng gửi biểu mẫu rỗng, ứng dụng bị lỗi thay vì hiển thị thông báo. Hãy tìm nguyên nhân, đề xuất thay đổi tối thiểu và viết test cho trường hợp này.
```

Aider hỗ trợ linting và testing, nên có thể chạy kiểm tra sau khi sửa nếu dự án đã có quy trình tương ứng. Kết quả tốt nhất là một diff nhỏ, test mới và giải thích rõ các tệp đã thay đổi.

### Dev cần thêm tính năng vào codebase hiện có

Một dev đang làm dự án JavaScript, Go hoặc Rust có thể yêu cầu Aider thêm một tính năng trải qua nhiều tệp. README cho biết Aider hỗ trợ các ngôn ngữ này và làm việc với codebase lớn nhờ bản đồ code.

Ví dụ yêu cầu:

```text
Thêm chức năng xuất danh sách khách hàng ra tệp CSV. Hãy tìm nơi định nghĩa dữ liệu khách hàng, thêm xử lý xuất dữ liệu, cập nhật test và chạy lint hoặc test sau khi sửa.
```

Sau khi Aider thực hiện, dev có thể xem diff, chạy ứng dụng và kiểm tra commit. Tính năng tự động commit giúp thay đổi có mốc rõ ràng, nhưng không thay thế việc review code.

> Aider giống như một senior developer sống ngay trong Git repo của bạn.
>
> — Ông T

## Lỗi hay gặp và cách xử lý

### Python không đúng phiên bản

`pyproject.toml` yêu cầu Python từ 3.10 đến trước 3.15. Nếu bạn dùng phiên bản nằm ngoài khoảng này, quá trình cài có thể không phù hợp với yêu cầu của repo.

Hãy kiểm tra phiên bản Python đang gọi từ terminal và dùng một phiên bản nằm trong khoảng được khai báo. README không cung cấp lệnh kiểm tra phiên bản cụ thể, nên cần xem thêm tài liệu cài đặt của dự án nếu chưa biết cách đổi phiên bản.

### Terminal không nhận lệnh aider

Sau khi chạy `aider-install`, terminal có thể chưa nhận lệnh `aider`. Nguyên nhân dễ gặp là quá trình cài chưa hoàn tất hoặc đường dẫn chương trình chưa được terminal nhận.

Hãy đọc thông báo cài đặt, mở lại terminal rồi thử lại. Nếu vẫn lỗi, xem phần installation instructions và troubleshooting được README dẫn tới. Không nên tự đoán thêm tên gói hoặc cờ lệnh ngoài tài liệu.

### API key sai hoặc thiếu quyền

Nếu key bị thiếu, sai tên nhà cung cấp hoặc không có quyền dùng model đã chọn, Aider có thể không kết nối được mô hình. Kiểm tra đúng mẫu như `deepseek=<key>`, `anthropic=<key>` hoặc `openai=<key>`.

Không gửi API key cho người khác để nhờ sửa lỗi. Hãy kiểm tra trực tiếp tài khoản và tài liệu của nhà cung cấp mô hình. README không nêu thông báo lỗi cụ thể cho trường hợp này.

### Chạy ở sai thư mục

Aider làm việc với codebase hiện tại. Nếu bạn chạy lệnh từ thư mục cha, thư mục khác hoặc một dự án khác, công cụ có thể đọc sai tệp và tạo thay đổi không mong muốn.

Trước khi chạy, dùng `cd` vào đúng thư mục dự án như ví dụ trong README. Sau đó kiểm tra diff và danh sách tệp trước khi chấp nhận thay đổi.

### Tin ngay vào thay đổi do AI tạo

AI có thể hiểu sai yêu cầu hoặc sửa nhiều tệp hơn dự kiến. Dù Aider tích hợp Git và tự động commit, điều đó không có nghĩa mọi thay đổi đều đúng.

Hãy yêu cầu Aider giải thích trước với nhiệm vụ lớn, xem diff, chạy lint và test, rồi mới đưa thay đổi vào nhánh chính. Với dữ liệu kinh doanh hoặc code quan trọng, nên thử trên bản sao hoặc nhánh riêng.

## Có nên dùng không

Aider đáng thử nếu bạn muốn một trợ lý AI chạy trong terminal, làm việc trực tiếp với codebase và kết hợp với Git. Các điểm mạnh rõ nhất là bản đồ codebase, hỗ trợ nhiều ngôn ngữ, khả năng kết nối nhiều mô hình, tự động commit và hỗ trợ lint/test.

Công cụ cũng phù hợp với nhiều mức kinh nghiệm. Người mới có thể dùng để hỏi giải thích, tạo script hoặc sửa lỗi nhỏ. Dev giàu kinh nghiệm có thể dùng nó để xử lý thay đổi qua nhiều tệp, viết test và giữ quy trình làm việc trong terminal.

Giới hạn chính là bạn cần tự quản lý API key, lựa chọn mô hình và kiểm tra chi phí của nhà cung cấp. README không nêu yêu cầu GPU, hệ điều hành cụ thể, chi phí sử dụng mô hình hoặc hướng dẫn chi tiết cho mọi nhà cung cấp. Vì vậy, chưa thể khẳng định Aider luôn chạy offline, miễn phí hoàn toàn hoặc phù hợp với dữ liệu nhạy cảm.

Bạn nên cân nhắc công cụ khác nếu muốn một IDE hoàn chỉnh, giao diện kéo thả, quy trình triển khai tự động hoặc tài liệu cấu hình chi tiết cho môi trường đặc thù. Bạn cũng nên chọn cách khác nếu tổ chức không cho phép gửi code tới dịch vụ mô hình bên ngoài và chưa xác minh được cách dùng mô hình local.

Tóm lại, Aider là lựa chọn mạnh cho quy trình lập trình AI-first trong terminal. Hãy bắt đầu bằng một dự án nhỏ, dùng nhánh Git riêng, kiểm tra diff và test sau mỗi thay đổi. Repo có giấy phép Apache-2.0, hiện có khoảng 50.104 sao và 5.163 fork; tuy nhiên, tư liệu cho biết repo đã lâu chưa được cập nhật, nên bạn nên kiểm tra thêm tài liệu và tình trạng tương thích trước khi đưa vào quy trình quan trọng.

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

### Aider có miễn phí không?

Repo sử dụng giấy phép Apache-2.0 và README có mô tả Aider là công cụ mã nguồn mở miễn phí trong một nhận xét của người dùng. Tuy nhiên, README không xác nhận chi phí API của các mô hình, nên việc dùng DeepSeek, Anthropic hoặc OpenAI có thể phụ thuộc chính sách của từng nhà cung cấp.

### Aider có cần GPU không?

Tư liệu được cung cấp không nêu yêu cầu GPU. README nói Aider có thể kết nối với mô hình cloud và mô hình local, nhưng chưa có thông tin phần cứng chi tiết cho từng trường hợp.

### Aider có chạy được trên Windows không?

README không nêu hệ điều hành được hỗ trợ cụ thể. Vì vậy, chưa thể xác nhận riêng khả năng chạy trên Windows chỉ dựa vào tư liệu này.

### Aider có cần API key không?

Các lệnh mẫu trong README đều dùng API key tương ứng với mô hình: DeepSeek, Anthropic hoặc OpenAI. README không nói mọi cấu hình đều bắt buộc API key, vì Aider cũng có thể kết nối với mô hình local và web chat.

### Dữ liệu code có an toàn không?

Tư liệu không đưa ra chính sách bảo mật hoặc cam kết dữ liệu cụ thể. Aider có thể kết nối với mô hình cloud và local, nên mức độ riêng tư phụ thuộc vào mô hình và cách bạn cấu hình; hãy tránh gửi key hoặc dữ liệu nhạy cảm khi chưa kiểm tra.

### Aider hỗ trợ những ngôn ngữ nào?

README nói Aider làm việc với hơn 100 ngôn ngữ và nêu các ví dụ Python, JavaScript, Rust, Ruby, Go, C++, PHP, HTML và CSS. Chất lượng kết quả có thể khác nhau tùy ngôn ngữ, mô hình và codebase.

### Aider khác gì so với chat AI trên trình duyệt?

Aider chạy trong terminal, lập bản đồ codebase, có tích hợp Git và có thể tự động lint/test sau thay đổi. README cũng cho phép dùng quy trình copy/paste với web chat, nhưng không cung cấp bảng so sánh chi tiết với một công cụ cụ thể.
