SSD Nodes Learn Hosting plans →
가이드 Matt Connor작성자 Matt Connor

DeepSeek Harness, Claude Code, Omnigent 비교 분석

DeepSeek Harness, Claude Code, Omnigent의 아키텍처와 모델 결합 방식, 라이선스 및 성숙도를 비교합니다. VPS 환경에서 각 도구를 구동하기 위한 필수 요구 사항과 기술적 차이점을 상세히 정리하여 프로젝트에 적합한 에이전트 하네스 선택을 돕습니다.

DeepSeek Harness, Claude Code, Omnigent 비교: 무엇이 필요한가

DeepSeek Harness, Claude Code, Omnigent는 모두 에이전트 하네스(agent harness)라고 불리지만, 문제의 각기 다른 부분을 해결합니다. DeepSeek Harness는 사용자가 모델을 직접 제공하는 웹 UI(사용자 인터페이스) 기반의 플러그인 런타임입니다. Claude Code는 Anthropic 모델을 구동하는 Anthropic의 터미널 프로그램입니다. Omnigent는 Databricks에서 제공하는 오케스트레이터로, 자체적인 에이전트 루프를 구현하는 대신 Claude Code를 포함한 다른 하네스를 제어합니다. 이들은 서로를 완전히 대체할 수 있는 관계가 아니므로, 현재 시스템에서 어떤 계층이 부족한지 파악하는 것이 중요합니다. 이러한 관점이 생소하다면 에이전트 하네스의 실제 정의를 통해 이 세 도구가 루프, 도구, 권한, 세션 상태라는 요소를 어떻게 나누어 처리하는지 확인하십시오.

실제 차이가 발생하는 기준은 아키텍처, 모델 결합 방식, 인터페이스, 성숙도, 라이선스입니다. 아래의 버전과 날짜는 2026년 8월 18일에 처음 확인되었으며, 2026년 10월 20일에 각 프로젝트의 자체 문서, 릴리스 페이지, 패키지 레지스트리를 통해 재확인되었습니다. 버전 번호, 릴리스 상태, 런타임 요구 사항은 2026년 10월 27일에 다시 검토되었습니다. 문장에 별도의 날짜가 명시된 경우 해당 날짜가 적용됩니다. 세 도구 중 두 가지는 변화 속도가 매우 빠르므로, 도입을 결정하기 전에 반드시 다시 확인해야 합니다.

DeepSeek Harness란 무엇이며, 플러그인 모델은 어떤 이점을 제공합니까?

DeepSeek은 2026년 8월 github.com/deepseek-ai/deepseek-harness를 통해 DeepSeek Harness, 즉 dsh을 공개했습니다. 저장소 설명은 전체 설계를 "모든 것은 플러그인이다"라는 네 단어로 정의합니다. 모델 어댑터, 도구 레지스트리, 세션 로그, 샌드박스, 그리고 에이전트 루프 자체가 모두 Cordis 기반 런타임에 의해 로드되는 플러그인입니다. 도입 속도는 이례적으로 빨랐으며, 저장소는 공개 며칠 만에 150,000개의 별을 받았습니다(2026년 8월 18일 확인).

DeepSeek Harness는 개발자 프리뷰 단계이며 빠르게 반복 개선되고 있습니다. 호환성을 깨뜨리는 변경 사항이 발생할 것입니다.

이는 README에 명시된 경고이며, 이 비교에서 가장 중요한 문장입니다. 오늘날 플러그인 API(application programming interface)를 사용하여 작성하는 모든 코드는 향후 다시 작성해야 한다고 예상해야 합니다.

Node.js가 설치된 환경에서 npx로 시작하십시오.

npx @deepseek-ai/dsh web

