AI 소식

딥시크 슈퍼에이전트, 코드 작업 설치 조건과 주의점

딥시크의 연구용 도구가 요청을 받아 코드를 고치는 방식을 소개합니다. 2026년 10월 공개 기준이며, 설치 조건과 실행 격리 장치가 없다는 한계를 살펴봅니다.

GROWBEAT Editorial
첫 공개
10분
대표 이미지 — DeepSeek 로고

개발자와 함께 일하는 마케터, 사내 도구를 AI로 고쳐 보려는 1인 사업자와 실무자를 위한 글입니다.

딥시크가 스스로 버그를 고치는 에이전트를 내놨다는 소식을 보면, 우리 팀도 바로 붙여도 되는지, 쓰던 Claude Code를 바꿔야 하는지 궁금해집니다. 그런데 기사 제목만으로는 완성된 제품인지 실험 코드인지 구분하기 어렵습니다.

이 글에서는 공식 저장소 문서를 기준으로 슈퍼에이전트가 실제로 하는 일과 설치 조건, 보안 한계, 지금 써 볼 사람과 기다릴 사람을 정리합니다.

딥시크 슈퍼에이전트는 무엇이고 언제 공개됐나요?

딥시크 슈퍼에이전트는 DeepSeek Harness 팀이 2026년 10월 31일 깃허브에 MIT 라이선스로 공개한 연구용 코딩 에이전트 프로토타입입니다. 저장소 이름은 dsh-superagent-prototype입니다.

코딩 에이전트는 코드를 읽고 고치고 실행까지 하는 AI 작업자를 말합니다. 하네스(harness)는 AI 모델 바깥에서 작업 흐름을 조정하고 외부 도구를 연결하는 소프트웨어입니다.

저장소 README는 이 코드를 참고용 연구 프로토타입이자 딥시크 공식 제품이 아닌 것으로 설명합니다. 내부 버전과 같지 않고, 설계 글에 나온 일부 구상은 아직 구현되지 않았습니다.

2026년 11월 2일 확인 기준 저장소의 별은 6.9k개, 포크는 693개입니다. 디지털투데이는 블룸버그 보도를 인용해 Claude Code를 겨냥한 공개로 소개했고, AI타임스와 토큰포스트도 같은 내용을 2026년 11월 1일 보도했습니다.

기존 코딩 에이전트와 무엇이 다른가요?

가장 큰 차이는 팀의 깃허브 저장소 하나를 맡아 상주하면서 요청을 받는 방식으로 설계했다는 점입니다. 다만 AI타임스는 Claude Code와 Codex도 이미 하위 에이전트, 병렬 실행, 백그라운드 자동화를 지원한다고 짚었습니다.

01듣기: 깃허브를 살피고, 설정하면 Feishu(중국 협업 메신저) 대화도 받습니다.
02접수: 허용된 사람이 부르면 작업 항목을 엽니다.
03실행: 작업마다 독립된 세션과 폴더에서 일합니다.
04답변: 요청이 시작된 대화에 결과를 답합니다. PR(코드 변경안을 사람에게 검토 요청하는 단위)을 올리기도 합니다.
05호출: 사람이 처리할 항목만 웹 패널에 보여 줍니다.
말풍선에서 나온 요청이 작은 로봇 여러 대가 일하는 칸막이 공간으로 들어가고, 완성된 서류가 사람 앞 검토대로 돌아오는 흐름을 화살표로 그린 장면
말풍선에서 나온 요청이 작은 로봇 여러 대가 일하는 칸막이 공간으로 들어가고, 완성된 서류가 사람 앞 검토대로 돌아오는 흐름을 화살표로 그린 장면

"먼저 알아서 움직인다"는 제목은 그대로 받아들이면 안 됩니다. 요청 없이 시작하려면 팀이 쓴 규칙이 있어야 하고, 기본 모드에서는 기록만 남깁니다.

모드동작언제 쓰나
off추정 요청을 후보로 삼지 않음명시적 요청만 받을 때
observe(기본값)맡을 만한 일을 기록만 하고 시작하지 않음도입 초기에 판단 품질을 볼 때
auto후보를 긍정 평가하면 작업을 수락기록을 검토해 믿을 만해진 뒤

명시적 요청은 세 모드 모두에서 처리됩니다.

47% 빨라졌다는 수치는 믿어도 되나요?

업무 성과 수치로 받아들이면 안 됩니다. AI타임스가 전한 딥시크 기술 문서에 따르면, 약 300개 메시지와 20개 작업 요청을 모의로 처리했을 때 작업의 95%가 15.7분 안에 끝나 단일 세션 방식의 29.5분보다 약 47% 짧았습니다.

이 실험은 여러 작업을 나눠 처리하는 효율을 잰 회사 자체 측정입니다. 같은 보도에 따르면 실제 코딩 실력이나 Claude Code, Codex와의 직접 비교가 아니고, 캐시 토큰 사용량은 오히려 더 많았습니다.

기사에서 확인한 수치이며, 위챗 원문은 접속 제한으로 직접 대조하지 못했습니다. 비용 절감 근거로 쓰기 전에 자기 저장소에서 다시 재 보는 편이 안전합니다.

설치하려면 무엇이 필요하고 슬랙도 연결되나요?

터미널을 다룰 줄 아는 사람이 없으면 당장 설치하기 어렵습니다. 기본 연결도 GitHub와 Feishu 두 가지뿐이라, Slack이나 카카오톡 중심인 팀은 연동 코드를 직접 개발해야 합니다.

