DeepSeek Harness, Codex, Claude Code 이해하기: 5가지 차원에서 Agent 제어권 비교

한 문장 요약: DeepSeek Harness는 개조 가능한 실행 시스템을 제공하고, Codex는 오픈소스 코어와 공식 제품을 함께 내놓으며, Claude Code는 상용 도구와 확장 인터페이스를 통해 역량을 전달해요. 진짜 차이는 ‘어느 계층을 내가 고칠 수 있는가’, 그리고 고친 뒤에 ‘누가 유지보수하는가’예요.

“DeepSeek Harness는 오픈소스, Codex와 Claude Code는 모두 클로즈드소스 완제품”이라는 구분은 정확하지 않아요. 제시된 공식 자료에 따르면, 자료 검증일은 2026년 11월 12일이고, Codex CLI는 Apache-2.0 라이선스를 채택하고 있으며, OpenAI 역시 Codex Harness를 공개했어요. 다만 모델 접근과 호스팅 클라우드 서비스는 서로 다른 계층이에요.

이 글은 실측 근거 없는 효율 순위를 매기지 않고, 세 가지 선택지를 하나의 작업 안에 나란히 놓아 볼게요: 매일 AI 뉴스를 수집하고, 주제와 자료 패키지를 만들고, 초안을 회사 백엔드에 저장하는 것. 이 작업을 따라가며 소스 코드, 도구, 실행 환경, 유지보수 책임의 차이를 계층별로 풀어볼게요.

deepseek-harness-codex-claude-code-control-comparison-ko-image-0

DeepSeek Harness, Codex, Claude Code를 이해하려면 먼저 용어를 과제 속으로 되돌려 놓으세요

에이전트는 단순히 질문에 답하는 모델이 아니에요. 뉴스를 검색하고, 브라우저를 호출하고, 초안을 저장하게 하려면 모델, 도구, 상태, 실행 과정을 조직하는 시스템이 필요한데, 이것이 바로 Agent Harness입니다.

모델은 다음 행동을 제안하는 ‘두뇌’로 이해할 수 있고, Harness는 행동을 도구에 적용하고 그 결과를 다시 모델로 되돌려 보내는 역할을 합니다. 둘 사이에는 권한과 실행 환경이 존재하기 때문에, ‘모델 API 연결’을 ‘완전한 에이전트가 이미 사용 가능하다’고 여기면 안 됩니다.

용어 뉴스 주제 선정 과제에서의 의미 혼동하기 쉬운 경계
Agent Loop 검색하고, 결과를 읽고, 계속 검증한 뒤 초안을 생성하는 순환 단일 모델 요청이 아님
모델 어댑터 요청을 모델 서비스에 필요한 형식으로 변환 주소를 설정할 수 있는 것이 프로토콜 완전 호환을 의미하지 않음
MCP 검색, 데이터베이스 또는 회사 백엔드 도구에 접속하는 프로토콜 도구 연결이 자동으로 비즈니스 권한을 얻는 것을 의미하지 않음
샌드박스 명령, 파일 및 네트워크 접근을 제한하는 실행 환경 격리 효과는 설정에 따라 다름
오픈소스 라이선스 공개 코드의 사용, 수정, 배포 조건 규정 모델 서비스 및 클라우드 리소스의 무료 사용 권한을 포함하지 않음

MIT와 Apache-2.0은 모두 사용, 수정, 배포를 허용하는 관대한 오픈소스 라이선스이지만, 각자의 조건을 여전히 준수해야 합니다. 개발자 프리뷰는 제품이 아직 초기 단계에 있어 인터페이스, 플러그인, 호환성이 변경될 수 있음을 의미하며, 바로 프로덕션 배포에 적합하다고 이해할 수는 없습니다.

DeepSeek Harness, Codex, Claude Code의 소스 코드는 어디까지 공개됐을까요?

먼저 핵심 오해부터 바로잡아 볼게요. Codex를 두루뭉술하게 폐쇄형 제품이라고 설명할 수는 없어요. Codex CLI의 공개 소스 코드는 Apache-2.0 라이선스를 따르고, OpenAI가 공개한 Harness도 기반 Agent 시스템을 연구하고 통합하기 위한 진입점을 제공해요. 이는 공식 호스팅 서비스를 구매하는 것과는 별개예요.