이 명령은 URL을 출력하며, 로컬에서 실행할 경우 기본 브라우저에서 해당 URL을 자동으로 엽니다. 기본적으로 웹 UI는 http://127.0.0.1:3080에서 서비스되며, 출력된 URL에는 브라우저 로그인을 위한 최신 프로세스 토큰이 포함되어 있으므로 단순히 주소만 입력하지 말고 해당 URL을 그대로 여십시오. 이 주소는 단순한 기본값이 아니라 의도적인 바인딩이며, 127.0.0.1 바인딩이 UI 접근에 의미하는 바는 dsh이 브라우저와 다른 머신에서 실행되는 순간 중요해집니다. 2026년 10월 27일 기준으로, 공개된 모든 빌드는 릴리스 후보(release candidate)나 알파 버전인 프리릴리스였으며 안정적인 릴리스는 없었습니다(당시 npm의 latest 태그는 여전히 0.2.1-rc.2를 가리켰고 next 태그는 0.2.1-rc.4로 앞서 나간 상태였습니다). 따라서 명령이 실패하거나 예상치 못한 버전으로 부팅된다면, 특정 dsh 버전을 고정하고 npx 캐시를 삭제하는 것이 가장 빠른 해결책입니다. 소스에서 빌드하려면 대신 pnpm을 사용하십시오.

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

dsh web은 dsh --profile web의 약어입니다. 프로필은 $DSH_HOME/profiles/ 하위의 디렉터리이며, 런처는 지정한 프로필을 부팅합니다. 헤드리스 프로필도 존재하기 때문에 이 점이 중요합니다. dsh --profile headless "job"는 하나의 지속 세션을 실행하고 결과를 출력한 뒤 종료되는데, 이는 cron 작업이나 빌드 단계에서 원하는 형태입니다. --profile이나 --patch과 같은 런처 플래그는 애플리케이션 자체의 인수보다 앞에 위치해야 합니다. 런처가 핸드오프 지점에서 구문 분석을 중단하기 때문입니다. --port와 같은 플래그는 런처가 아닌 부팅된 프로필에 속하므로 위치가 중요합니다. 플러그인은 dsh plugin --profile web add <package>과 같이 pnpm으로 인수를 전달하여 관리합니다. 플러그인은 에이전트와 동일한 런타임으로 로드되어 권한을 상속받으므로, 플러그인을 설치하기 전에 접근 범위를 확인하십시오.

Claude Code란 무엇이며, 왜 터미널 프로그램인가?

Claude Code는 Anthropic에서 직접 제공하는 CLI(명령줄 인터페이스) 에이전트입니다. 이 CLI는 자체적인 웹 UI를 제공하지 않습니다. Anthropic은 웹, 데스크톱 앱, IDE 확장 프로그램 형태로도 Claude Code를 제공하지만, 이는 별개의 환경이며 서버에서는 CLI를 실행하게 됩니다. 이 도구는 작업하려는 디렉터리의 터미널에서 직접 실행되므로 서버 세션에 매우 적합합니다. 설정할 인터페이스가 없으므로 설정 패널 대신 텍스트를 통해 답변 방식을 제어하며, 출력 스타일을 통해 시스템 프롬프트를 교체하면 세션 내의 모든 응답 형식을 변경할 수 있습니다. macOS, Linux, WSL에서의 설치는 다음 명령 한 줄로 완료됩니다.

curl -fsSL https://claude.ai/install.sh | bash
claude --version

정상적으로 설치되면 버전과 제품명이 출력됩니다(예: 2.1.211 (Claude Code)). 설치에 실패하면 claude doctor를 실행하여 세션을 시작하지 않고도 읽기 전용 설치 및 설정 진단 정보를 확인할 수 있습니다. Node.js 22 이상이 필요한 npm 패키지 npm install -g @anthropic-ai/claude-code도 제공됩니다. 이 패키지는 동일한 네이티브 바이너리를 설치하므로, 설치된 claude는 런타임에 Node.js를 사용하지 않습니다. 또한 Anthropic은 Debian, Ubuntu, Fedora, RHEL, Alpine을 위한 서명된 apt, dnf, apk 저장소를 운영합니다. 구성 관리 도구로 서버를 운영 중이라면 일반적인 업그레이드 워크플로우를 통해 업데이트를 받을 수 있는 저장소 방식을 사용하는 것이 좋습니다.

