저렴한 모델에서 dsh-superagent 실행하기: GitHub 이슈에서 PR까지

새 GitHub 이슈에서 에이전트를 멘션하고, 차를 마시러 갔다가 돌아오면 풀 리퀘스트가 와 있습니다. 이것이 DeepSeek의 dsh-superagent가 하는 일이며, DeepSeek Harness(DSH)를 통해 CheapTokens 모델에서 실행할 수 있습니다. 아래에서는 설치, 에이전트 전용 GitHub 계정, 첫 테스트 이슈, 그리고 티켓 하나의 예산을 다룹니다.

저장소 자체에서 나온 주의사항이 하나 있습니다. README(2026년 11월 2일 확인)는 이를 참고용 연구 프로토타입이라고 부르며 공식 DeepSeek 제품이 아니라고 밝히고, 여전히 버그가 있을 수 있다고 말합니다. MIT 라이선스이고 main에 커밋이 하나 있으며 릴리스는 없습니다. 실험해도 괜찮은 저장소에서 실행하세요.

실제로 하는 일#

dsh-superagent는 하나의 GitHub 저장소를 위한 능동형 코딩 에이전트로, DeepSeek Harness용 번들로 패키징되어 있습니다. GitHub를 수신합니다. 허용 목록에 있는 사람이 요청하면 작업 항목(문서에서는 Ticket이라고 부름)을 열고, 자체 에이전트 세션과 자체 디렉터리에서 작업한 뒤 원래 대화에 답합니다. 예를 들어 풀 리퀘스트로 답합니다. 웹 패널은 사람이 필요한 항목을 보여줍니다.

즉 이슈 하나가 세션 하나이고, 세션 하나는 모델 호출의 루프입니다. 토큰은 바로 이 루프에서 소모됩니다. 이유가 궁금하다면 AI 에이전트가 왜 그렇게 많은 토큰을 쓰는가에서 20단계 예시를 살펴보세요.

시작하기 전에#

배포 문서에 따르면 다음이 필요합니다:

• Node.js 22.19+ 또는 24+, pnpm, git 2.32+, tmux, Python 3.8+
• GitHub CLI 2.48+ (아래에서 설명하는 작은 래퍼를 통해 사용)
• github.com의 저장소 (GitHub Enterprise Server는 지원되지 않음)
• 저장소의 package.json에 있는 engines.dsh 버전 범위의 DSH
• DSH 모델 제공자

마지막 항목은 저장소가 사용자에게 맡기는 부분입니다. 설정 가이드는 제공자를 운영자 단계라고 부릅니다. CheapTokens의 경우 먼저 DeepSeek Harness를 CheapTokens에 연결하고 돌아오세요. 사용할 모델 id는 deepseek-ai/DeepSeek-V4-Flash-0731(전체 id이며, 가격표의 짧은 이름은 API가 받지 않습니다)이고, API base는 https://api.cheaptokens.dev/v1입니다. 자세한 내용은 CheapTokens 문서 페이지에 있습니다.

주의할 점이 하나 있습니다. 배포 문서에 따르면 설정 과정에서 이름에 KEY, PASSWORD, SECRET 또는 TOKEN이 포함된 환경 변수를 제거하고, 워커 환경에서 GH_TOKEN과 GITHUB_TOKEN를 제거합니다. 따라서 셸에서 export한 제공자 키는 워커에 도달하지 않습니다. 연결 문서에 설명된 대로 설정하세요.

설치 및 시작#

npm install -g @deepseek-ai/dsh@0.2.1-rc.3
git clone https://github.com/deepseek-ai/dsh-superagent-prototype dsh-superagent
cd dsh-superagent
pnpm install && pnpm build

dsh superagent --from-default-profile web --dump-config > /dev/null
dsh plugin --profile superagent add "link:$PWD"

scripts/dsh-superagent start
scripts/dsh-superagent status

상태 명령은 종료 코드로 답합니다: 0은 정상, 1은 재시작이 도움이 될 수 있음, 2는 일부가 실패했고 재시작으로 해결되지 않음, 3은 설정이 아직 필요함을 의미합니다. 기본값으로 시작하세요: 프로필 superagent, 브랜치 접두사 agent/, 그리고 수락 모드 observe은 능동적 작업을 실행하지 않고 기록만 합니다.

에이전트에게 전용 GitHub 계정 부여#

