아티클
Deckhand 소개: Claude Code를 서드파티 AI 컨트롤 타워로 만들기
Deckhand는 오픈소스 Claude Code 플러그인으로, 입력창 상단에 툴바를 추가합니다. Codex, Cursor agent, agy에 읽기 전용으로 작업을 위임해 세컨드 오피니언을 얻고, Sub5로 서브에이전트를 병렬 실행하며, 사용량 지표 및 모델 전환 기능을 제공합니다. 설치 방법, 주요 기능 활용법, 데이터 흐름과 알려진 제한 사항을 정리합니다.
· 6분 분량
Deckhand는 입력창 상단에 툴바를 추가해 주는 Claude Code 플러그인입니다. Claude가 여전히 메인 에이전트 역할을 담당하며, 툴바를 통해 작업을 Codex, Cursor agent 또는 agy에 읽기 전용으로 위임할 수 있습니다. 결과가 반환되면 Claude가 이를 검토한 뒤 채택 여부를 결정합니다.
툴바는 사용량 지표, 모델 전환, 그리고 작업을 여러 서브에이전트에 분할하여 병렬 처리하는 Sub5 기능도 제공합니다. 터미널과 데스크톱 앱 모두에서 사용할 수 있습니다. 현재 버전은 1.1.1이며, MIT 라이선스입니다.
공개: Deckhand는 본 블로그 작성자가 개발했습니다.
기능 한눈에 보기#
| 섹션 |
기능 |
cL cS cA cR gF |
다른 AI CLI에 작업을 읽기 전용으로 위임하고, Claude가 결과를 검토 |
Sub5 |
현재 작업을 최대 5개로 분할하여 서브에이전트가 각자의 git worktree에서 병렬 처리 |
O F S H |
Opus, Fable, Sonnet 또는 Haiku로 전환 |
| 사용량 지표 |
5시간 윈도우, 모델별 주간 윈도우, 전체 모델 합산 주간 윈도우, 컨텍스트 윈도우 |
Recap |
사이드 창에 현재 컨텍스트를 요약 설명 |
⚙ |
설정 창 열기 |
설치 및 요구사항#
Claude Code에서 다음을 실행합니다.
/plugin marketplace add stephen-taipei/deckhand
/plugin install deckhand@deckhand
툴바가 나타나지 않으면 새 세션을 시작하세요.
요구사항:
- macOS 또는 Linux. Windows는 아직 테스트되지 않았습니다.
- 플러그인 hook 모듈을 지원하는 Claude Code(2.1.288에서 테스트 완료).
- Python 3.9 이상.
- 선택 사항: 모니터링 기능에는
gh가 필요하며, 위임 버튼에는 codex, Cursor agent 또는 agy CLI가 필요합니다. 설치되지 않은 CLI의 해당 버튼은 숨겨집니다.
위임: 읽기 전용 세컨드 오피니언#
위임 버튼을 누르면 Deckhand가 해당 CLI에 작업을 넘깁니다. 상대 CLI는 읽기만 가능하고 수정은 불가능하며, 작성된 답변은 Claude로 전달되어 검토를 거칩니다.
기본 위임 대상:
| 버튼 |
CLI |
모델 |
Effort |
cL |
Codex |
GPT-6 Luna |
max |
cS |
Codex |
GPT-6.1 Sol |
medium |
cA |
Codex |
GPT-6 Astra |
medium |
cR |
Cursor agent |
Grok 4.7 |
high |
gF |
agy |
Gemini 3.8 Flash |
high |
라벨, CLI, 모델 ID, effort 및 이름은 설정에서 변경할 수 있습니다.
읽기 전용 제한은 각 CLI 자체의 플래그나 모드로 강제됩니다.
- Codex:
-s read-only
- Cursor agent:
--mode ask
- agy: headless 모드(도구 호출이 자동으로 거부됨)
전송 전 Deckhand는 작업 설명을 검사하며, 토큰, API 키, 비밀번호가 포함된 경우 전송을 거부합니다. 작업 설명과 답변은 비공개 임시 폴더에 저장되며 3일 후 삭제됩니다.
위임 실행 중에는 사용량 표시줄 상단에 한 줄이 추가되어 라벨, CLI, 모델, 실행 시간을 보여줍니다. /delegates는 최근 3일간의 위임 내역을 나열하며, 각 답변을 열거나 복사하거나 입력창으로 가져올 수 있고 CLI가 보고한 토큰 수도 표시합니다.
위임 시 작업 설명이 해당 CLI 뒤의 서비스 제공업체로 전송됩니다.
Sub5: 병렬 서브에이전트#
Sub5는 현재 작업을 서로 독립적인 최대 5개 항목으로 분할하고, 각 항목을 서브에이전트가 각자의 git worktree에서 처리하도록 합니다. 모두 완료되면 메인 에이전트가 결과를 검토하고, 변경 사항을 통합하며, worktree와 브랜치를 정리합니다.
git 작업은 스크립트 bin/sub5.py에 의해 실행되며, force를 사용하지 않고 push도 하지 않습니다. 서브에이전트의 모델, effort, 최대 항목 수는 설정에서 조정할 수 있습니다.
run이 중단되었을 때(턴 중단, 워커 실패, 세션 종료 등) worktree와 브랜치가 남을 수 있습니다. /sub5-clean은 이러한 잔여 항목을 나열하고, 확인 후 커밋되지 않은 변경 사항이 없는 worktree와 이미 병합된 브랜치만 삭제합니다. 최근 1시간 이내에 사용된 항목은 유지됩니다.
항목 간에 상호 의존성이 있는 경우 Sub5 사용에 적합하지 않으며, 병렬 처리는 통합 시 충돌만 증가시킬 뿐입니다.
모델 전환#
O, F, S, H는 각각 Opus, Fable, Sonnet, Haiku입니다.
- 터미널: 현재 세션의 모델을 바로 전환하며, 기존 effort 레벨을 유지합니다.
- 데스크톱 앱: Claude Code는 플러그인이
/로 시작하는 프롬프트를 전송하는 것을 허용하지 않으며, 앱 역시 세션이 자체 모델을 변경하는 것을 허용하지 않습니다. 따라서 버튼을 누르면 /model claude-opus-5-5와 같은 전체 모델 ID가 입력창에 자동으로 채워집니다. Enter 키를 눌러야 전환되며, 이후 Deckhand가 effort를 기존 레벨로 되돌립니다.
사용량 지표#
5h: 5시간 윈도우.fb, sn, op: 계정이 보유한 각 모델의 주간 윈도우.7d: 전체 모델 합산 주간 윈도우.ctx: 컨텍스트 윈도우 사용률.
수치는 Claude 앱의 사용량 카드와 일치하며 버림 처리됩니다. 어느 한 윈도우라도 경고 임계값을 초과하면 Deckhand가 1회 알림을 보내며, 임계값은 설정에서 조정할 수 있습니다.
Recap#
Recap은 사이드 창에서 현재의 전체 컨텍스트를 평이한 언어로 설명해 주며, 대화 내용에는 아무것도 추가하지 않습니다.
모니터링 및 보호 도구#
| 도구 |
용도 |
/watch-deploy, watch_deploy |
백그라운드에서 PR, CI 실행 또는 URL을 모니터링하고, N회 연속 동일한 결과가 나오면 자동 중지 |
| 폴링 보호 |
sleep 폴링 루프나 gh run watch 같은 블로킹 방식의 대기를 차단 |
| 서명 보호 |
커밋 및 PR 명령어에서 Co-Authored-By 트레일러와 Claude Code 푸터를 제거 |
/handoff, /handoff-in, /codex |
Claude와 Codex 간의 작업 핸드오프 |
translate |
지정된 위임 대상에게 로컬라이제이션 번역을 맡김(기본값: 비활성화) |
search |
지정된 위임 대상에게 출처가 포함된 웹 검색을 맡기고 Claude가 교차 검증(기본값: 비활성화) |
툴바 맨 오른쪽의 ⚙를 클릭하거나 /deckhand를 실행하여 설정 창을 엽니다. 설정 창은 일반, 위임, 번역 및 검색, Sub5, 고급의 5개 탭으로 나뉩니다. 설정은 로컬에 저장되며 JSON으로 내보내 다른 컴퓨터에서 가져올 수 있습니다.
인터페이스는 English, 繁體中文, 简体中文, 日本語, 한국어를 지원하며, 기본값은 Claude Code의 language 설정을 따릅니다.
데이터 흐름#
컴퓨터 외부로 나가는 데이터는 다음 세 가지뿐입니다.
- 위임된 작업 설명: 위임 버튼을 누를 때 선택한 CLI의 서비스 제공업체로 전송됩니다.
- 사용량 수치: Claude Code를 통해 현재 세션의 자격 증명으로 Anthropic의 사용량 엔드포인트를 호출합니다.
- 직접 호출된 도구:
translate와 search는 지정된 위임 대상으로 전송되며, 모니터링 기능은 gh를 통해 GitHub를 조회하거나 지정된 URL을 읽습니다.
알려진 제한 사항#
- Windows는 아직 테스트되지 않았습니다.
- 데스크톱 앱에서는 모델 버튼 클릭 한 번으로 바로 전환되지 않으며, 입력창에서 Enter 키를 눌러야 합니다.
- 위임에는 중지 버튼이 없습니다. Deckhand는 위임을 실행하는 Bash 호출을 감시할 뿐이며 취소할 수 없습니다.
- 위임된 작업 설명은 서드파티 서비스 제공업체로 전송됩니다.
소스 코드와 전체 문서는 GitHub에서 확인할 수 있습니다. Deckhand는 독자적으로 개발된 플러그인이며 Anthropic의 제품이 아닙니다.