Codebuff

Codebuff là một AI coding agent chạy trong terminal, sẽ điều phối nhiều sub-agent theo tác vụ để đọc code, lập kế hoạch và sửa file. Mặc định nó kết nối tới dịch vụ đám mây chính thức; nếu phiên bản bạn đang dùng hỗ trợ ghi đè endpoint OpenAI tương thích, có thể trỏ yêu cầu về aicentos qua biến môi trường.

Xác nhận trước phiên bản của bạn có hỗ trợ endpoint tùy chỉnh khôngSao chép liên kết neo

Codebuff chính thức khuyến khích dùng chế độ dịch vụ đám mây: đăng nhập để dùng hạn mức chính thức, hoặc dùng API chính thức qua CODEBUFF_API_KEY. Base URL tùy chỉnh không phải phiên bản nào cũng có, hãy xác nhận trước:

• Chạy codebuff --help, xem có tùy chọn dạng --base-url, --provider không.
• Xác nhận phiên bản có đọc OPENAI_BASE_URL (một số phiên bản là CODEBUFF_BASE_URL) để ghi đè endpoint không.
• Nếu cả hai đều không hỗ trợ, tức là phiên bản hiện tại chỉ đi được dịch vụ chính thức, không thể kết nối thẳng aicentos.

Chuẩn bịSao chép liên kết neo

Nếu xác nhận phiên bản hỗ trợ endpoint tùy chỉnh, trước tiên tạo một Key chuyên dụng cho Codebuff tại trang "API Key" trong Console (khuyến nghị đặt tên codebuff-cli).

• Console: https://aicentos.com
• Tạo Key: https://aicentos.com/keys
• Nạp tiền Ví: https://aicentos.com/wallet

Đồng thời xác nhận máy đã cài Node.js, và đã cài toàn cục Codebuff:

npm install -g codebuff

Cấu hình cần điềnSao chép liên kết neo

Các bước thiết lậpSao chép liên kết neo

• Ghi endpoint và key vào cấu hình shell (~/.zshrc hoặc ~/.bashrc):

export OPENAI_API_KEY="sk-Key-aicentos-của-bạn"
export OPENAI_BASE_URL="https://aicentos.com/v1"

• Tải lại cấu hình: source ~/.zshrc.
• Vào thư mục dự án, chạy trực tiếp codebuff.
• Nếu phiên bản hỗ trợ tham số --model, có thể chỉ định rõ mô hình khi khởi động; nếu không thì dùng lệnh chọn mô hình trong giao diện tương tác để chuyển.

Một số phiên bản ghi cấu hình vào file JSON trong thư mục cấu hình người dùng (file chứa thông tin xác thực mặc định có quyền 600, đừng commit vào kho mã nguồn). Nếu phiên bản của bạn dùng file cấu hình thay vì biến môi trường, hãy điền cùng một Base URL và Key theo tên trường do codebuff --help hoặc tài liệu chính thức đưa ra.

Kiểm traSao chép liên kết neo

Sau khi khởi động, trước tiên dùng một câu prompt đơn giản test nhẹ, ví dụ cho nó đọc một file rồi tóm tắt nội dung, xác nhận trả về kết quả bình thường rồi mới chính thức sử dụng.

Lưu ýSao chép liên kết neo

• Endpoint tùy chỉnh thuộc dạng nâng cao, tên trường giữa các phiên bản có thể không nhất quán; lấy output của codebuff --help trên máy bạn làm chuẩn.
• OPENAI_BASE_URL chỉ điền đến https://aicentos.com/v1, đừng bổ sung thành /v1/chat/completions đầy đủ.
• Codebuff sẽ gửi đoạn code và output terminal làm ngữ cảnh, trước khi dùng hãy xác nhận điều này phù hợp với yêu cầu tuân thủ dữ liệu của đội bạn.
• Khi gặp lỗi, lần lượt kiểm tra: biến môi trường có hiệu lực trong terminal hiện tại không, tên mô hình có khớp Console không, số dư tài khoản có đủ không (https://aicentos.com/wallet).
• Xem thêm giải thích tại trang tài liệu: https://docs.aicentos.com