Anthropic의 설정 문서에 따르면 Claude Code를 사용하려면 Pro, Max, Ultra, Team, Enterprise, Console 계정이 필요하거나 Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry와 같은 지원되는 클라우드 제공업체를 통해 접근해야 합니다. 무료 Claude.ai 플랜은 접근 권한을 포함하지 않습니다. Ollama를 사용하는 경로인 ollama launch claude도 문서화되어 있는데, 이는 Anthropic 자격 증명 없이 Ollama의 Anthropic 호환 API를 통해 로컬 모델을 Claude Code에 연결하는 방식입니다. 단, 이 경우 Claude가 아닌 타사의 모델을 실행하게 됩니다. Anthropic의 모델을 사용할 때 Claude 구독과 API 과금 방식 중 무엇을 선택할지 결정하는 것이 도구 내부의 어떤 설정보다 비용에 훨씬 큰 영향을 미칩니다.

Omnigent이란 무엇이며, 메타 하네스는 무엇을 오케스트레이션합니까?

Databricks는 2026년 6월 Omnigent를 발표하고 Apache 2.0 라이선스로 공개했습니다. 이 프로젝트는 스스로를 메타 하네스(meta-harness)라고 부릅니다. Omnigent는 에이전트 루프를 직접 구현하지 않습니다. 대신 Claude, Codex, Cursor, OpenCode, Hermes, Pi, OpenAI의 agents SDK(software development kit)와 같이 이미 존재하는 에이전트들을 구동합니다. 2026년 10월 기준으로 README에는 GitHub Copilot, Antigravity, Devin, Kiro, Grok Build도 추가되었습니다. 이 목록에 있는 여러 에이전트는 두 가지 형태로 나타납니다. 하나는 벤더의 SDK와 통신하는 형태이고, 다른 하나는 벤더의 실제 터미널 프로그램을 래핑하는 네이티브 형태입니다.

에이전트는 YAML 파일로 정의되며, YAML은 일반 텍스트 구성 형식입니다.

name: my_agent
prompt: You are a helpful data analyst.

executor:
  harness: claude-sdk

tools:
  word_count:
    type: function
    callable: mypackage.mymodule.word_count
  docs:
    type: mcp
    url: https://example.com/mcp
  researcher:
    type: agent
    prompt: Search for relevant information.

executor.harness 줄은 이 프로젝트의 핵심입니다. claude-sdk을 codex로 변경하면 동일한 프롬프트와 도구를 사용하여 다른 벤더에서 실행할 수 있습니다. 도구는 Python 함수, MCP(model context protocol) 서버, 또는 다른 에이전트가 될 수 있습니다. 마지막 사례는 멀티 에이전트 작업이 표현되는 방식인데, 하위 에이전트는 단순히 하나의 도구로 취급됩니다. 기술(skills), MCP 서버, 규칙 파일이 각각 어디에 속하는지 확실하지 않다면 에이전트 기술, MCP, 규칙 파일의 차이점을 먼저 읽어보는 것이 좋습니다. Omnigent는 하위 하네스가 지원하는 기능을 그대로 상속하기 때문입니다.

제공되는 예제는 이 개념을 구체적으로 보여줍니다. Polly는 직접 코드를 작성하지 않는 코딩 오케스트레이터입니다. Polly는 계획을 세우고, 병렬 git 워크트리에서 코딩 하위 에이전트에게 작업을 위임한 뒤, 각 diff를 다른 벤더의 모델에서 실행되는 리뷰어에게 전달합니다.

공개된 스크립트로 설치하십시오:

curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/install_oss.sh | sh

또는 수동으로 설치할 수 있으며, Python 3.12 이상이 필요합니다:

uv tool install omnigent
omnigent setup
omnigent start

pip install "omnigent"도 작동하며, 추가 기능은 uv tool install "omnigent[databricks,modal]"을 사용하여 일반적인 방식으로 선택합니다. omnigent setup는 자격 증명과 기본값을 수집합니다. omnigent start는 로컬 서버를 시작하고 해당 머신을 호스트로 등록한 뒤, 열어야 할 URL을 출력합니다. omnigent server status과 omnigent stop은 매일 사용하게 될 다른 두 가지 명령어입니다. 인자 없이 omnigent만 입력하면 에이전트가 실행되지 않습니다. omnigent와 omni은 모두 동일한 진입점을 호출합니다. 대화형 터미널에서 인자 없이 명령어를 실행하면 로컬 서버와 호스트가 백그라운드에서 시작되고 제어권이 반환됩니다. TTY가 없는 환경에서는 도움말이 출력됩니다. omni claude, omni polly, 또는 omni run agent.yaml으로 에이전트를 실행하십시오.

