Claude Code hiện hỗ trợ làm việc trên nhiều thư mục trong một phiên duy nhất bằng cách sử dụng cờ --add-dir và lệnh tương tác /add-dir. Điều này giúp loại bỏ việc phải liên tục chuyển đổi ngữ cảnh giữa các dự án.
Hỗ trợ Đa thư mục là gì
Chức năng cốt lõi
Cờ --add-dir /path/to/dir thêm các thư mục vào phiên Claude Code của bạn mà không thay đổi thư mục làm việc hiện tại. Sử dụng /add-dir <path> trong các phiên tương tác để mở rộng không gian làm việc của bạn một cách linh hoạt.
Claude Code duy trì mối quan hệ tệp trên các cấu trúc thư mục khác nhau trong khi vẫn giữ hiệu suất. Hệ thống tự động xử lý việc phân giải đường dẫn khi bạn tham chiếu các tệp từ các thư mục đã thêm.
Các trường hợp sử dụng chính
Kho lưu trữ đơn (Monorepos)
Làm việc trên các module frontend, backend và các module dùng chung mà không cần chuyển đổi phiên. Các ứng dụng lớn với sự phân tách logic được hưởng lợi từ việc truy cập hợp nhất vào tất cả các thành phần.
Tệp cấu hình dùng chung
Truy cập các tệp cấu hình, tài liệu và các tạo phẩm phát triển được lưu trữ ở các vị trí riêng biệt. Các tệp năng suất cá nhân và tài liệu nhóm trở nên luôn có sẵn trong các phiên làm việc.
Phát triển đa dự án
Quản lý đồng thời các kho lưu trữ có liên kết với nhau. Các client API luôn đồng bộ với các triển khai máy chủ. Tài liệu được cập nhật cùng với các thay đổi mã.
Các chiến lược triển khai
Thiết lập không gian làm việc
- Xác định thư mục làm việc chính của bạn
- Thêm các thư mục liên quan bằng cách sử dụng
--add-dir - Tạo các bí danh shell cho các cấu hình phổ biến
- Thiết lập các mẫu thư mục chung cho toàn đội
Tối ưu hóa hiệu suất
- Chỉ thêm các thư mục bạn đang sử dụng tích cực
- Tránh các thư mục chứa các tạo phẩm xây dựng (build artifacts)
- Theo dõi việc sử dụng token ngữ cảnh với các cấu hình lớn
- Sử dụng đường dẫn tuyệt đối để truy cập đáng tin cậy
Tích hợp phát triển
Hỗ trợ đa thư mục hoạt động với các quy trình làm việc Git hiện có, hệ thống CI và các pipeline triển khai. Các công cụ phát triển API như Apidog có thể giám sát các đặc tả trên nhiều thư mục dự án.
Ví dụ thực tế
Kiến trúc Microservices
Truy cập các triển khai dịch vụ, thư viện dùng chung, mẫu cấu hình và script triển khai trong một phiên duy nhất. Tham chiếu các mẫu hiện có trong khi phát triển các dịch vụ mới.
Đóng góp mã nguồn mở
Làm việc đồng thời với các kho lưu trữ đã fork, các nguồn upstream và các cấu hình cá nhân. Duy trì các đóng góp sạch sẽ trong khi truy cập tất cả các codebase liên quan.
Cơ sở hạ tầng dưới dạng mã (Infrastructure as Code)
Quản lý các định nghĩa ứng dụng, cấu hình triển khai và thiết lập giám sát trên nhiều kho lưu trữ. Duy trì tính nhất quán trong quá trình thay đổi cơ sở hạ tầng.
Các thực hành tốt nhất
Quản lý cấu hình
Sử dụng đường dẫn tuyệt đối để tránh các vấn đề phân giải. Xác minh quyền đọc cho tất cả các thư mục. Tạo các thiết lập tiêu chuẩn để đảm bảo tính nhất quán của nhóm.
Cân nhắc về bảo mật
Xem xét nội dung thư mục trước khi thêm chúng. Loại trừ thông tin nhạy cảm và thông tin xác thực sản xuất. Sử dụng các thư mục phát triển chuyên biệt.
Giám sát hiệu suất
Theo dõi việc sử dụng bộ nhớ với các cấu trúc thư mục mở rộng. Các thư mục cục bộ cung cấp hiệu suất tốt hơn so với các thư mục được gắn mạng. Xóa các thư mục không sử dụng khỏi các phiên.
Các tính năng nâng cao
Tích hợp dòng lệnh
claude-code --add-dir /path/to/backend --add-dir /path/to/frontend
Lệnh tương tác
/add-dir /path/to/shared-config
/add-dir /path/to/documentation
Quy trình làm việc của nhóm
Tiêu chuẩn hóa cấu hình đa thư mục trên các nhóm. Ghi lại các mẫu phổ biến để có trải nghiệm nhà phát triển nhất quán. Tích hợp với các quy trình giới thiệu nhân viên mới.
Quy trình làm việc phát triển API
Hỗ trợ đa thư mục nâng cao phát triển API-first. Các dịch vụ backend, tài liệu, SDK client và bộ kiểm thử thường tồn tại trong các kho lưu trữ riêng biệt nhưng yêu cầu cập nhật đồng bộ.
Apidog cung cấp các giao diện kiểm thử hợp nhất hoạt động trên không gian làm việc đa thư mục của bạn. Điều này đảm bảo tính nhất quán của API khi bạn phát triển các tính năng trải rộng trên nhiều dự án.
Khắc phục sự cố thường gặp
Sự cố phân giải đường dẫn
- Sử dụng đường dẫn tuyệt đối thay vì tương đối
- Xác minh các liên kết tượng trưng (symbolic links) hoạt động chính xác
- Kiểm tra quyền truy cập thư mục
Các vấn đề về hiệu suất
- Giới hạn các thư mục được thêm vào chỉ những thư mục cần thiết
- Giám sát tài nguyên hệ thống
- Xóa các thư mục không sử dụng trong các phiên dài
Kiểm soát truy cập
- Đảm bảo quyền đọc phù hợp
- Tránh thêm các thư mục chứa dữ liệu nhạy cảm
- Sử dụng cấu trúc thư mục dành riêng cho phát triển
Các cải tiến trong tương lai
Cộng đồng yêu cầu các tệp cấu hình cho các thiết lập không gian làm việc liên tục. Điều này sẽ cho phép tiêu chuẩn hóa toàn đội và giảm các tác vụ thiết lập lặp đi lặp lại.
Các cơ hội tích hợp với các nền tảng phát triển tiếp tục mở rộng. Các công cụ phát triển API, hệ thống quản lý dự án và nền tảng cộng tác có thể tận dụng các khả năng không gian làm việc nâng cao.
Kết luận
Hỗ trợ đa thư mục của Claude Code loại bỏ ma sát trong quy trình làm việc phát triển hiện đại. Monorepos, microservices và cộng tác đa dự án trở nên liền mạch mà không có chi phí chuyển đổi ngữ cảnh.
Bắt đầu với các cấu hình hai thư mục đơn giản và mở rộng dựa trên nhu cầu dự án. Đường cong học tập tối thiểu mang lại những cải thiện đáng kể về năng suất khi độ phức tạp của dự án tăng lên.
Kết hợp với các công cụ kiểm thử API toàn diện như Apidog, hỗ trợ đa thư mục tạo ra trải nghiệm phát triển từ đầu đến cuối được tối ưu hóa. Hãy thử nghiệm với các cấu hình phù hợp với yêu cầu dự án cụ thể của bạn để đạt được lợi ích tối đa.