DeepSeek Super-Agent란 무엇이고 어떻게 설정할까

DeepSeek Super-Agent란

저장소는 dsh-superagent를 “GitHub 저장소 하나를 위한 능동형 코딩 에이전트로, DeepSeek Harness용 번들로 제공된다”라고 설명해요. 허용 목록에 있는 사람이 일을 요청하면 작업 항목(Ticket)을 열고, 전용 에이전트 세션과 디렉터리에서 작업한 뒤, 원래 대화에 풀 리퀘스트 등으로 답해요. 웹 패널에는 사람이 처리해야 하는 것만 나와요.

DeepSeek은 이를 연구용 프로토타입이라고 하며 “DeepSeek 공식 제품이 아니다”라고 밝혀요. 공개된 코드는 DeepSeek 내부 버전과 다르고, DeepSeek 글에 나온 설계 일부는 앞으로의 방향일 뿐 프로토타입에는 구현돼 있지 않아요.

• 입력 소스: GitHub 알림, 구독 중인 이슈와 풀 리퀘스트, CI 변화, 병합되거나 닫힌 풀 리퀘스트. 추가하면 Feishu 채팅도 받아요.
• 병렬 작업: Ticket마다 worker-<ticket id>라는 이름의 전용 실행 세션과 전용 디렉터리(대개 git worktree 체크아웃)를 갖고, 동시 실행 수는 설정한 상한까지예요.
• 후속 대응: 이슈나 풀 리퀘스트에 나중에 달린 댓글은 그 건을 맡은 Ticket에 전달되므로 에이전트를 다시 멘션할 필요가 없어요.
• 스스로 정한 규칙: “사람의 주의를 최대한 덜 쓰고, 최대한 많은 가치를 준다.” 요청은 한 번만 확인하고, 작업하는 동안은 조용히 있다가, 결과나 질문이나 실패가 있을 때만 다시 연락해요.

정말 능동적일까? 세 가지 accept 모드

언론에서는 묻지 않아도 버그를 고치는 에이전트라고 소개해요. 문서는 더 신중해요. 허용된 사람의 직접 요청은 언제나 통하지만, 아무도 요청하지 않은 작업에는 팀이 직접 쓴 규칙이 필요하고, 기본 모드는 에이전트가 했을 일을 기록만 해요.

dsh-superagent 설정 방법

Node.js 22.19+ 또는 24+, pnpm, git 2.32+, tmux, Python 3.8+, GitHub CLI 2.48+, DeepSeek Harness 0.2.1-alpha.2 또는 이후의 0.2 릴리스, 그리고 DeepSeek Harness에 설정한 모델 제공자가 필요해요. 설정 과정이 길어서, 저장소는 내 코딩 에이전트가 단계별로 안내하게 해 둬요.

1. DeepSeek Harness 설치하기

   DeepSeek Harness(dsh)는 DeepSeek의 오픈소스 에이전트 하네스로, 개발자 프리뷰 단계예요. 한 번 실행해 모델 제공자를 설정하세요. Web UI는 http://127.0.0.1:3080에서 열려요.

   npx @deepseek-ai/dsh web

2. 저장소를 클론하고 SETUP.md를 코딩 에이전트에 넘기기

   체크아웃한 디렉터리에서 코딩 에이전트에게 SETUP.md를 읽게 하세요. 에이전트가 내 컴퓨터를 살펴보고, 메시지마다 질문을 하나씩 하고, 전체 계획을 한 번 보여 준 뒤에야 설치를 시작해요.

   git clone https://github.com/deepseek-ai/dsh-superagent-prototype.git
   cd dsh-superagent-prototype
   # then ask your coding agent:
   # Read SETUP.md in this repository and set up dsh-superagent with me.

3. 설정 질문에 답하기

   요청이 들어오는 곳(GitHub만 쓸지 Feishu도 쓸지), 어느 저장소인지, 에이전트가 쓸 GitHub 계정(전용 계정을 쓰고 내 계정은 절대 쓰지 않기), 어떤 로그인이 일을 요청할 수 있는지, 각 Ticket이 체크아웃할 클론, 커밋 작성자 이름, 에이전트가 auto-merge를 켜도 되는지(권장 답변은 “아니요”).