의존성 목록은 한 줄짜리 설치 프로그램이 암시하는 것보다 깁니다. Python 3.12 이상, uv, git, npm 및 pnpm을 포함한 Node.js 22 LTS(long term support) 이상, 네이티브 터미널 래퍼를 위한 tmux, 그리고 Linux 샌드박스를 위한 bubblewrap(bwrap)이 필요합니다. 이는 설계상 필연적인 결과입니다. Omnigent는 벤더 CLI를 감독하고 일부를 자동으로 설치하지만, 나머지는 별도의 설치가 필요합니다. 따라서 Omnigent는 Node.js 소프트웨어를 실행하는 역할을 포함하는 Python 소프트웨어입니다.

모델 공급자와 비용 부담 주체

이 항목은 실무적으로 가장 큰 영향을 미치는 요소이며, 세 가지 도구의 답변은 확연히 다릅니다.

DeepSeek Harness는 사용자가 직접 모델을 가져오는 방식(bring-your-own)입니다. 기본 제공되는 공급자 카탈로그에는 Anthropic, OpenAI, Kimi(moonshotai), GLM(zai)과 같은 공급자가 포함되어 있으며, DeepSeek 자체 API를 위한 카드도 있습니다. 또한 openai-codex와 같이 네이티브 키 인증을 사용하지 않는 공급자도 나열되어 있는데, 프로필에서 자격 증명 참조를 명시적으로 지정하지 않으면 키 입력 필드가 나타나지 않습니다(2026년 10월 20일 확인). 사용자 정의 공급자 항목에는 소문자 공급자 ID, 표시 이름, 기본 URL, API 프로토콜, 자격 증명, 그리고 최소 하나의 모델을 입력해야 하며, 이를 통해 기업 게이트웨이나 자체 호스팅 서버를 지정할 수 있습니다. 키는 $DSH_HOME/.credentials.yaml에 기록되며, 프로필의 cordis.patch.yml(dsh web, $DSH_HOME/profiles/web/cordis.patch.yml용)에 있는 공급자 설정에는 키에 대한 참조만 저장됩니다. 따라서 설정 파일은 공유해도 안전하지만 자격 증명 파일은 공유해서는 안 됩니다. 게이트웨이 항목에는 apiKeyEnv: GATEWAY_API_KEY과 같은 줄을 사용하여 환경 변수를 지정할 수도 있습니다. 프로젝트 이름과 달리, 이 도구는 사용자가 DeepSeek의 모델을 강제로 사용하도록 하지 않습니다. 실제 키를 입력하거나 로컬 Ollama 엔드포인트를 지정하는 방법이 궁금하다면, dsh 키, 모델 및 엔드포인트 연결하기에서 각 모드별 설정 방법과 데이터 외부 유출 여부를 확인할 수 있습니다.

Claude Code는 특정 공급자의 모델을 중심으로 구축되었습니다. 유료 계정으로 로그인하거나 ANTHROPIC_API_KEY을 설정하면, 브라우저를 여는 대신 키를 승인하라는 메시지가 한 번 표시됩니다. 이 두 번째 방식은 헤드리스 서버에서 작동하는 방식입니다. 이미 다른 곳에서 용량을 구매한 조직은 Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry를 통해 라우팅할 수 있습니다. Ollama의 Anthropic 호환 API는 Claude 자체를 포기하는 대신 로컬 모델을 지정할 수 있는 문서화된 방법입니다.

Omnigent는 omnigent setup를 통해 수집된, 하위 하네스에서 필요한 모든 것을 요구합니다. API 키, 기존 CLI 구독, OpenAI 또는 Anthropic 호환 게이트웨이, Databricks 워크스페이스를 모두 지원합니다. 이것이 메타 하네스의 실제 비용입니다. 즉, 한 대의 머신에 모든 공급자의 자격 증명이 저장됩니다. 해당 머신을 공용 인터넷에 연결하기 전에 AI 에이전트가 비밀 정보에 접근하지 못하게 하는 방법을 반드시 읽어보시기 바랍니다.

