미리 보기 —
cloudthinker agent는 macOS와 Linux용 CloudThinker CLI에 포함되며 유료 워크스페이스 플랜이 필요합니다. 미리 보기 참여를 원하시면 문의하기를 클릭하세요.cloudthinker agent는 터미널에서 실행되는 코딩 에이전트이며 pi 위에 만들어졌습니다. 파일 편집과 명령 실행은 내 컴퓨터에서 하고, 클라우드에는 워크스페이스 연결을 사용해 CloudThinker Sandbox를 통해서만 접근합니다.
Agent CLI를 쓰는 이유
- 저장소는 로컬에 그대로. 모델 루프, 파일 편집, 셸 명령이 모두 내 노트북에서 실행됩니다.
- 클라우드 자격 증명이 내 컴퓨터에 없음. 클라우드 명령은 CloudThinker Sandbox에서 실행되며, 연결 자격 증명은 그 실행에만 주입됩니다.
- 워크스페이스 규칙이 그대로 적용됨. 클라우드 쓰기는 채팅과 동일한 Approval mode와 승인 규칙을 따릅니다.
- 모든 세션이 미러링됨. 팀원이 브라우저에서 세션을 읽을 수 있고, 워크스페이스가 감사와 과금을 처리합니다.
세션 시작하기
1
설치하고 로그인
CloudThinker CLI를 설치하고
cloudthinker login을 실행하세요. 자격 증명이 없으면 에이전트가 브라우저 로그인을 대신 실행합니다.2
저장소에서 에이전트 실행
3
헤더 확인
헤더에는 워크스페이스, 사용자, 세션 링크, 그리고 워크스페이스 승인 모드가
· Auto 또는 · Manual로 표시됩니다.성공 상태: 푸터에 ◆ 0.00 credits가 보이고 첫 프롬프트를 입력할 수 있습니다.두 가지 실행 환경
에이전트는 두 곳에서 동작할 수 있으며, 어느 쪽을 쓰는지 항상 알려줍니다.
연결은 Sandbox가 쓸 수 있는 자격 증명이지, 세 번째 환경이 아닙니다. 에이전트는 채팅에서 CloudThinker가 보는 것과 같은 연결 정보를 매 턴 갱신해 참조하므로, 브라우저에서 추가한 연결을 다음 프롬프트부터 쓸 수 있습니다.
하나의 명령에서 이름이 지정된 여러 AWS와 GCP 연결을 GitLab과 함께 쓸 수 있습니다. 어떤 별칭을 쓸지 에이전트에게 알려주세요. 클라우드 실행마다 자격 증명과 로컬 파일 변경은 분리되며, 새로 선언된 출력 파일만 워크스페이스로 돌아오고 기존 파일은 덮어쓰지 않습니다.
클라우드 도구
ct_ask 실행은 세션당 CloudThinker 스레드를 하나 열고 재사용합니다. ct_run_status는 승인 후 일시 중지된 실행을 재개합니다.
클라우드 쓰기 승인하기
클라우드 쓰기는 호출이 아니라 워크스페이스가 결정하는 요청입니다. 규칙이 먼저 결정하고, 그다음 Approval mode가 결정합니다. 에이전트가 쓰기를 요청하면 터미널이 편집기 위에 사유, 연결, 명령, 브라우저 링크가 담긴 카드를 고정해 보여줍니다.
카드에서 다음 중 하나를 고릅니다.
Escape를 누르면 거절입니다. 승인자만 승인할 수 있고, 승인자인 팀원에게는 브라우저에도 같은 카드가 보입니다.
Approve and trust this command는 해당 명령을 워크스페이스 정책에 기록합니다. 다음부터 그 명령과 정확히 같은 명령은 멈춤 없이 실행됩니다. 워크스페이스 소유자 또는 관리자만 명령을 신뢰할 수 있습니다. 신뢰할 수 없으면 터미널이 그 선택지 없이 다시 묻습니다.
승인은 쓰기가 요청된 시점에 선택된 연결을 그대로 유지합니다. 연결을 추가해도 대기 중인 쓰기의 범위는 넓어지지 않으며, 접근 권한을 제거하거나 선택된 ID를 바꾸면 실행이 차단됩니다. 쓰기 결과가 불명으로 보고되면 다시 요청하기 전에 영향부터 확인하세요. 요청을 재개해도 명령이 자동으로 다시 실행되지는 않습니다.
터미널에서의 Approval mode
Agent CLI 세션은 Chat 실행 유형의 모드를 사용합니다. Chat이 Same as workspace이면 세션은 워크스페이스 모드를 사용합니다. 터미널은 이 모드를 보여줄 뿐, 자체 모드를 갖지 않습니다./cloudthinker auto를 실행하면 현재 모드를 출력합니다./cloudthinker auto on을 실행하면 워크스페이스를 Auto · Rules + AI · Ask me로 설정합니다. 이미 Auto 모드인 워크스페이스는 기존 선택을 유지합니다./cloudthinker auto off를 실행하면 워크스페이스를 Manual로 설정합니다.
알림
Agent CLI 세션은 스스로 승인 알림을 보내지 않습니다. 카드가 이미 터미널과 브라우저에 보이기 때문입니다. 세션의ct_ask 스레드에서 CloudThinker가 올리는 승인도 마찬가지입니다.
승인자가 아니라면 /cloudthinker notify를 실행해 알림에서 설정한 채널로 승인 요청을 한 번 보낼 수 있습니다.
명령
/model, /fork, /settings 같은 pi 자체 명령도 그대로 동작합니다. /share와 /thinking은 제거되었습니다.
세션 미러
모든 세션은 Agent CLI 대화로 워크스페이스에 미러링됩니다. 브라우저에서 열면 저장소, 브랜치, 도구 호출, 연결된 CloudThinker 스레드를 담은 읽기 전용 뷰어가 보입니다. 세션을 소유한 터미널만 기록하므로 아무도 입력할 수 없습니다. 보기 권한이 있는 워크스페이스 구성원은 읽을 수 있고, 삭제는 워크스페이스 소유자만 할 수 있습니다. 기록은 pi의 세션 파일로 내 컴퓨터에 남습니다. 그 파일을 재개하면 같은 대화가 이어지고,/fork는 부모를 기록한 새 대화를 엽니다.
크레딧
푸터는 이 세션에 청구된 크레딧을 보여줍니다. 예:◆ 1.75 credits. 에이전트는 모델 가격을 통화로 표시하지 않습니다. 푸터에 미러 상태가 추가되는 것은 ✕ mirror offline, 3 pending처럼 조치가 필요할 때뿐입니다.
관련 문서
CLI
CloudThinker CLI 설치하고 로그인하기
Approval mode
워크스페이스, 실행 유형, 또는 한 채팅의 Manual 또는 Auto 선택
승인
규칙, 승인자, 승인 카드
연결
Sandbox가 사용할 연결 설정하기