CmdQ
프로젝트마다 터미널을 띄워 놓고 끝났나 오가며 확인할 필요가 없습니다. Claude Code 작업을 줄 세워 두면 프로젝트가 다르면 함께, 같으면 차례대로 돌립니다. 사용 한도에 걸린 작업도 실패로 끝나지 않고 리셋 뒤 같은 세션에서 이어 갑니다.
macOS 12 이상 · Claude Code CLI 설치·로그인 필요 — 이 앱은 공식 CLI를 실행할 뿐, 자체적으로 Claude를 호출하지 않습니다.
창을 오가고 한도를 기다리는 시간은 큐에 맡기고 사람은 무엇을 시킬지만 정합니다.
밀린 일을 한꺼번에 끝내려고 프로젝트마다 claude 터미널을 띄운 적이 있습니다. 창이 늘어날수록 어느 게 끝났고 어느 게 제 답을 기다리는지 자꾸 놓쳤습니다. 그래서 한곳에 줄 세워 돌리려고 CmdQ를 만들었습니다.
Claude Code CLI를 설치하고 로그인까지 마쳤다면 2단계부터 보십시오.
셋 중 하나로 설치하고 버전이 나오는지 확인한 뒤, claude를 한 번 실행해 Claude 계정으로 로그인합니다. 로그인하지 않으면 큐 작업이 실행되지 않고 사용량도 보이지 않습니다.
Cmdcurl -fsSL https://claude.ai/install.sh | bashbrew install --cask claude-codenpm install -g @anthropic-ai/claude-codeclaude --versionclaudeDMG를 내려받아 응용 프로그램 폴더로 옮기고 실행합니다. 처음 실행하면 아래 고지가 뜨고, 동의하고 시작을 눌러야 큐와 터미널이 동작합니다.
큐에 넣은 작업은 Claude Code를 --dangerously-skip-permissions로 실행합니다. Claude Code가 대상 폴더에서 확인 없이 파일을 읽고, 쓰고, 지우며 명령을 실행합니다. 넣는 작업을 검토하고, 작업물은 버전 관리로 보호하고, 바뀌어도 되는 폴더에서만 사용해 주십시오. 실행한 작업의 결과는 사용자 책임입니다.
+ 폴더로 프로젝트 탭을 열고 명령을 적습니다.
Enter를 누르면 To Do에, ⌘Enter를 누르면 자동 큐에 들어갑니다.
/로 시작하는 단어를 치면 스킬 목록이 뜹니다.
자동 큐는 위에서부터 실행합니다. 경로가 다르면 기본 세 곳까지 함께 돌립니다. To Do는 보관용이라 저절로 실행되지 않습니다.
경로는 그 폴더에서 새 세션을 시작하고, 세션은 기존 대화를 이어 갑니다. 대화형은 큐를 거치지 않고 앱 안 터미널을 엽니다.
항목을 다른 항목 아래로 끌어 넣으면 부모가 끝난 뒤 그 세션을 이어받아 실행됩니다. 부모가 실패하면 하위는 실행되지 않습니다.
| 상태 | 뜻 | 다음 |
|---|---|---|
| 대기 | 차례를 기다림 | 같은 경로의 앞 항목이 끝나면 시작 |
| 실행 중 | Claude Code가 작업 중 | 완료나 실패로 바뀜 |
| 리셋 대기 | 한도에 걸려 멈춤(실패 아님) | 리셋되면 멈춘 세션에서 이어 실행 |
| 완료 | 정상 종료 | 하위 체인이 있으면 이어 실행 |
| 실패 | 오류로 종료 | 하위 체인은 실행하지 않음 |
헤더에 5시간 윈도우·주간 한도 사용률과 다음 리셋까지 남은 시간이 나옵니다. 메뉴 막대 아이콘에도 같은 값과 자동 큐 현황이 보입니다.
창을 닫아도 앱은 메뉴 막대에 남아 큐를 계속 실행합니다. 아이콘의 빨간 점은 확인하지 않은 알림, 노란 점은 리셋 대기, 초록 점은 실행 중인 작업이 있다는 뜻입니다.
대기 중인 항목을 위아래로 끌면 순서가 바뀌고, 오른쪽으로 끌면 바로 위 항목의 체인이 됩니다.
다른 버튼은 마우스를 올리면 이름이 나옵니다. 세션 칩을 누르면 claude --resume 명령이 복사됩니다.
카드의 ⌘나 추가바의 대화형으로 앱 안 터미널을 엽니다. 백그라운드로 계속을 누르면 창을 닫아도 이어지고, ⇧⌘T 목록에서 다시 엽니다.
출력이 멎으면 입력 대기 알림이 옵니다. 헤더의 세션 표기를 누르면 resume 명령이 복사됩니다.
설정 화면은 ⌘,로 엽니다. 자주 바꾸는 항목만 추렸고, 나머지는 설정 화면의 설명을 참고하십시오.
| 설정 | 설명 |
|---|---|
| 언어 | 시스템 설정 따름 · 한국어 · English |
| 테마 | 다크(기본) · 라이트 |
| 터미널 창 폭 | 기본 (최대 1000px) · 전체 화면 폭 |
| 데스크톱 알림 | 완료·한도 도달·실패·입력 대기 때 알림 |
| claude 실행 파일 | 비우면 ~/.local/bin/claude → PATH 순으로 찾음 |
| 자동 큐 동시 실행 | 함께 돌릴 경로 수. 기본 3 |
| 같은 경로 동시 실행 | 한 경로의 동시 실행 수. 기본 2, 파일을 고치는 작업이면 1 권장 |
| 시스템 로그인 시 시작 | 로그인하면 앱이 떠 자동 큐를 이어 처리 |
| 동작 | 기본 조합 |
|---|---|
| 프로젝트 추가 | ⌘O |
| 현재 탭 닫기 | ⌘W |
| 왼쪽 탭 활성화 · 오른쪽 탭 활성화 | ⌥⌘← · ⌥⌘→ |
| 경로 선택 · 세션 선택 · 대화형 선택 | ⌃1 · ⌃2 · ⌃3 |
| 전체보기 | ⇧⌘A |
| 설정 | ⌘, |
| 즐겨찾기 | ⇧⌘B |
| 터미널 | ⇧⌘T |
조합은 설정의 단축키 묶음에서 바꿉니다.
| 증상 | 해결 |
|---|---|
| CLI를 찾지 못한다고 나옴 | 터미널에서 which claude로 나온 경로를 설정의 claude 실행 파일에 적습니다. |
명령이 node 같은 도구를 찾지 못함 | 앱을 끈 뒤 ~/Library/Application Support/com.doitasap.cmdq/config.toml의 claude.extra_paths에 그 도구의 폴더를 넣습니다. |
| "대기 중 · 세션 사용 중"에서 멈춤 | 같은 세션을 쓰는 다른 터미널이나 작업이 있습니다. 그쪽을 닫거나 끝나길 기다립니다. |
| 세션 이력에 세션 파일이 없습니다 | Claude Code가 보존 기간(기본 30일)이 지난 세션을 지운 경우입니다. 응답 보기에서 앱 로그로 확인합니다. |
| 설치 후 "손상되었다" 또는 개발자를 확인할 수 없음 | 정식 배포본에는 이 경고가 뜨지 않습니다. GitHub 릴리스에서 다시 받으십시오. |
| 대화형 터미널 화면이 비어 보임 | ⇧⌘D로 진단 파일을 저장해 이슈에 첨부해 주십시오. 터미널 출력이 담기니 공유 전에 내용을 확인하십시오. |
Anthropic 서드파티 정책 준수를 위해 이 앱의 작동 방식을 밝힙니다.
~/.claude/settings.json의 statusLine을 사용량을 읽는 래퍼로 바꿈(기존 statusline 표시는 유지, 나중에를 고르면 건드리지 않음)