2026년 8월 기준 각 도구의 성숙도는 어느 정도입니까?

Claude Code는 2025년부터 일반 공개되었으며, 최신 변경 로그 항목이 2.1.312였던 2026년 10월 29일 기준으로 여전히 2.1.x 버전을 유지하고 있습니다. 이 도구는 백그라운드에서 자동 업데이트되며, latest 및 stable 릴리스 채널을 제공하고, GPG로 서명된 릴리스 매니페스트를 게시하며, 최소 버전을 유지해야 하는 조직을 위해 minimumVersion 고정 기능을 문서화하고 있습니다. 이는 이미 운영 환경에서 사용 중인 제품의 전형적인 모습입니다.

Omnigent는 2026년 6월부터 공개되었으며 여전히 0.x 시리즈에 머물러 있습니다. 2026년 10월 29일 기준 PyPI의 최신 릴리스는 10월 28일에 업로드된 0.20.0입니다. PyPI는 0.1.0부터의 번호가 매겨진 버전을 프리릴리스가 아닌 일반 릴리스로 나열하며, 릴리스 후보(release candidate)는 별도로 게시합니다. 그럼에도 불구하고 README는 이 프로젝트를 알파 버전으로 명시하고 있습니다. 하네스 목록과 YAML 스키마 모두 계속 변경될 것으로 예상해야 합니다. 사용은 가능하지만 아직 안정화된 상태는 아닙니다.

DeepSeek Harness는 이 비교군 중 가장 최근에 등장했습니다. 이 비교 문서의 초안이 작성되기 며칠 전인 2026년 8월에 처음 공개되었습니다. 자체 README에서 호환성을 깨뜨리는 변경 사항이 발생할 것임을 예고하고 있으며, 2026년 10월 27일 기준으로 npm에 게시된 모든 빌드는 여전히 프리릴리스 상태입니다. 매우 높은 스타 수는 많은 사람이 이 프로젝트를 주시하고 있음을 보여줍니다. 하지만 이는 플러그인 API가 확정되었는지 여부에 대해서는 아무것도 알려주지 않습니다.

각 도구는 어떤 라이선스를 따릅니까?

DeepSeek Harness는 MIT 라이선스를 따르며, 제3자 라이선스 정보는 THIRD_PARTY_NOTICES.md에서 확인할 수 있습니다. Omnigent는 Apache 2.0 라이선스를 따릅니다. Claude Code는 오픈 소스가 아니며 Anthropic의 상용 제품입니다. 이를 Anthropic 모델과 함께 사용하려면 유료 플랜, 과금되는 API 액세스 또는 지원되는 클라우드 제공업체가 필요합니다. 모든 코드 라인을 직접 읽고 수정할 수 있어야 한다는 것이 요구 사항이라면 Claude Code는 기능 비교를 시작하기도 전에 제외됩니다. 반면, 별도의 관리 없이도 다음 달에 도구가 계속 작동해야 한다는 것이 요구 사항이라면 Claude Code가 더 적합한 선택지가 됩니다.

각 도구를 VPS에서 실행하려면 무엇이 필요한가?

Claude Code는 세 가지 도구 중 가장 간단합니다. 설치 후 로그인하고, SSH(secure shell) 연결이 끊겨도 세션이 유지되도록 tmux 내부에서 실행하십시오. Anthropic은 4 GB 이상의 RAM(random access memory)과 x64 또는 ARM64 프로세서, 그리고 Ubuntu 20.04 이상, Debian 10 이상 또는 Alpine 3.19 이상의 환경을 권장합니다. Alpine을 사용하는 경우 bash과 curl를 먼저 설치해야 합니다. 그렇지 않으면 설치 명령이 not found 오류로 실패합니다. tmux 내부에서 Claude Code를 VPS에 실행하기에서 세션 관리 방법을 자세히 다룹니다.