비교 대상 공개 범위 어떻게 사용할 수 있는가 이로부터 끌어내면 안 되는 결론
DeepSeek Harness MIT 라이선스로 공개된 오픈소스 프로젝트 실행 시스템을 확인·수정·확장할 수 있음 보안 감사를 마쳤으니 유지보수가 필요 없다는 결론
Codex CLI/Harness CLI는 Apache-2.0, Harness는 공개됨 공개 코드를 수정하고 Agent 기능을 통합할 수 있음 클라우드 서비스·모델·인프라까지 전부 오픈소스라는 결론
Claude Code 상용 비오픈소스 제품, 확장 인터페이스 제공 도구, Hooks, 서브 Agent를 통해 커스터마이즈할 수 있음 비공개 내부 엔진을 자유롭게 수정할 수 있다는 결론

DeepSeek Harness는 개발자가 직접 손볼 수 있는 Agent 실행 시스템에 더 가까워요. 공식에서 Web, Headless, SDK, 간소화 SDK, ACP 등 실행 구성을 제공해서, 고정된 인터페이스만 써야 하는 대신 애플리케이션 요구에 맞춰 상호작용 방식을 고를 수 있어요.

Codex는 오픈소스 코어와 완제품 도구, 두 갈래에 걸쳐 있어요. 개발자는 SDK, App Server 또는 codex exec를 통해 작업, 세션, 이벤트, 승인 흐름을 통합할 수 있고, 일반 사용자도 공식 CLI, App, IDE, Cloud 제품을 쓸 수 있어요.

Claude Code는 바로 쓸 수 있는 개발 도구와 공식 확장 메커니즘에 초점을 맞춰요. 아예 커스터마이즈가 불가능한 건 아니고, 보통 도구·이벤트·작업 분담 계층에서 커스터마이즈가 이뤄져요. 그렇다고 해서 기반 실행 엔진까지 공개됐다고 볼 수는 없어요.

DeepSeek Harness, Codex, Claude Code의 5가지 제어권 차원

제어권을 판단할 때는 “플러그인이 있느냐”만 묻지 마세요. 더 가치 있는 질문은 이거예요. 뉴스 파이프라인에서 문제가 생겼을 때, 모델 연동, 도구 동작, 루프 로직, 세션 복구, 실제 실행 환경을 내가 바꿀 수 있는가?

deepseek-harness-codex-claude-code-control-comparison-ko-image-1

제어 차원 DeepSeek Harness Codex Claude Code
모델 연동 교체 가능한 모델 어댑터, 프로토콜 검증 필요 공개 코드를 살펴볼 수 있지만, 공식 제품은 여전히 모델 연동 규칙의 제약을 받아요 공식적으로 안내된 서비스 연동 방식만 지원하며, 임의의 모델로 교체할 수 있다는 뜻은 아니에요
도구 확장 도구 레지스트리와 실행 컴포넌트를 수정할 수 있어요 MCP, Hooks, Skills, Plugins 등을 지원해요 MCP, Hooks, Skills, Plugins 등을 지원해요
Agent Loop 핵심 루프를 플러그인이나 소스 코드로 개조할 수 있어요 공개된 Harness는 수정할 수 있지만, 호스팅 서비스에는 별도의 경계가 있어요 확장을 통해 흐름에 영향을 줄 수 있지만, 공개되지 않은 엔진을 자유롭게 수정할 수는 없어요
세션과 상태 기록, 저장, 복구 방식을 교체할 수 있어요 App Server 등이 세션과 이벤트 통합을 제공해요 공식 인터페이스와 하위 에이전트로 워크플로를 관리할 수 있어요
실행 환경 파일, Shell, 샌드박스, 백그라운드 작업을 직접 설정해요 로컬에서 실행할 수도 있고, 공식 클라우드 환경을 사용할 수도 있어요 제품 진입점, 실행 방식, 권한 부여에 따라 달라져요

DeepSeek Harness: “워크플로가 어떻게 돌아가는지”를 바꿀 수 있어요

DeepSeek Harness의 아키텍처는 “Everything is a Plugin”을 강조해요. 모델 어댑터, 도구 레지스트리, 세션 기록, Agent Loop, 파일 시스템, 명령 실행, 샌드박스, 승인 정책 모두 플러그인과 설정으로 교체할 수 있어요.

