Trải nghiệm khi dùng Serena
Bạn cài Serena bằng công cụ uv, chạy serena init để khởi tạo và kiểm tra, rồi cấu hình ứng dụng AI của mình để khởi chạy Serena như một máy chủ MCP. README ghi rõ không nên cài qua kho plugin hoặc marketplace vì các lệnh ở đó đã cũ.
Sau khi kết nối, trợ lý của bạn không còn đọc cả file để tìm một hàm mà gọi công cụ của Serena: tìm symbol, xem tổng quan một file, tìm nơi tham chiếu đến một hàm. Với việc như đổi tên một hàm dùng ở nhiều file, README mô tả rằng thao tác vốn cần nhiều bước mong manh có thể gói lại thành một lệnh nguyên tử.
Phía dưới Serena dùng các language server (máy chủ ngôn ngữ như trong VS Code) cho hơn 40 ngôn ngữ, hoặc plugin JetBrains trả phí nếu bạn muốn dùng phân tích của JetBrains IDE. Ngoài ra còn có hệ thống trí nhớ cho các công việc dài hơi.
Tính năng nổi bật
Tìm kiếm mã ở mức ký hiệu
Tìm hàm, lớp, tham chiếu và xem sơ đồ một file mà không phải đọc cả file, tiết kiệm ngữ cảnh của AI.
Sửa và tái cấu trúc an toàn
Đổi tên, di chuyển, thay thế theo ký hiệu thay vì thao tác trên số dòng, ít sai hơn trên dự án lớn.
Hơn 40 ngôn ngữ
Qua language server, hỗ trợ nhiều ngôn ngữ như Python, TypeScript, Java, Go, Rust, C#, PHP và nhiều ngôn ngữ khác.
Hai nền: language server hoặc JetBrains
Mặc định dùng language server miễn phí; plugin JetBrains là lựa chọn trả phí (có bản dùng thử) dùng sức mạnh phân tích của IDE.
Trí nhớ và quy trình theo dự án
Có hệ thống trí nhớ cho công việc dài và quy trình theo từng dự án, có thể cấu hình theo nhiều lớp.
Tận dụng Serena vào việc gì?
Lập trình viên làm dự án lớn
Đổi tên hàm xuyên nhiều file
Nhờ AI đổi tên một hàm và cập nhật mọi nơi dùng nó chỉ bằng một thao tác công cụ.
Lập trình viên mới vào dự án
Khám phá mã nguồn lạ
Hỏi AI về cấu trúc, ai gọi hàm này, hàm này nằm ở đâu và nhận câu trả lời dựa trên phân tích thật.
Người dùng Claude Code, Codex hằng ngày
Giảm tốn ngữ cảnh cho AI
AI chỉ lấy đoạn mã cần thiết nên tiết kiệm token và ít bị lạc hướng.
Đội phát triển hỗn hợp
Làm việc trên dự án đa ngôn ngữ
Dùng chung một bộ công cụ cho nhiều ngôn ngữ trong cùng một kho mã.
Cần chuẩn bị gì?
- Công cụ uv là điều kiện bắt buộc duy nhất theo README.
- Một client hỗ trợ MCP: Claude Code, Codex, Claude Desktop, OpenCode, Gemini CLI, Cursor, VS Code, JetBrains...
- Một số ngôn ngữ cần cài thêm language server riêng; xem trang Language Support của tài liệu.
- Tuỳ chọn plugin JetBrains trả phí nếu muốn dùng backend JetBrains.
Hướng dẫn cài đặt chi tiết
Cài trên uv (khuyên dùng)
Cài uv theo hướng dẫn chính thức của Astral, rồi cài Serena. Lệnh dưới theo README và chạy được trên PowerShell hay bash.
uv tool install -p 3.13 serena-agentKhởi tạo và kiểm tra thiết lập; lệnh này mặc định dùng backend language server.
serena initKết nối với ứng dụng AI. Với Claude Code, tài liệu client của Serena gợi ý lệnh tự thiết lập dưới.
serena setup claude-codeHoặc thêm thủ công cho mọi dự án bằng lệnh dưới (trên Windows chạy trong Git Bash hoặc WSL vì lệnh viết cho bash).
claude mcp add --scope user serena -- serena start-mcp-server --context claude-code --project-from-cwd
Cài trên Claude Desktop
Mở cài đặt, mục Developer, chọn sửa file cấu hình claude_desktop_config.json rồi thêm khối dưới.
{ "mcpServers": { "serena": { "command": "serena", "args": ["start-mcp-server", "--context=desktop-app"] } } }Lưu file và thoát hẳn Claude Desktop (menu File, Exit) rồi mở lại để nhận cấu hình.
Dùng thử lần đầu
Chạy
serena initvà đợi thông báo khởi tạo thành công.Cấu hình client theo tab hướng dẫn rồi mở trợ lý trong thư mục của một dự án thật nhỏ.
Nhờ trợ lý nêu tổng quan các lớp và hàm chính trong dự án, và xem nó có gọi công cụ của Serena không.
Thử một việc tái cấu trúc nhỏ như đổi tên một hàm ít dùng, trên nhánh Git riêng để dễ hoàn tác.
Đọc hướng dẫn quy trình theo dự án và cấu hình trong user guide để tuỳ chỉnh.
Mẹo dùng hay
- Làm việc trên nhánh Git riêng khi cho AI sửa mã để xem và hoàn tác dễ dàng.
- Đọc trang hướng dẫn workflow theo dự án và trang cấu hình trong tài liệu chính thức để khai thác hết khả năng.
- Với ngôn ngữ dùng language server, kiểm tra trang hỗ trợ ngôn ngữ xem có cần cài thêm gì.
- Phiên bản 2 có giao diện agent kiểu REPL mới; xem trang tools trong tài liệu nếu muốn thử.
Lưu ý và hạn chế
- Giấy phép theo từng thành phần: SolidLSP theo MIT, phần ứng dụng Serena theo GPL-3.0-or-later; bản phân phối kết hợp chịu GPL. Hãy cân nhắc nếu bạn muốn nhúng vào sản phẩm đóng.
- Đóng góp mã yêu cầu chấp nhận CLA theo README.
- Plugin JetBrains là sản phẩm trả phí (có dùng thử), Rider và CLion chưa được hỗ trợ.
- AI vẫn có thể sửa sai; hãy luôn xem lại thay đổi trước khi commit.
Câu hỏi thường gặp
Serena có miễn phí không?
Phần chính dùng language server miễn phí. Plugin JetBrains để dùng phân tích của IDE là trả phí và có bản dùng thử.
Dùng với Claude Code được không?
Được. Tài liệu hướng dẫn cho Claude Code có lệnh thiết lập tự động và lệnh thêm thủ công, như trong phần cài đặt.
Người không lập trình có cần không?
Không. Serena dành cho người dùng trợ lý lập trình AI trong dự án code.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/oraios/serena.gitRepo tương tự nên xem
Context7
upstash / context7
Đưa tài liệu thư viện mới nhất, đúng phiên bản vào trợ lý AI viết code để hết cảnh AI bịa hàm không tồn tại
Claude Code
anthropics / claude-code
Trợ lý AI viết code của Anthropic chạy trong Terminal, đọc hiểu dự án, sửa file và xử lý Git bằng lời thường
Aider
Aider-AI / aider
Lập trình cặp với AI ngay trong Terminal: AI sửa code trong dự án và tự commit Git cho bạn