Bulkhead ngăn các phiên Claude Code song song làm sập máy của bạn

Các nhà phát triển chạy nhiều phiên bản Claude Code trên cùng một máy trạm thường gặp phải tình trạng tranh chấp tài nguyên, trong đó một tác nhân vô tình tắt server của tác nhân khác hoặc làm cạn kiệt bộ nhớ hệ thống. Một công cụ mã nguồn mở mới tên là claude-bulkhead giải quyết vấn đề này bằng cách cài đặt các hook nhẹ để giám sát và hạn chế lệnh shell giữa các phiên song song. Được phát hành vào tháng 11 năm 2026, công cụ cho phép kỹ sư chạy đồng thời các trợ lý AI một cách an toàn mà không cần quản lý quy trình thủ công.

Chuyện gì đã xảy ra

Khi các trợ lý AI viết mã ngày càng tự chủ hơn, các nhà phát triển ngày càng chạy nhiều phiên đồng thời, thường sử dụng các git worktree riêng biệt cho các nhánh hoặc tính năng khác nhau. Mặc dù git cô lập các thay đổi mã, nhưng hệ điều hành cơ bản không cô lập các tài nguyên như cổng, bộ nhớ hay các tiến trình đang chạy. Điều này dẫn đến các va chạm thường xuyên, nơi lệnh bảo trì thông thường của một tác nhân, chẳng hạn như khởi động lại server phát triển, vô tình kết thúc các tiến trình thuộc về các phiên hoạt động khác.

Người tạo ra claude-bulkhead đã xác định những điểm gây khó khăn này thông qua nhiều báo cáo từ cộng đồng, nơi các tác nhân giết chết các dịch vụ quan trọng hoặc làm treo máy do bão hòa RAM. Để giải quyết, họ đã xây dựng một bộ gồm tám lớp bảo vệ cụ thể đóng vai trò trung gian giữa tác nhân AI và shell. Các lớp bảo vệ này chặn đứng lệnh trước khi thực thi, kiểm tra chúng dựa trên trạng thái hiện tại của tất cả các phiên hoạt động khác trên máy.

Công cụ hoạt động với không có phụ thuộc bên ngoài nào ngoài Node.js 18, giúp dễ dàng cài đặt qua chợ plugin Claude Code. Nó bao gồm một tính năng quét phân tích các bản ghi phiên trước đó để cho người dùng thấy số lượng xung đột sẽ được ngăn chặn nếu công cụ hoạt động, cung cấp cái nhìn ngay lập tức về quy mô của vấn đề mà không thay đổi bất kỳ quy trình làm việc hiện có nào.

Cách thức hoạt động

Claude-bulkhead tận dụng hệ thống hook gốc của Claude Code, cho phép các chương trình nhỏ chạy tại các điểm cố định, chẳng hạn như trước mỗi lệnh shell. Khi một tác nhân cố gắng thực thi lệnh Bash hoặc PowerShell, lớp bảo vệ liên quan sẽ chặn nó. Lớp bảo vệ sau đó đọc thư mục trạng thái toàn cục, theo dõi các phiên hoạt động, cổng được gán và mức sử dụng bộ nhớ của chúng. Nếu một lệnh vi phạm quy tắc an toàn, hook sẽ chặn nó và trả về một thông báo lỗi cụ thể kèm theo một giải pháp thay thế an toàn hơn.

Ví dụ, nếu một tác nhân cố gắng giết tất cả các tiến trình Node để khởi động lại server, kill-guard sẽ kiểm tra xem có tiến trình nào thuộc về các phiên khác hay không. Nếu có, lệnh sẽ bị chặn và tác nhân được hướng dẫn chỉ nhắm vào ID tiến trình của chính nó. Tương tự, memory-guard giám sát RAM khả dụng và có thể xếp hàng các công việc nặng bằng cách sử dụng hệ thống slot chia sẻ, đảm bảo rằng ba quá trình build đồng thời không làm treo toàn bộ máy.