예를 들어 팀에서 “모든 주제 선정에는 여러 개의 독립적인 출처가 있어야 하고, 그렇지 않으면 저장할 수 없다”고 요구한다면, 개발자는 검증 도구와 실행 정책을 시스템 흐름에 포함시킬 수 있어요. 다만 소스 코드를 수정할 수 있다는 건 어디까지나 구현 조건일 뿐이에요. 그 규칙이 믿을 만한지 검증하려면 테스트와 검토가 필요하고, 프롬프트만으로 보장할 수는 없어요.

Codex: 공개 코드와 공식 서비스는 서로 다른 제어 범위예요

Codex의 강점은 공개된 실행 코드를 쓸 수도 있고, 공식 제품으로 경험해 볼 수도 있다는 점이에요. 회사 소프트웨어에 기능을 넣으려면 SDK, App Server, 스크립트 실행 진입점 등이 각기 다른 통합 방식을 제공해요. 반대로 Codex Cloud를 쓴다면 원격 컴퓨팅 환경은 OpenAI가 관리해요.

즉, 로컬의 공개 코드를 수정하는 것과 공식 클라우드 서비스를 수정하는 것은 같은 일이 아니에요. 공식 클라우드 작업이 내 PC가 절전 상태일 때도 계속 돌아간다고 해서, 꺼진 컴퓨터 안의 파일이나 기존 브라우저 로그인 상태에 곧바로 접근할 수 있다는 뜻은 아니에요.

Claude Code: 워크플로 확장은 엔진 재작성과 달라요

Claude Code의 MCP는 데이터베이스와 업무 서비스를 연결할 수 있고, Hooks는 도구 호출 전후나 권한 요청 시점, 작업 종료 시점에 검사를 실행할 수 있어요. Subagents는 독립적인 컨텍스트, 프롬프트, 도구 권한, 모델 선택을 가질 수 있어서 자료 수집과 출처 검사를 분리하기에 적합해요.

뉴스 작업이라면 “저장 전 검증” Hook을 설계하고, 백그라운드 도구로 초안을 만들 수 있어요. 이건 확장 인터페이스를 통해 실행에 영향을 주는 것이지, 내부 Agent Loop를 수정하는 게 아니에요. 독립적인 모델 선택이 가능하다고 해서 모든 제품 화면에서 임의의 모델 서비스를 쓸 수 있다는 뜻도 아니에요.

그림에서 꼭 구분해야 하는 건 모델 연결과 실행 시스템이에요. APIYI apiyi.com은 모델 API 연동의 후보 플랫폼이 될 수 있지만, 세 도구 각자의 실행 환경, 권한 설정, 제품 규칙을 대신하지는 못해요.

DeepSeek Harness를 직접 구축하면, 과연 어떤 유지보수 책임을 져야 할까요?

오픈소스라고 해서 비용이 전혀 들지 않는 건 아니에요. 모델 호출 외에도 뉴스 파이프라인에는 검색 서비스, 브라우저, 스토리지, 로그인 자격 증명, 상시 실행 환경, 그리고 실패 후의 재시도와 진단 메커니즘이 필요해요.

책임 항목 DeepSeek Harness 직접 구축 Codex 경로 Claude Code 경로
모델 및 도구 비용 직접 구성하고 산정 API, 제품, 클라우드 작업 방식에 따라 달라짐 API, 제품, 확장 도구 방식에 따라 달라짐
상시 실행 환경 직접 배포, 모니터링, 복구 로컬은 직접 유지보수, 공식 Cloud가 원격 환경 관리 구체적인 실행 진입점과 원격 조건 확인 필요
브라우저와 로그인 제공자 설치, 세션과 자격 증명 관리 실제 환경에 맞춰 구성하고 검증 브라우저 접속 방식에 맞춰 구성하고 검증
보안과 업그레이드 컴포넌트, 격리, 승인, 호환성 책임 공개 코드를 수정한 후 자체 버전을 유지보수해야 함 확장, 권한 부여, 업그레이드 호환성 유지보수
모델 API 후보 진입점 APIYI apiyi.com, 어댑터를 먼저 검증 공식 제품 구독 권한을 얻는 것과 같지 않음 임의의 진입점이 모두 호환된다는 의미는 아님