사람들이 건너뛰고 나서 왜 아무 일도 일어나지 않는지 궁금해하는 단계입니다. 에이전트는 저장소에 쓰기 권한이 있는 일반 GitHub 사용자가 필요합니다. GitHub App은 이 역할을 할 수 없습니다.

1. 사용자를 만들고 쓰기 권한이 있는 협력자로 추가합니다.
2. 래퍼 ~/.local/bin/gh-agent 만들기: GH_CONFIG_DIR="$HOME/.config/gh-agent" exec gh "$@". 이렇게 하면 에이전트의 로그인이 자신의 gh와 분리됩니다.
3. 해당 사용자로 gh-agent auth login를 실행합니다.
4. 웹 패널에서 Sources를 열고 저장소(owner/name)와 CLI 경로를 래퍼로 설정합니다.
5. Policy에서 에이전트에게 작업을 줄 수 있는 로그인을 policy.sources.github.allowed에 추가합니다. 누군가 그 목록에 있기 전까지는 아무것도 Ticket이 되지 않습니다.

첫 테스트 이슈#

저장소에서 새 이슈를 열고 작고 명확한 내용을 작성하세요. 에이전트의 로그인을 코드 형식으로 넣습니다. 예: @<agent login> fix the typo in README.md: "recieve" should be "receive".

"새"라는 말이 중요합니다. 오래된 이슈를 편집해 멘션을 추가하면 인식되지 않습니다. 새 이슈나 새 댓글이어야 합니다. 패널에 Ticket이 표시되고 agent/로 시작하는 브랜치가 나타나면 체인이 작동하는 것입니다.

티켓 하나의 비용#

저장소는 티켓당 토큰 사용량을 공개하지 않으므로, 이는 명시된 가정에 기반한 추정치입니다. 작은 티켓이 모델 호출 25회를 사용한다고 가정해 봅시다. 각 호출은 점점 커지는 대화를 전달합니다: 평균 약 30,000 입력 토큰과 약 800 출력 토큰(명령, 패치, 짧은 메모).

티켓당 30,000 × 25 = 750,000 입력 토큰과 800 × 25 = 20,000 출력 토큰입니다. 오늘의 CheapTokens 가격(1M 토큰당 입력 $0.015, 출력 $0.10)으로 DeepSeek-V4-Flash에서 이런 티켓 하나는 $0.0133입니다.

한쪽으로 치우친 부분: 입력이 출력의 약 37배이며, 이는 에이전트에서 정상입니다. 매 단계마다 이전 내용을 다시 보내기 때문입니다. 같은 티켓을 다른 모델에서 실행하면:

표에는 GLM-5.3-Flash(390K 컨텍스트, 답변당 최대 8,192 출력 토큰)도 나열되어 있습니다. 티켓이 짧고 답변이 작다면 이 모델을 고려하세요. 긴 도구 루프에는 DeepSeek-V4-Flash가 380K 컨텍스트, 답변당 최대 32,768 토큰, 시간대와 무관한 단일 가격을 제공합니다. 실제 수치는 다를 것이므로 슬라이더를 움직여 보세요:

입력 쪽을 줄이고 싶다면 AI 에이전트의 비용을 추정하는 방법에서 가장 중요한 습관을 다룹니다.

짧은 목줄로 유지하기#

하루 동안 observe 모드에 머무르세요. 에이전트가 스스로 무엇을 할지 기록하므로 행동하기 전에 패턴을 볼 수 있습니다. 처음에는 자신의 로그인만 허용하세요. 처음 세 개의 풀 리퀘스트를 한 줄씩 살펴보고, 첫날 이후 잔액에서 모델 사용량을 확인한 뒤 실제 티켓 수를 곱하세요.

저장소는 또한 DeepSeek의 동반 기사에 있는 일부 설계가 아직 구현되지 않았다고 밝히므로, 빠진 기능은 미완성으로 여기고 자신의 실수로 생각하지 마세요.

출처#

모든 저장소 사실은 deepseek-ai/dsh-superagent-prototype(README, SETUP.md, docs/006-deployment.md)에서 2026년 11월 2일에 확인했습니다. 저장소 페이지에는 커밋 날짜가 표시되지 않고 DSH 버전 0.2.1-rc.3은 릴리스 후보이므로, 설치 전에 문서를 다시 확인하세요.