DeepSeek Harness는 Node.js와 웹 UI에 접속할 브라우저가 필요합니다. README는 Node.js를 요구하지만 최소 버전은 명시하지 않습니다. 2026년 10월 27일 기준으로 저장소 루트의 package.json은 >=24.9.0를 선언했습니다. 이는 이전 태그된 릴리스의 ^22.19.0 || >=24.0.0 범위에서 상향된 것이므로, Node 22로는 부족하며 Node 24.9 이상을 사용하는 것이 안전합니다. 포트 3080을 외부로 공개하지 마십시오. 서버를 127.0.0.1에 두고 노트북에서 포트를 포워딩하십시오:

ssh -N -L 3080:127.0.0.1:3080 you@your-vps

그다음 로컬 브라우저에서 토큰이 포함된 URL dsh를 엽니다. SSH 환경에서는 브라우저를 자동으로 열지 않습니다. VPS에 DeepSeek Harness 전체 설치하기에서 프로필 레이아웃과 플러그인 명령을 다룹니다.

Omnigent는 다른 도구의 CLI를 설치하고 관리하므로 가장 무겁습니다. 동일한 서버에 Python 3.12, uv, git, Node.js 22, npm, pnpm, tmux, bubblewrap이 필요하며, 일부 벤더 CLI는 별도의 설치가 필요합니다. 기본 Kiro를 사용하려면 먼저 kiro-cli을 설치하고 로그인하십시오. OMNIGENT_KIRO_PATH을 통해 경로를 지정하지 않으면, PATH에 CLI가 없을 때 런처가 실패합니다. README에 따르면 로컬 UI는 기기의 LAN 주소를 통해 휴대폰에서 열 수 있으므로, VPS에서는 포트 6767이 비공개라고 가정하지 마십시오. 방화벽에서 해당 포트를 차단하고 다음과 같이 포워딩하십시오:

ssh -N -L 6767:127.0.0.1:6767 you@your-vps

다른 사용자와 함께 사용하는 서버의 경우, 지원되는 경로는 deploy/를 통한 Docker 배포이며, 이는 기본적으로 다중 사용자 계정을 활성화합니다. 수동으로 시작하는 서버에서도 OMNIGENT_AUTH_ENABLED=1을 설정하면 동일한 기능을 사용할 수 있으며, Google, GitHub, Okta, Microsoft를 통한 OIDC(OpenID Connect) 로그인이 작동합니다. Omnigent 다중 에이전트 하니스 가이드에서는 에이전트가 디스크에 쓰기 작업을 시작할 때 중요해지는 샌드박스 제공자를 다룹니다.

서버의 공인 IP 주소에서 웹 UI가 빈 화면으로 나타나는 이유는 무엇입니까?

웹 하네스를 공인 주소에 바인딩하고 포트를 개방하는 것이 당연한 조치처럼 보일 수 있습니다. 하지만 두 방식은 여기서 다르게 동작합니다. DeepSeek Harness는 이제 가장 위험한 방식을 차단합니다. --host 플래그는 하나의 구체적인 로컬 주소만 허용하며, 0.0.0.0과 같은 와일드카드는 시작 시 거부됩니다. 출력되는 URL에는 프로세스 토큰이 포함되어 있으며, 이 토큰과 서명된 세션 쿠키가 모든 API 호출을 인증합니다. 이는 일반 HTTP를 사용할 경우 토큰이 암호화되지 않은 채 네트워크를 통과함을 의미합니다. Omnigent의 기본 로컬 서버는 다중 사용자 계정 기능을 끄고 실행되므로, Omnigent 포트를 개방하는 것은 VPS에 셸을 그대로 노출하는 것과 같습니다.

두 번째로 문제가 되는 것은 사용자들에게 생소한 브라우저 규칙입니다. crypto.randomUUID()은 보안 컨텍스트, 즉 HTTPS(hypertext transfer protocol secure), localhost 또는 127.0.0.1에서만 정의됩니다. 2026년 8월 이 비교 문서를 처음 작성할 당시, http://203.0.113.10:3080과 같은 일반 주소로 DeepSeek Harness UI를 로드하면 브라우저 콘솔에 다음과 같은 메시지가 출력되었습니다.

TypeError: crypto.randomUUID is not a function