Hệ thống cũng bao gồm một orphan-reaper kích hoạt khi một phiên kết thúc. Nó tự động xác định và dừng bất kỳ dev server, worker thử nghiệm hoặc watcher nào mà phiên thoát còn để lại đang chạy. Điều này ngăn chặn vấn đề phổ biến của các tiến trình "zombie" tiêu tốn tài nguyên lâu sau khi tác nhân AI đã hoàn thành nhiệm vụ. Tất cả trạng thái được quản lý cục bộ trong một thư mục chuyên dụng, đảm bảo không có dữ liệu nào rời khỏi máy.

Chi tiết chính

• Tám lớp bảo vệ chuyên biệt: Bao gồm kill-guard, port-guard, memory-guard, checkout-guard, wait-guard, orphan-reaper, disk-guard và basics.
• Kiến trúc không phụ thuộc: Chỉ yêu cầu Node.js 18 trở lên, không cần thêm thư viện hoặc dịch vụ bên ngoài.
• Quét bản ghi: Lệnh bulkhead scan phát lại nhật ký phiên trước đó để xác định các xung đột lịch sử mà không thay đổi bất kỳ dữ liệu nào.
• Hỗ trợ thực thi từ xa: Tính năng tùy chọn bulkhead remote cho phép chuyển giao các bản build hoặc bài kiểm tra nặng sang máy khác qua SSH.
• Trạng thái thời gian thực: Cung cấp dòng trạng thái hiển thị các phiên hoạt động, bộ nhớ trống và các công việc xếp hàng với độ trễ dưới 100ms.
• Mặc định an toàn: Chặn các thao tác nguy hiểm như rm -rf trên thư mục gốc và ngăn chặn các commit được tạo bởi "Claude" theo mặc định.

Tại sao điều này quan trọng

Đối với các trưởng nhóm kỹ thuật và kỹ sư xây dựng sản phẩm với AI, độ tin cậy là tối thượng. Chạy nhiều tác nhân AI song song là một cách mạnh mẽ để tăng tốc phát triển, nhưng nó giới thiệu sự phức tạp vận hành mà các công cụ truyền thống không xử lý được. Nếu không có sự cô lập, chi phí gỡ lỗi các vấn đề môi trường do sự can thiệp của tác nhân có thể vượt quá thời gian tiết kiệm được nhờ tự động hóa. Claue-bulkhead khôi phục tính dự đoán của môi trường phát triển bằng cách áp đặt các ranh giới mà hệ điều hành thiếu.

Công cụ này cũng làm nổi bật sự thay đổi trong cách chúng ta quản lý các tác nhân AI. Thay vì coi chúng là những trình tạo văn bản đơn giản, chúng ta phải quản lý chúng như các quy trình đồng thời với nhu cầu tài nguyên và các tác dụng phụ tiềm ẩn. Bằng cách triển khai các mẫu bulkhead—được đặt tên theo các khoang tàu ngăn nước tràn làm chìm toàn bộ con tàu—các nhà phát triển có thể mở rộng việc sử dụng AI một cách an toàn. Cách tiếp cận này giảm tải nhận thức cho các kỹ sư, những người không còn cần phải theo dõi thủ công xem cổng nào đang được sử dụng hoặc tiến trình nào thuộc về nhánh nào.

Những gì bạn có thể làm

• Cài đặt plugin qua chợ Claude Code bằng /plugin install bulkhead@bulkhead.
• Chạy /bulkhead:scan 30d để phân tích các bản ghi phiên trong tháng qua và xem các xung đột tiềm tàng.
• Sử dụng /bulkhead:doctor để xác minh rằng tất cả các lớp bảo vệ được cấu hình đúng và hoạt động.
• Giám sát các phiên hoạt động và mức sử dụng tài nguyên theo thời gian thực với lệnh bulkhead top.
• Cấu hình danh sách cho phép hoặc ngưỡng cụ thể trong tệp cấu hình dự án nếu một số lệnh cần ngoại lệ.
• Cân nhắc thiết lập bulkhead remote nếu bạn thường xuyên gặp giới hạn bộ nhớ trong quá trình build cục bộ.