데스크톱 에이전트: Claude Code, Codex 등에 작업 맡기기

%BRAND% 데스크톱 앱의 에이전트는 제어판이에요. 자체 AI를 쓰지 않고, 컴퓨터에 이미 설치된 AI 코딩 에이전트에게 공식 헤드리스 모드로 작업을 맡기고 그 과정을 읽기 쉬운 타임라인으로 보여 줘요.

지원하는 에이전트

에이전트	명령	사용하는 헤드리스 모드
Claude Code (Anthropic)	claude	claude -p --output-format stream-json
Codex CLI (OpenAI)	codex	codex exec --json
Gemini CLI (Google)	gemini	gemini -p --output-format stream-json
Antigravity CLI (Google)	agy	agy -p --output-format stream-json
Cursor Agent	cursor-agent / agent	agent -p --output-format stream-json
GitHub Copilot CLI	copilot	copilot -p
opencode	opencode	opencode run --format json
Aider	aider	aider --message

Claude, ChatGPT, Codex, Cursor 데스크톱 앱은 헤드리스 모드가 없어요. ‘열기’를 누르면 프롬프트를 먼저 복사하니 앱에 붙여 넣으세요.

사이드바의 에이전트 → ‘에이전트’에서 찾은 도구, 버전, 로그인 여부를 볼 수 있어요(로그인 파일이나 환경 변수가 있는지만 보고 비밀 정보 내용은 읽지 않아요). 없는 도구는 설치 방법 링크가 있고, 설치한 뒤 ‘다시 찾기’를 누르면 돼요.

작업 실행하기

1. 오른쪽 위 새 작업을 눌러요(런처에 ‘Claude Code에게 맡기기: …’라고 입력해도 돼요).
2. 에이전트와 작업할 폴더를 골라요(최근 폴더도 보여요).
3. 할 일을 적고 권한을 고른 뒤 실행(Ctrl + Enter / ⌘↵).

작업은 ‘작업’에 나타나요. 모델이 한 말, 호출한 도구(명령, 읽고 쓴 파일)와 결과, 변경 사항, 걸린 시간, 토큰 수를 실시간으로 볼 수 있고 언제든 중지할 수 있어요. 동시에 실행할 개수(1~4)를 고를 수 있고 나머지는 대기열에 들어가요. 끝나면 알림이 오고 트레이 툴팁에도 실행 중인 개수가 보여요.

권한

권한	의미	에이전트 쪽 설정(예)
읽기 전용 (기본)	보고 계획만 해요. 파일을 바꾸거나 무언가를 바꾸는 명령은 실행하지 않아요	Claude --permission-mode plan, Codex --sandbox read-only, Cursor --mode ask
파일 편집	폴더 안의 파일을 편집할 수 있어요. 다른 명령은 에이전트 자체 규칙에 따라 계속 거부돼요	Claude acceptEdits, Codex workspace-write, Gemini auto_edit
모두 자동 승인	묻지 않고 어떤 파일, 명령, 네트워크든 써요	Claude --dangerously-skip-permissions, Codex --dangerously-bypass-approvals-and-sandbox

• 에이전트마다 지원하는 권한만 고를 수 있어요(예: opencode에는 ‘모두 자동 승인’이 없어요). 몰래 더 넓은 권한으로 바꾸지 않아요.
• ‘모두 자동 승인’은 실행할 때마다 위험 확인이 따로 필요해요.

안전과 개인정보

• 컴퓨터에서 ‘실행’을 눌러야만 시작돼요. 웹사이트(예: SOP 단계의 ‘에이전트에게 맡기기’)는 새 작업 창에 프롬프트를 미리 채우는 것만 할 수 있고, 창 위쪽에 출처가 표시돼요. 웹사이트에서는 ‘모두 자동 승인’이나 폴더를 지정할 수 없어요.
• 명령줄이나 다른 에이전트가 WidgetStore CLI로 보낸 작업은 에이전트, 폴더, 프롬프트, 권한을 보여 주는 확인 창이 열리고, ‘허용’을 눌러야만 실행돼요.
• 에이전트에게는 시스템에 필요한 환경 변수와 그 에이전트 자체 설정만 넘겨요. %BRAND% 로그인 정보와 토큰은 절대 넘기지 않아요.
• 프롬프트, 과정, 결과는 이 컴퓨터에만 저장되고 업로드되지 않아요. ‘작업’에서 하나씩 또는 모두 지울 수 있어요.

예시 템플릿

새 작업 창과 에이전트 페이지에 몇 가지 예시가 있어요: Sentry 점검(에이전트에 Sentry MCP 서버 설정 필요), 열린 PR 리뷰, git log로 릴리스 노트 작성, 코드베이스 10줄 소개, 테스트 실행 후 수정(이건 기본이 ‘파일 편집’). 누르면 내용이 채워지니 고친 뒤 실행하세요.

사용량

CLI가 토큰 수를 알려 주는 경우(Claude Code, Codex, Gemini, opencode, Aider) 끝난 작업에 표시돼요. Claude Code, opencode, Aider는 자체 비용 추정도 보여 줘요(구독은 토큰 단위 과금이 아니니 참고용이에요). 도구 전체의 장기 사용량은 설정의 ‘AI 사용량’에서 볼 수 있어요.