항목저장소 문서 기준 조건
실행 환경Node.js 22.19 이상 또는 24 이상, pnpm, git 2.32 이상, tmux, Python 3.8 이상, GitHub CLI 2.48 이상
기반 도구DeepSeek Harness(개발자 미리 보기 단계)
계정운영자와 분리된 에이전트 전용 GitHub 계정
AI 모델직접 연결한 모델 제공사
실행 장소tmux 세션에서 오래 도는 프로세스

모델은 딥시크 전용이 아닙니다. 하네스 문서는 anthropic, openai, moonshotai, zai 같은 제공사와 OpenAI·Anthropic 호환 사용자 지정 주소를 안내합니다.

설치는 기존 코딩 에이전트에게 SETUP.md를 읽혀 진행하지만, 전용 계정 생성과 로그인은 운영자가 직접 합니다.

한국어 지원과 국내 요금은 저장소 문서에서 확인되지 않았습니다. 국내 적용 시점은 공식 발표 기준 미정입니다.

회사 저장소에 바로 붙여도 안전한가요?

바로 붙이면 안 됩니다. 실행 문서는 샌드박스(프로그램을 격리하는 울타리)가 없고, 워커가 운영자의 OS 사용자 권한으로 승인 없이 명령을 실행한다고 밝힙니다.

위험 지점문서가 밝힌 내용대응
실행 권한명령 래퍼와 폴더 구조는 보안 경계가 아님에이전트 인증 정보만 있는 전용 OS 계정 사용
코드 병합자동 병합 조건은 에이전트 지시문이지 강제 장치가 아님GitHub 브랜치 보호를 켜고 사람이 병합
요청 권한미등록자 칸을 명시적 요청으로 열면 범위 안의 누구나 요청 가능기본값인 무시를 유지
권한 회수허용 설정을 줄여도 열린 작업이 바로 멈추지는 않음패널에서 직접 중단

프롬프트 인젝션(글 속에 숨긴 지시로 AI를 속이는 공격)도 살펴야 합니다. 문서는 메시지와 댓글이 권한을 바꿀 수 없다고 설명합니다. 다만 작업 스레드의 댓글은 맥락으로 전달되므로, 외부인이 댓글을 쓸 수 있는 공개 저장소에서는 일반적인 위험으로 보고 대비하는 편이 좋습니다.

데이터 경로도 확인하세요. 연결한 모델 제공사의 약관과 처리 지역이 그대로 적용됩니다. DeepSeek 공식 API의 데이터 처리와 요금은 딥시크 V4.1 플래시 정리 글에서 볼 수 있습니다. 개발 도구 자체의 감염 점검은 Cursor·Claude Code 확장 악성코드 글을 참고하세요.

우리 팀은 지금 써 봐야 하나요 기다려야 하나요?

깃허브에 익숙한 개발자가 있고 시험용 저장소를 따로 둘 수 있으면 지금 시험해 볼 만합니다. 코드를 직접 검토할 사람이 없거나 고객 데이터가 있는 저장소라면 기다리는 쪽을 권합니다.

상황판단이유
개발자 있음, 시험용 저장소 있음지금 시험observe 모드로 판단 품질을 볼 수 있음
비개발자, 1인 사업자기다림PR을 검토할 사람이 없으면 위험을 판단하기 어려움
고객 정보·결제 코드가 있는 저장소기다림샌드박스 없음, 연구용 코드
Slack·카카오톡 중심 팀기다림연동을 직접 개발해야 함

시험 순서는 아래를 권합니다. 기간과 인원은 문서 값이 아닌 제안입니다.

01실제 서비스와 무관한 시험용 저장소를 만듭니다.
02전용 GitHub 계정과 전용 OS 계정을 준비합니다.
03허용 목록에 1~2명만 넣고 observe 모드를 유지합니다.
04브랜치 보호를 켜고 병합은 사람이 합니다.
051주일 동안 맡으려던 일의 기록을 읽고 그다음 범위를 정합니다.

코딩 에이전트가 처음이라면 슈퍼에이전트보다 Claude Code 무료 입문 강의로 PR과 권한 개념부터 익히는 편이 빠릅니다.

설치 없이 오늘 해 볼 일

지금 쓰는 AI 에이전트의 지시문에 세 줄을 적어 보세요. 허락 없이 해도 되는 일, 결과를 보고하고 기다릴 일, 절대 하지 않을 일입니다. 슈퍼에이전트 문서의 짧은 허용 목록과 기록 우선 원칙을 그대로 빌린 방법입니다.

자주 묻는 질문

Claude Code를 해지하고 옮겨야 하나요?

지금 옮길 근거는 없습니다. 공개된 실험은 Claude Code와의 직접 비교가 아니고, 슈퍼에이전트는 연구용 프로토타입입니다.

무료로 쓸 수 있나요?

코드는 MIT 라이선스로 공개돼 내려받을 수 있습니다. 다만 연결한 모델의 사용료는 따로 나가고, 자체 실험에서도 캐시 토큰 사용량이 늘었으므로 사용량 한도를 먼저 정해 두세요.

참고 자료

태그
#딥시크#DeepSeek#딥시크 슈퍼에이전트#코딩 에이전트#오픈소스 AI
무료 맞춤 보고서 받기