Chuyển đến nội dung chính
CloudThinker CLI (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 dưới user hệ điều hành của bạn trên máy bạn và gửi prompt cùng những gì chúng đọc tới model gateway và bản sao Agent CLI, còn thông tin xác thực của kết nối ở lại trên máy của workspaceCông cụ cục bộ chạy dưới user hệ điều hành của bạn trên máy bạn và gửi prompt cùng những gì chúng đọc tới model gateway và bản sao Agent CLI, còn thông tin xác thực của kết nối ở lại trên máy của workspace

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.

Trên máy của bạn, agent đọc và sửa tệp, chạy lệnh shell với danh nghĩa người dùng hệ điều hành của bạn, và CloudThinker không hỏi phê duyệt trước. Với repository bạn không tin cậy, hãy chạy agent trong container hoặc một bản checkout dùng một lần.
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, đặt HTTPS_PROXY. Nếu proxy ký lại HTTPS, đặt SSL_CERT_FILE trỏ 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

Trình cài đặt đặt tệp nhị phân 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:
Trạng thái thành công: 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 Logged in to <workspace>.
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.
cloudthinker login in ra URL đồng ý
Trạng thái thành công: terminal in ra 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

Trạng thái thành công: một dòng 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

Lần chạy 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ạy cloudthinker 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

Sau đó xóa thư mục 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ố

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.
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.
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