DeepSeek Harness의 브라우저 조작이 전부 바로 사용 가능한 건 아니에요. 공식 문서에서는 dsh-browser-use를 설치하고, Playwright MCP, Chrome DevTools MCP, Stagehand 같은 실험적 제공자를 명시적으로 활성화하도록 요구해요.

브라우저 로그인 상태는 세션 로그에서 자동으로 복구되지 않으며, 세션을 다시 로드하거나 분기하면 새로운 브라우저 상태가 만들어져요. 이미 실행된 작업도 작업 취소로 되돌릴 수 없어요. 따라서 프로덕션 백엔드에서는 ‘초안 생성’, ‘초안 저장’, ‘콘텐츠 게시’를 구분해야 하며, 취소 버튼을 비즈니스 롤백 메커니즘으로 삼아서는 안 돼요.

보안 제한은 특히 중요해요. 공식에서는 DeepSeek Harness를 개발자 프리뷰로 표시하고, 아직 보안 감사를 완료하지 않았으며 프로덕션 수준의 보안성을 갖춘 것으로 간주해서는 안 된다고 명확히 밝히고 있어요. 최소 권한과 일회용 가상 머신, 컨테이너 또는 전용 환경을 사용할 것을 권장하며, 내장 샌드박스를 신뢰할 수 없는 작업을 실행하는 유일한 방어선으로 삼아서는 안 돼요.

DeepSeek Harness, Codex, Claude Code에서 모델 연결을 먼저 검증하는 방법은?

모델 API를 먼저 검증하고, 그다음 Agent 도구 호출을 검증하고, 마지막으로 백엔드 저장을 검증하는 순서가 문제를 찾기 더 쉽습니다. 아래 두 예시는 모델 연결 테스트일 뿐이며, 세 Agent의 완전한 설치 및 구성 방법이 아니고, 어떤 클라이언트든 바로 호환된다는 것을 증명하지도 않습니다.

DeepSeek Harness, Codex, Claude Code의 최소 모델 연결 테스트

환경 변수의 모델 식별자에는 플랫폼에서 현재 사용 가능한 이름을 사용해야 하며, 키는 코드나 로그에 작성하지 마세요. 예시는 실행 환경에 OpenAI Python SDK가 이미 설치되어 있다고 가정합니다.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AI_API_KEY"],
    base_url="https://api.apiyi.com/v1",
)
response = client.chat.completions.create(
    model=os.environ["AI_MODEL"],
    messages=[{"role": "user", "content": "뉴스 출처 검증 단계를 나열해 주세요."}],
)
print(response.choices[0].message.content)

DeepSeek Harness, Codex, Claude Code의 도구 호출 프로토콜 검사

순수 텍스트가 성공했다면, 모델이 올바른 도구 호출을 반환하는지 확인한 뒤 도구 실행, 결과 반환, 2차 응답 테스트를 계속 진행해야 합니다. 아래 코드는 1차 반환 구조만 검사하며, 실제로 회사 백엔드를 조작하지는 않습니다.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AI_API_KEY"],
    base_url="https://api.apiyi.com/v1",
)
response = client.chat.completions.create(
    model=os.environ["AI_MODEL"],
    messages=[{
        "role": "user",
        "content": "check_source를 호출해 입력된 뉴스 출처를 검사해 주세요.",
    }],
    tools=[{
        "type": "function",
        "function": {
            "name": "check_source",
            "description": "Check a news source without changing data.",
            "parameters": {
                "type": "object",
                "properties": {"source": {"type": "string"}},
                "required": ["source"],
            },
        },
    }],
)
message = response.choices[0].message
print("tool_calls:", message.tool_calls)
print("content:", message.content)

도구 호출이 반환되더라도 매개변수 파싱, 오류 처리, 스트리밍 이벤트, 컨텍스트 복구까지 확인해야 합니다. DeepSeek 어댑터가 커스텀 Base URL을 지원한다고 해서 어떤 서비스든 해당 어댑터의 기대를 충족한다는 뜻은 아닙니다. Codex와 Claude Code도 각자의 프로토콜과 구성 요구 사항에 따라 검증해야 합니다.