세션 생성 단계에서 실패하여 화면이 그려지기 전에 중단되었으므로, 페이지는 일부만 렌더링되거나 아예 나타나지 않았습니다. 서버에는 아무런 문제가 없었으며 로그에도 정상적인 요청으로 기록되었습니다. 브라우저가 해당 출처(origin)를 신뢰하지 않았기 때문에 프론트엔드가 의존하는 함수가 정의되지 않은 것입니다. SSH 터널을 사용하면 인증서 없이도 이 문제를 피할 수 있는데, 이는 127.0.0.1가 보안 컨텍스트로 간주되기 때문입니다. 실제 TLS(transport layer security) 인증서를 보유한 리버스 프록시를 사용해도 동일한 효과를 얻을 수 있으며, dsh 실행 토큰이 네트워크상에 노출되는 것을 방지합니다. 또한 Omnigent 앞단에 프록시를 둘 경우 직접 인증 기능을 활성화해야 합니다.

어떤 도구가 적합합니까?

지금 바로 사용할 수 있는 코딩 에이전트가 필요하고, Anthropic에 비용을 지불할 의향이 있으며, 터미널 환경에서 주로 작업한다면 Claude Code를 선택하십시오. 이는 프리뷰 버전이 아닌 완성된 상용 제품인 유일한 도구입니다.

플러그인 모델이 중요하다면 DeepSeek Harness를 선택하십시오. 모델 어댑터, 샌드박스, 에이전트 루프를 직접 교체하고 싶고, 인터페이스가 변경될 수 있음을 감수한다면 적합합니다. 제공자 카탈로그에 Anthropic과 OpenAI가 포함되어 있으므로, 이 도구를 선택하는 것은 DeepSeek 모델이 아닌 런타임에 투자하는 것입니다.

이미 여러 개의 에이전트 CLI를 사용 중이고 실제 문제가 정책, 샌드박싱, 타사 모델을 통한 검토, 타인이 관찰 가능한 공유 세션과 같은 조정(coordination)에 있다면 Omnigent를 선택하십시오. 이 도구는 스택에 계층을 추가하며, 불필요한 계층은 장애의 원인이 될 수 있습니다. 조정 문제가 그보다 작다면, 동일한 서버에서 두 개의 Claude Code 세션을 실행하여 오케스트레이터 없이도 서로 메시지를 주고받게 할 수 있습니다.

여전히 후보를 검토 중이라면, Mimo Code AI 코딩 에이전트는 Claude Code와 동일한 터미널 에이전트 범주에 속합니다. 또한 어떤 도구를 선택하든 일회용 VM에서 코딩 에이전트 실행하기 문서를 읽어보는 것이 좋습니다. 이 세 가지 도구 중 어느 것도 부주의한 rm -rf를 스스로 안전하게 만들어주지는 않기 때문입니다. 또한 이 세 도구 모두 에이전트가 제안하는 diff의 크기를 결정하지 않으며, 이는 프롬프트 수준에서 해결해야 할 문제입니다. 따라서 어떤 도구를 선택하든 작동하는 가장 작은 변경 사항을 제안하도록 에이전트를 유도하는 기술을 추가로 적용하는 것이 좋습니다.

FAQ

Claude Code를 사용하려면 유료 Anthropic 플랜이 필요한가요?

Anthropic 모델을 사용하려면 유료 플랜이 필요하며, 지원되는 클라우드 제공업체를 이용할 수도 있습니다. Anthropic의 설정 문서에 따르면 Claude Code는 Pro, Max, Ultra, Team, Enterprise 또는 Console 계정을 요구하며, 무료 Claude.ai 플랜은 접근 권한을 포함하지 않습니다. 다른 곳에 사용량이 확보된 조직은 Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry를 대신 지정할 수 있습니다. 헤드리스 VPS 환경에서는 첫 실행 전에 ANTHROPIC_API_KEY을 설정하십시오. 그러면 Claude Code가 브라우저를 열려고 시도하는 대신 해당 키를 승인하라는 메시지를 한 번 표시합니다. Ollama는 별도의 경로인 ollama launch claude를 문서화하고 있습니다. 이 경로는 Anthropic 자격 증명 없이 Ollama의 Anthropic 호환 API를 통해 로컬 모델에서 Claude Code를 실행하지만, 이 경우 작업을 수행하는 모델은 Claude가 아닙니다.

