코딩 에이전트를 플러그인으로 조립하는 DeepSeek Harness

코딩 에이전트를 플러그인으로 조립하는 DeepSeek Harness

DeepSeek Harness 썸네일

AI 코딩 도구를 바꾸려면 모델뿐 아니라 파일 접근, 셸 실행, 권한 정책, 세션 저장 방식까지 함께 손봐야 할 때가 많아요. DeepSeek Harness는 이 구성 요소를 플러그인으로 분리해 필요한 실행 환경을 조립하도록 만든 오픈소스 코딩 에이전트예요. 1

핵심 요약

구분	내용	확인할 점
구조	모델, 도구, 세션, 샌드박스, 실행 루프와 UI를 플러그인으로 다뤄요	교체 범위가 넓은 만큼 플러그인 간 호환성 관리가 필요해요
실행	Web UI와 Python SDK를 제공해요	Node.js를 설치하면 `npx @deepseek-ai/dsh web`으로 Web UI를 열 수 있어요
기록	모델 입력과 도구 호출 결과를 추가 전용 세션 로그에 남겨요	같은 이벤트 기록으로 실행 재개, 분기, 검색과 재생을 지원해요
상태	MIT 라이선스의 개발자 미리보기예요	호환성을 깨는 변경이 생길 수 있다고 공식 문서가 밝혀요

1. 고정된 코어 대신 실행 환경을 조립해요

DeepSeek Harness가 내세우는 설계는 "Everything is a Plugin"이에요. 모델 어댑터와 도구만 확장하는 수준에서 멈추지 않아요. 파일시스템, 셸, 샌드박스, 승인 정책, 세션 저장, 작업 실행 루프와 화면 구성도 교체 가능한 단위로 나눠요. 공식 소개 페이지는 모델, 도구, 스킬, 세션, 저장소, 스케줄링과 UI까지 플러그인으로 바꾸거나 다시 조합할 수 있다고 설명해요. 2

기반에는 Cordis라는 플러그인 프레임워크를 써요. 각 플러그인은 서비스와 이벤트를 등록하고, 비활성화될 때 자신이 만든 리소스를 함께 정리해요. 여러 기능을 한 코드 덩어리에 계속 붙이는 대신 수명 주기와 의존성을 플러그인 경계 안에서 관리하려는 방식이에요.

728x90

설정은 Profile과 Bundle로 묶어요. 기본 Web 구성이나 헤드리스 구성 위에 필요한 플러그인을 더할 수 있어요. 팀에서 쓰는 모델 게이트웨이, 별도 권한 규칙, 자체 도구를 한 실행 환경에 조합하려는 경우에 맞아요. DeepSeek 모델만 강제하지도 않아요. 공개된 설명에는 Anthropic과 OpenAI 계열 공급자, Bedrock, Vertex AI, Azure와 OpenAI 호환 엔드포인트를 연결할 수 있다고 나와 있어요. 1

Web UI와 Python SDK를 함께 제공해요

Node.js가 준비돼 있으면 아래 명령으로 Web UI를 실행할 수 있어요.

```sh npx @deepseek-ai/dsh web ```

기본 주소는 `http://127.0.0.1:3080`이에요. 작업 공간을 고른 뒤 세션을 시작하고, 설치된 플러그인과 실행 기록을 화면에서 확인할 수 있어요. 공식 README는 소스에서 실행하는 방법도 함께 안내해요. 2

Python SDK는 같은 런타임을 애플리케이션이나 자동화 코드에서 호출하는 경로예요. 세션을 유지하면 대화 기록과 지속형 셸 상태를 이어서 사용할 수 있어요. Web UI로 먼저 시험한 구성을 헤드리스 작업이나 별도 서비스 안으로 옮길 때 유용해요.

실행 과정을 이벤트 기록으로 되짚을 수 있어요

세션은 추가 전용 이벤트 로그를 중심으로 저장돼요. 모델이 받은 입력, 추론 기록, 도구 호출과 결과, 하위 작업 예약, 문맥 주입 내역을 출처별로 확인할 수 있어요. 공식 소개 페이지의 Trajectory 화면은 이 기록을 한 실행 흐름으로 보여줘요. 3

실행 재개와 분기, 검색, 재생도 같은 이벤트 스트림을 사용해요. 코딩 에이전트가 파일을 왜 바꿨는지 확인하거나 실패 지점 직전에서 다른 경로를 시험할 때 기록 체계가 도움이 돼요. 결과물만 남기는 도구보다 원인 조사와 재현에 필요한 정보가 많아요.

개발자 미리보기라는 제한은 분명해요

저장소는 MIT 라이선스로 공개됐어요. 다만 공식 README는 현재 상태를 개발자 미리보기로 부르고, 빠르게 개발 중이라 호환성을 깨는 변경이 생길 것이라고 경고해요. 2

플러그인 범위가 넓으면 자유도와 관리 부담이 함께 커져요. 버전이 바뀔 때 여러 플러그인의 의존성과 설정을 같이 점검해야 할 수 있어요. 당장 조직의 표준 코딩 도구로 고정하기보다, 교체하고 싶은 구성 요소가 명확한 팀이 작은 작업 공간에서 시험해 보는 편이 안전해요.

왜 중요한가요

코딩 에이전트의 성능은 모델 선택만으로 정해지지 않아요. 같은 모델을 써도 어떤 파일을 읽을 수 있는지, 명령 실행 전에 승인받는지, 실패한 작업을 어디서 다시 시작하는지에 따라 실제 사용 경험이 달라져요. DeepSeek Harness는 이 실행 조건을 플러그인과 설정으로 드러내요. 3

개발팀에는 두 가지 실용적인 선택지가 생겨요. 기존 제품의 고정된 실행 방식을 받아들이거나, 필요한 모델·도구·권한·기록 체계를 조합해 팀 전용 환경을 만들 수 있어요. 후자를 택하면 유연성은 커지지만 업그레이드와 플러그인 호환성도 팀이 관리해야 해요.

현재 공개 상태만 보면 완성된 표준 도구보다 실험할 수 있는 기반에 가까워요. 실행 추적, 자체 모델 게이트웨이 연결, 권한 정책 교체처럼 요구가 구체적인 팀이라면 살펴볼 이유가 있어요. 안정적인 장기 운영이 우선이라면 호환성 정책과 릴리스 흐름이 자리 잡는지 더 지켜봐야 해요.

참고 자료

1. DeepSeek Harness - 모든 구성 요소를 플러그인으로 만든 오픈소스 코딩 에이전트 — GeekNews
2. DeepSeek Harness: Everything is a Plugin — DeepSeek AI GitHub
3. DeepSeek Harness developer preview: Everything is a plugin — DeepSeek