빠른 검증 팁: 플랫폼의 공개 설명에 따르면 APIYI apiyi.com은 하나의 API 키로 OpenAI, Claude, Gemini 등 주요 모델의 OpenAI 호환 인터페이스에 접속할 수 있도록 제공하며, 사용량 기반 과금을 적용하고 할인 가격과 신규 사용자 무료 테스트 크레딧도 안내하고 있습니다. 구체적인 모델, 이벤트, 호환성은 현재 설명과 실제 요청을 기준으로 해야 하며, 모델 API 권한에는 Codex Cloud나 Claude Code 제품 구독이 포함되지 않습니다.

DeepSeek Harness, Codex, Claude Code는 각각 어떤 상황에 적합할까요?

“언제 계속 검색할지, 언제 저장을 거부할지, 중단된 세션을 어떻게 복구할지”를 수정해야 한다면 DeepSeek Harness를 먼저 살펴보세요. 실행 메커니즘을 깊이 제어할 수 있지만, 팀 차원에서 배포와 보안, 버전 유지보수를 감당할 역량이 있어야 해요.

오픈소스 코드를 활용하면서 공식 완제품과 클라우드 작업 옵션도 함께 유지하고 싶다면 Codex를 먼저 살펴보세요. 로컬 CLI, SDK 통합, Cloud 중 무엇을 쓸지 먼저 정해야 어떤 구성 요소를 직접 유지보수해야 하는지 정확히 판단할 수 있어요.

프로그래밍 에이전트를 최대한 빠르게 사용하고 MCP, Hooks, Subagents로 회사 프로세스에 연결하는 것이 목표라면 Claude Code를 먼저 살펴보세요. 단, 기본 루프를 반드시 새로 작성해야 하는 게 아니라 공식 확장 인터페이스만으로 요구 사항을 커버할 수 있어야 한다는 전제가 있어요.

deepseek-harness-codex-claude-code-control-comparison-ko-image-2

실제로 시험해 볼 때는 기능 개수를 비교하기보다 동일한 검증 조건 세트를 사용하는 편이 좋아요:

  1. 출처 확인: 출처를 확인할 수 없을 때 중단하고 그 이유를 설명할 수 있는가.
  2. 권한 제어: 테스트 데이터는 읽을 수 있지만 정식 콘텐츠는 게시할 수 없는가.
  3. 중단 복구: 재시작 후 이미 저장된 초안을 인식해 중복 제출을 피할 수 있는가.
  4. 장애 처리: 백그라운드 버튼이 바뀌거나 도구가 타임아웃될 때 추적 가능한 기록을 남기는가.

이 항목들은 권장 테스트 항목이며, 이 글에서 이미 완료한 실측 결과는 아니에요. 총비용 역시 모델 토큰이나 구독료만이 아니라 수동 점검, 업그레이드, 복구에 드는 시간까지 포함해 계산해야 해요.

DeepSeek Harness, Codex, Claude Code 자주 묻는 질문

Codex가 오픈소스가 되었으니 모든 클라우드 기능을 무료로 쓸 수 있나요?

그렇게 유추할 수는 없어요. Codex CLI/Harness의 소스 코드 라이선스와 모델 접근, 원격 컴퓨팅, 호스팅 서비스는 서로 다른 계층이고, APIYI(apiyi.com)가 제공하는 모델 API 연동도 Codex Cloud 권한과 같지 않아요.

DeepSeek Harness는 Base URL만 바꾸면 어떤 모델이든 연결할 수 있나요?

보장할 수 없어요. APIYI(apiyi.com)의 통합 인터페이스는 후보 모델 연결 테스트에 사용할 수 있지만, 어댑터 프로토콜, 도구 호출, 스트리밍 출력, 예외 처리를 검증해야 하고, 텍스트 응답이 성공했다는 것만으로 전체 에이전트 호환성을 유추할 수는 없어요.

Claude Code에 Hooks가 있다면 엔진도 오픈소스인가요?

아니요. Hooks는 공식적으로 공개된 실행 노드 인터페이스로, 흐름을 검사하거나 영향을 줄 수 있지만, 공개되지 않은 내부 루프를 열람하고 수정할 수 있다는 뜻은 아니에요.

DeepSeek Harness를 바로 프로덕션 환경에 넣을 수 있나요?