DeepSeek Harness에서 Claude나 OpenAI 모델을 실행할 수 있나요?

네, 가능합니다. 설치된 제공업체 카탈로그에는 Anthropic과 OpenAI 등이 포함되어 있으며, Settings의 Models 항목에서 제공업체별로 키를 추가할 수 있습니다. 카탈로그에 없는 항목은 사용자 지정 제공업체로 등록해야 하며, 이를 위해서는 소문자로 된 제공업체 ID, 베이스 URL, API 프로토콜, 자격 증명, 최소 하나의 모델이 필요합니다. 카탈로그에는 openai-codex과 같이 기본 키 인증을 사용하지 않는 제공업체도 나열되어 있습니다. 이러한 제공업체는 프로필에 자격 증명 참조가 명시적으로 지정되지 않는 한 키 필드를 표시하지 않습니다(2026년 10월 20일 확인). 키는 $DSH_HOME/.credentials.yaml에 저장되고 프로필의 cordis.patch.yml에는 참조만 보관되므로, 자격 증명 파일은 별도로 백업하고 버전 관리 시스템에 포함하지 마십시오.

Omnigent이 Claude Code를 대체하나요?

아니요. Omnigent은 Claude Code를 실행하는 도구입니다. 하네스 목록에는 Claude, Codex, Cursor, OpenCode, Hermes, Pi가 포함되어 있으며, 에이전트는 YAML 파일의 단일 harness: 라인을 통해 하나를 선택합니다. 사용자는 여전히 기본 CLI를 인증해야 하며, 일부 벤더 CLI는 별도로 설치해야 할 수도 있습니다. Omnigent은 그 위에 오케스트레이션, 정책, 샌드박싱 기능을 추가하므로, 둘 이상의 에이전트나 둘 이상의 벤더를 실행할 때 의존성을 확보하게 됩니다.

서버의 공인 IP 주소에서 DeepSeek Harness 웹 UI가 빈 화면으로 나오는 이유는 무엇인가요?

2026년 8월 기준, 일반 HTTP 오리진은 보안 컨텍스트가 아니기 때문에 해당 환경에서 crypto.randomUUID()이 정의되지 않아 브라우저 콘솔에 TypeError: crypto.randomUUID is not a function 오류가 보고되었습니다. 세션 생성에 실패하여 페이지가 부분적으로만 렌더링되거나 아예 표시되지 않았으며, 서버 로그는 정상으로 보였습니다. 현재 빌드에서는 와일드카드 --host를 거부하고 출력된 URL에 프로세스 토큰을 포함하므로, 주소만으로는 로그인할 수 없습니다. ssh -N -L 3080:127.0.0.1:3080 you@your-vps을 사용하여 SSH로 포트를 포워딩하고 http://127.0.0.1:3080에서 출력된 URL을 여십시오. 루프백(loopback)은 보안 컨텍스트로 간주되기 때문입니다. 실제 TLS 인증서를 사용하는 리버스 프록시를 설정해도 작동하며, 이 방식은 시작 토큰이 평문으로 네트워크를 통과하는 것을 방지합니다.

이러한 하네스를 실행하려면 VPS에 RAM이 얼마나 필요한가요?

Anthropic은 Claude Code를 위해 4 GB 이상의 RAM을 권장합니다. DeepSeek Harness와 Omnigent의 경우 추측하기보다 직접 측정하는 것이 좋습니다. 원격 모델을 사용할 때 하네스 자체는 추론보다는 프로세스 감독과 파일 작업을 수행합니다. 로컬 모델을 호스팅하는 경우에는 해당 모델의 메모리 요구 사항이 추가됩니다. 서버 사양을 결정짓는 핵심 요소는 빌드나 테스트 스위트 실행과 같이 에이전트가 수행하는 작업의 규모입니다. Omnigent은 Python, Node.js, tmux 및 활성화된 모든 벤더 CLI가 동일한 머신에서 실행되므로 가장 많은 자원을 요구합니다.

이 글이 도움이 되었나요?