cloudthinker) đưa workspace CloudThinker của bạn vào terminal. Gõ cloudthinker, mô tả công việc bằng ngôn ngữ tự nhiên, và agent làm việc ngay trong thư mục hiện tại; script dùng cloudthinker chat -p để nhận câu trả lời trên stdout.
Beta. CLI đang ở giai đoạn beta. Tên lệnh và cờ có thể thay đổi trước khi phát hành chính thức. CLI gọi Environment là environment, nên bạn sẽ thấy
--outpost trong các lệnh. Chạy cloudthinker --version để xem phiên bản của bạn, và xem trang releases để biết những gì đã thay đổi.Bạn có thể làm gì
Cái gì chạy ở đâu
Công cụ cục bộ chạy trên máy của bạn; những gì agent đọc được gửi tới model, còn thông tin xác thực của kết nối ở lại trên máy của workspace.
Chỉ chạy agent trong thư mục có nội dung bạn chấp nhận gửi tới mô hình. Xem Nơi công việc chạy để biết chi tiết.
Điều kiện tiên quyết
- macOS (Apple Silicon hoặc Intel) hoặc Linux (x86_64 hoặc arm64). Chưa có bản build gốc cho Windows.
- Tài khoản CloudThinker có quyền truy cập ít nhất một workspace. Headless chat (
cloudthinker chat) dùng được trên mọi gói, kể cả Free. Agent tương tác (cloudthinker) cần gói Team, Scale hoặc Enterprise; trên gói Free, agent từ chối khởi động và hiển thị lời nhắc nâng cấp. Xem Pricing. - HTTPS đi ra tới
cloudthinker.io(trình cài đặt),github.com(tải CLI và agent) vàapp.cloudthinker.io(API). Nếu đi qua proxy, đặtHTTPS_PROXY. Nếu proxy ký lại HTTPS, đặtSSL_CERT_FILEtrỏ tới CA bundle của công ty.
Cài đặt và chạy phiên đầu tiên
1
Cài đặt CLI
cloudthinker vào ~/.local/bin và thêm thư mục đó vào PATH trong shell profile của bạn. Khi chạy trong terminal, trình cài đặt tiếp tục mở bước đăng nhập, trừ khi bạn đã đăng nhập. Bước đăng nhập bị bỏ qua trong CI, hoặc khi bạn đặt CLOUDTHINKER_CLI_NO_LOGIN=1. Mở shell mới khi cài xong.Nếu máy của bạn chặn việc pipe script vào sh, hoặc bạn cần một phiên bản cụ thể, hãy tải gói nén và tệp .sha256 cho nền tảng của bạn từ trang releases:cloudthinker --version in ra số phiên bản.2
Đăng nhập
Bỏ qua bước này nếu trình cài đặt đã in CLI hỏi How would you like to log in? Chọn Log in with browser trên máy của bạn, hoặc Log in with a code khi dùng SSH. Phê duyệt yêu cầu trên trình duyệt và chọn workspace nếu bạn có nhiều workspace.
Trạng thái thành công: terminal in ra
Logged in to <workspace>.
Logged in to <workspace>. Xem Xác thực CLI cho máy từ xa, nhiều workspace và CI.3
Kiểm tra danh tính
host=https://app.cloudthinker.io email=you@example.com workspace=Production (<workspace-id>).4
Khởi động agent, hoặc hỏi một câu
cloudthinker đầu tiên tải bản build agent khớp với phiên bản CLI của bạn vào ~/.cloudthinker/agent/bin/<version>/ và đối chiếu với checksum SHA-256 của bản phát hành. Các lần sau dùng lại bản build này.Trạng thái thành công: phần đầu của agent hiển thị workspace, người dùng và Approval mode của workspace (· Auto hoặc · Manual), và ô prompt sẵn sàng nhận yêu cầu. Xem Agent CLI.Các lệnh
Mọi cờ, biến môi trường và mã thoát đều có trong Tra cứu CLI.
Cập nhật CLI
Chạycloudthinker update bất cứ lúc nào. Trên terminal tương tác, CLI cũng đề xuất cập nhật khi có bản phát hành mới hơn, kiểm tra tối đa 20 giờ một lần. CLI hỏi Install it now? [y/N] (s skips this version):
Đặt
CLOUDTHINKER_NO_UPDATE_CHECK=1 để tắt đề xuất, ví dụ trong CI. Để ghim một phiên bản, cài thủ công gói nén của bản phát hành đó như ở bước 1.
Dùng CLI từ một coding agent khác
Tệp nhị phân kèm theo một hướng dẫn vận hành dạy coding agent AI cách dùng CLI: chat, theo dõi cuộc hội thoại, đọc code review và chạy kiểm thử Cyber cục bộ. In hướng dẫn này không cần đăng nhập hay mạng. Lưu vào nơi coding agent của bạn đọc skill, ví dụ:Gỡ cài đặt
cloudthinker trong thư mục cấu hình (~/Library/Application Support/cloudthinker trên macOS, $XDG_CONFIG_HOME/cloudthinker hoặc ~/.config/cloudthinker trên Linux), và xóa dòng PATH mà trình cài đặt đã thêm vào shell profile. Xem Tệp để biết mọi đường dẫn CLI ghi vào.
Khắc phục sự cố
cloudthinker: command not found
cloudthinker: command not found
Trình cài đặt đã thêm
~/.local/bin vào PATH, nhưng shell hiện tại khởi động trước thời điểm đó. Mở shell mới, hoặc chạy trực tiếp ~/.local/bin/cloudthinker --version.Lệnh báo bạn chưa đăng nhập (mã thoát 3)
Lệnh báo bạn chưa đăng nhập (mã thoát 3)
Thông tin xác thực bị thiếu hoặc đã hết hạn, hoặc máy chủ từ chối truy cập. Chạy
cloudthinker login, rồi cloudthinker whoami để xác nhận. Xem Xác thực CLI.Ctrl-C dừng chat trước khi có câu trả lời
Ctrl-C dừng chat trước khi có câu trả lời
Chỉ việc chờ bị dừng. Lượt chạy vẫn tiếp tục trên máy chủ, và CLI in ra lệnh để chờ tiếp.
Bước tiếp theo
Xác thực CLI
Đăng nhập qua SSH, chuyển workspace và xác thực job CI
Agent CLI
Chạy phiên agent trong repository của bạn
Headless chat
Pipe câu trả lời của CloudThinker vào script và pipeline
Tra cứu CLI
Mọi lệnh, cờ, biến và mã thoát