오픈소스라는 이유만으로 그렇게 판단해서는 안 돼요. 공식 문서에서 아직 보안 감사를 완료하지 않았다고 명시했으므로, 먼저 격리 환경, 최소 권한, 복구 가능한 테스트 절차를 적용해야 해요.

Codex Cloud는 로컬 컴퓨터를 끈 뒤에도 작업을 계속할 수 있나요?

공식 자료에 따르면 클라우드 작업은 계속 실행될 수 있어요. 하지만 클라우드에도 자체 코드, 의존성, 네트워크, 권한이 필요하며, 이미 종료된 로컬 컴퓨터를 직접 제어할 수는 없어요.

세 도구 중 뉴스 주제 선정 작업을 가장 빠르게 완료하는 것은 무엇인가요?

이 글에는 동일한 작업을 실제로 측정한 결과가 없어서 속도나 성공률 순위를 제시할 수 없어요. 동일한 입력, 권한, 검수 조건에서 완료 여부, 수동 개입, 실제 비용을 기록해야 해요.

DeepSeek Harness, Codex, Claude Code 핵심 포인트

  • 소스 코드 공개: Codex를 한데 묶어 폐쇄소스 제품이라고 할 수는 없어요.
  • 제어 깊이: 플러그인 인터페이스와 하위 실행 루프 수정은 서로 다른 문제예요.
  • 운영 책임: 자체 구축은 배포, 복구, 업그레이드까지 책임진다는 뜻이에요.
  • 모델 경계: API 연결이 곧 완전한 Agent 호환성을 의미하지는 않아요.
  • 보안 경계: DeepSeek Harness는 아직 감사되지 않은 개발자 프리뷰예요.
  • 선택 기준: 실제 검증 결과를 비교하고, 기능 개수로 효율성을 대신하지 마세요.

정리: DeepSeek Harness, Codex, Claude Code는 어떻게 선택해야 할까요?

하위 실행 메커니즘을 제어해야 한다면 DeepSeek Harness를, 공개 코드와 공식 제품이라는 두 가지 경로가 필요하다면 Codex를, 개발 도구를 바로 사용하면서 확장으로 맞춤 설정하고 싶다면 Claude Code를 살펴보세요. 이는 요구 사항에 따라 제시한 선택 조건이며, 종합적인 우열 순위가 아니에요.

먼저 APIYI apiyi.com을 통해 후보 모델의 연결과 도구 호출을 검증한 뒤, Agent의 권한, 브라우저, 복구 메커니즘을 별도로 테스트해 보세요. 오픈소스 수준, 사용 편의성, 최종 작업 효율성은 서로 대체할 수 없는 세 가지 차원이에요.

DeepSeek Harness, Codex, Claude Code 참고 자료

아래는 사용자가 제공한 자료에 기재된 공식 출처이며, 확인 날짜는 2026년 11월 12일이에요. 온라인 콘텐츠, 진입점, 계정 조건은 버전에 따라 달라질 수 있고, 이 글에서는 별도의 통합 작업 실측을 진행하지 않았어요.

  1. DeepSeek Harness 공식 저장소: github.com/deepseek-ai/deepseek-harness
    라이선스, 아키텍처, 브라우저 설정, 보안 관련 설명을 담고 있어요.

  2. Codex 공식 저장소: github.com/openai/codex
    CLI 공개 코드와 Apache-2.0 라이선스를 확인할 때 참고할 수 있어요.

  3. Codex 오픈소스 Harness 설명: developers.openai.com/blog/codex-as-a-platform
    개방형 실행 시스템, 통합 진입점, 호스팅 서비스를 구분해 줘요.

  4. Codex Cloud 설명: help.openai.com/en/articles/20001545-using-codex-cloud
    공식 원격 실행 환경과 작업 실행 경계를 소개해요.

  5. Claude Code 공식 문서: code.claude.com/docs/en/overview
    MCP, Hooks, Subagents, 서비스 접속 조건은 해당 문서를 기준으로 삼아야 해요.


작성자: APIYI 기술팀
기술 교류: APIYI apiyi.com을 통해 모델 적응, 도구 호출, Agent 연동 관련 문제를 함께 이야기해요. 문제를 진단할 때는 민감 정보를 제거한 설정과 오류 정보를 제공해 주시고, 실제 키나 백엔드 자격 증명은 제출하지 마세요.

댓글 남기기