4. 나만 할 수 있는 단계 하기

   에이전트용 GitHub 계정을 만들고, 그 계정으로 저장소 초대를 수락하고, CLI에 로그인하세요. 에이전트는 채팅에서 비밀 값을 절대 묻지 않고, 내 터미널에서 실행할 정확한 명령어를 알려 줘요.

5. 적용되는 기본값 확인하기

   superagent라는 별도의 DeepSeek Harness 프로필(포트 3082), agent/로 시작하는 브랜치, accept 모드 observe, 그리고 에이전트가 멈췄으면 다시 시작하는 1시간마다의 점검.

6. 첫 요청 보내기

   허용된 계정으로 이슈에 @<agent login> <request>라고 댓글을 다세요. 약 1분 안에 패널에 Ticket이 나타나고, 에이전트가 접수를 알린 뒤 전용 디렉터리에서 작업하고 같은 스레드에 답해요. 보통은 풀 리퀘스트예요.

출처: GitHub의 dsh-superagent 저장소

안전: 실행하기 전에 알아 둘 것

• 워커는 내 OS 사용자로서 danger-full-access로 실행돼요. 홈 디렉터리를 읽을 수 있고 경로만 알면 어떤 프로그램이든 실행할 수 있어요. 계정 래퍼는 자격 증명을 고를 뿐 보안 경계가 아니에요.
• 격리하려면, DeepSeek 문서는 에이전트의 자격 증명만 가진 전용 OS 계정으로 실행하라고 해요.
• 에이전트가 쓰는 모든 것은 에이전트의 GitHub 계정 이름으로 올라가므로, 설정 과정에서는 전용 계정과 처음에는 짧은 허용 목록을 권장해요.
• 메시지나 댓글로는 누가 일을 요청할 수 있는지 바꿀 수 없어요. 허용 목록, 규칙, accept 모드는 패널에서만 바꿀 수 있어요.
• 매 턴이 끝난 뒤 백그라운드 작업이 끝날 때까지 최대 30분을 주고, 그 뒤에는 셸 작업이 중지되고 Ticket이 대기 상태로 표시돼요.
• 연구용 프로토타입이고, DeepSeek Harness는 개발자 프리뷰라서 호환성이 깨지는 변경이 예상돼요.

DeepSeek Super-Agent vs ChatGPT dots vs Crewmark

셋 모두 내가 채팅에 없어도 계속 일하는 에이전트지만, 일을 시작하는 방식이 달라요. Super-Agent는 멘션이나 팀이 쓴 규칙을 기다리고, ChatGPT dots는 OpenAI의 클라우드에서 살아요. Crewmark는 DeepSeek Harness를 포함해 이미 쓰고 있는 코딩 에이전트를 일정에 맞춰 깨워요.

DeepSeek Harness, Claude Code, Codex 세션을 능동적으로 만들기

Super-Agent는 저장소마다 별도의 프로필, 계정, 설정이 필요해요. Crewmark는 DeepSeek Harness를 포함해 이미 쓰고 있는 에이전트와 그대로 함께 작동해요. 그 세션에 직무, 목표, 근무 시간을 주고, 하트비트로 깨워서 보드에서 다음 이슈를 가져가게 해요. 저장소 하나에 한정되지 않고 어떤 종류의 일에도 쓸 수 있어요.

1. 세션을 직원으로 만들기

   소프트웨어 엔지니어나 SEO 전문가 같은 직무를 고르고, 목표를 숫자로 적은 다음, DeepSeek Harness, Claude Code, Codex, OpenCode 중 하나에서 설정 명령어를 실행하세요.

2. 하트비트로 일을 시작하게 하기

   근무 시간 중에 직원은 15분, 30분, 60분마다 같은 대화에서 깨어나 하던 일을 이어서 해요. Claude Code를 능동적으로 만드는 방법을 참고하세요.

3. 이슈를 맡기고 메시지에 답하기

   보드에 일을 올리면 직원이 가져가서 진행하며 댓글을 달고, 결정이 필요하면 메시지를 보내요. AI 직원이란도 읽어 보세요.

DeepSeek Super-Agent 자주 묻는 질문