작성자 주석: Codex, Claude Code, DeepSeek Harness 세 에이전트의 모델 연동, 도구 확장, 실행 조율 방식을 비교하고, 모델 교체와 API 연결, 자동화 구축에 각각 어떤 조건이 필요한지 설명해 명확한 선택을 돕습니다.
많은 개발자가 제품을 고를 때 Codex, Claude Code, DeepSeek Harness를 함께 비교하지만, 세 제품은 같은 종류가 아니에요. 이 글은 모델 전환 자유도, API 연결 방식, 업무 도구 확장, 실행 및 자동화 4가지 기준으로 비교하고, 명확한 시나리오별 추천을 제시합니다.
이 글은 “각자 나름의 장점이 있다”는 식의 절충 분석이 아니에요. 꾸며낸 실측 점수도 제시하지 않습니다. 글에 나오는 모든 기능 설명은 각 사의 공식 자료를 기준으로 했으며(검증 날짜 2026년 11월 12일), “공식 설명”, “합리적 추론”, “직접 검증 필요” 세 가지 정보를 분명히 구분합니다.
핵심 가치: 이 글을 읽고 나면 세 가지 질문에 답할 수 있어요. 바로 쓸 수 있는 완성도 높은 프로그래밍 에이전트를 원한다면 어느 제품을 골라야 할지, 모델을 바꾸고 싶다면 어느 쪽의 자유도가 더 높은지, 나만의 자동화 시스템을 구축하고 싶다면 어느 쪽이 더 적합한지입니다.

왜 Codex, Claude Code, DeepSeek Harness를 단순히 같은 종류의 제품으로 볼 수 없을까
이해를 돕기 위해 세 제품에 똑같은 작업을 하나 맡겨 볼게요. 매일 아침 9시에 최신 AI 뉴스를 자동으로 수집하고, 쓸 만한 주제를 골라 자료 패키지와 아티클 기획안을 만든 다음, 그 결과를 회사의 콘텐츠 관리 백오피스에 입력해 저장하고, 다음 날도 자동으로 실행하는 작업이에요. 이 작업에는 정보 수집, 콘텐츠 생성, 백오피스 입력, 정기 실행, 모델 추론이라는 다섯 가지 단계가 들어 있는데, 마침 뒤에서 비교할 모든 능력을 포괄하고 있어요.
Codex와 Claude Code는 성숙한 프로그래밍 Agent예요. 공식 제품 형태와 계정 체계, 사용 할당량이 있고, 코드 저장소를 읽고 명령을 실행하며 테스트를 돌릴 수 있고, 브라우저 조작 능력도 갖추고 있어요. Codex는 Codex Cloud도 제공해서 작업을 원격 컴퓨팅 환경에서 실행할 수 있게 해 줘요. 이 둘을 쓰는 건 “공식 교육을 받은 엔지니어를 고용하는” 것과 비슷해서, 능력의 경계와 사용할 수 있는 모델이 기본적으로 공식 쪽에서 결정돼요.
DeepSeek Harness는 달라요. MIT 라이선스의 오픈소스 프로젝트이고, 공식 아키텍처 문서에서는 “Everything is a Plugin”이라는 표현으로 설명해요. 모델 어댑터, 도구 레지스트리, 세션 기록, Agent Loop(모델과 도구가 반복적으로 상호작용하는 실행 루프), 파일 시스템과 명령 실행, 샌드박스 승인 정책, 백그라운드 작업과 Webhook까지 모두 플러그인과 설정으로 바꿀 수 있어요. 지금은 Developer Preview 단계라서, 바로 꺼내 쓸 수 있는 완제품이라기보다 직접 개조할 수 있는 하부 구조에 가까워요.
한 가지 덧붙이자면, Codex에도 플랫폼화된 면이 있어요. OpenAI는 이미 Codex Harness를 공개했고 SDK, App Server, codex exec라는 세 가지 프로그래밍 방식의 접속을 제공해요. 다만 공식 쪽에서는 오픈소스 실행 코드와 모델 접근, 호스팅 클라우드 서비스를 서로 다른 계층으로 명확히 구분하고 있어서, 같은 것으로 묶어서 말할 수는 없어요.
| 비교 차원 | Codex | Claude Code | DeepSeek Harness |
|---|---|---|---|
| 제품 포지셔닝 | 성숙한 프로그래밍 Agent, 로컬 CLI와 클라우드 작업을 아우름 | 성숙한 프로그래밍 Agent, 개발 워크플로에 깊이 통합됨 | 오픈소스, 커스터마이징 가능한 Agent 실행 시스템 |
| 개방성 | CLI와 Harness는 오픈소스(Apache-2.0), 호스팅 클라우드 서비스는 별도 계층 | 상용 제품, 공식 확장 인터페이스 제공, 핵심 소스 코드는 비공개 | MIT 오픈소스, 현재 Developer Preview |
| 확장 방식 | MCP, Plugins, SDK, App Server | MCP, Hooks, Subagents, Agent SDK | 모든 것이 플러그인, Agent Loop도 교체 가능 |
| 유지 책임 | 공식 제품과 클라우드 서비스가 상당 부분 부담 | 공식 제품과 클라우드 서비스가 상당 부분 부담 | 사용자가 직접 설정하고 유지·관리하며 보안 책임도 짐 |
용어 한눈에 보기: Codex, Claude Code, DeepSeek Harness 비교표를 이해하는 공통 기초
앞서 말한 ‘뉴스 데일리’ 작업은 뒤에서도 계속 나와요. 그래서 여기서는 핵심 용어를 같은 사례로 먼저 풀어 볼게요. 용어마다 설명이 따로 놀지 않도록요.
- API: 프로그램과 모델 서비스 사이에 정해 둔 ‘주문 형식’이에요. 뉴스 데일리 작업의 각 단계 호출도 모두 이 API로 이뤄져요.
- API 키: ‘내가 누구인지’를 증명하는 자격 증명이에요. 택배를 찾을 때 쓰는 인증번호 같은 것이니 잘 보관해야 해요.
- Base URL: 요청을 보내는 서비스 주소예요. 주소를 설정할 수 있다고 해서 프로토콜까지 호환된다는 뜻은 아니에요.
- 모델 어댑터: 에이전트 내부에서 모델 서비스에 연결하고 요청과 응답 형식을 처리하는 컴포넌트예요.
- 도구 호출: 모델이 답을 직접 지어내지 않고 “검색 좀 해 줘”라고 요청하는 메커니즘이에요.
- MCP: 에이전트를 외부 도구와 데이터 서비스에 연결하는 프로토콜이에요. Codex와 Claude Code 모두 지원해요.
- SDK: 에이전트 기능을 여러분의 프로그램에 넣을 수 있도록 해 주는 개발 도구 키트예요.
- Webhook: 외부 이벤트가 여러분의 앱에 먼저 ‘초인종을 누르는’ 인터페이스예요.
- Agent Loop: 모델과 도구가 주고받으며 작업이 끝날 때까지 이어지는 실행 루프예요.
- 클라우드 작업: 원격 환경에서 실행되는 작업이에요. 권한과 파일 사용 가능 여부는 해당 환경의 설정에 따라 달라져요.
“모델을 바꾸고 싶다”는 건 많은 팀이 Agent 프레임워크에 관심을 갖는 직접적인 이유예요. 세 제품은 이 문제에 접근하는 방식이 크게 달라요.
Codex는 두 가지 연결 방식을 지원해요. ChatGPT 계정으로 로그인하거나, 자체 API 키를 쓰는 방식이죠(추가 설정 필요). 주의할 점은 전자는 ChatGPT 플랜에 포함된 Codex 사용량을 쓰고, 후자는 API로 과금되며 두 방식의 할당량은 서로 통용되지 않는다는 거예요. 오픈소스 Codex CLI와 구독 할당량을 같은 것으로 혼동해서도 안 돼요.
Claude Code는 공식적으로 구독 로그인과 Anthropic Console, Amazon Bedrock, Google Vertex AI, Microsoft Foundry 등의 연결 방식을 제공해요. Terminal CLI, VS Code, JetBrains 같은 개발 환경에서는 서드파티 Provider 설정도 지원하고요. 하지만 강조하고 싶은 건, 모든 Claude 제품 진입점에서 임의의 모델로 교체할 수 있다는 뜻은 아니라는 점이에요. 구체적인 지원 범위는 사용 중인 버전의 공식 문서를 기준으로 해요.
DeepSeek Harness는 자유도가 가장 높은 대신 책임도 가장 커요. 모델 어댑터 자체가 플러그인이거든요. 개발 문서에서는 DEEPSEEK_API_KEY, DEEPSEEK_BASE_URL 두 환경 변수를 예로 들어요. API 키는 인증에 쓰이고, Base URL은 사용자 지정 API 주소를 지정하는 데 쓰이며, 설정하지 않으면 기본적으로 DeepSeek 공식 API를 사용해요. 특히 강조할 점은 사용자 지정 Base URL이 DeepSeek 어댑터의 예시 설정이라는 거예요. 다른 모델 서비스가 정상적으로 동작하는지는 실제 요청 프로토콜과 도구 호출 호환성에 달려 있어요. 주소를 설정할 수 있다는 게 곧바로 바로 쓸 수 있다는 뜻은 아니에요.
원래 GPT, Claude, DeepSeek 같은 모델 사이를 자주 전환하고 비교하려는 생각이었다면, 모델 계층을 통일 인터페이스에 올려두면 전환 비용이 눈에 띄게 줄어요. APIYI apiyi.com의 공개 자료에 따르면 플랫폼은 OpenAI 호환 인터페이스를 제공하고, 하나의 API 키로 여러 주요 모델을 호출할 수 있으며, 사용량 기반 과금과 신규 사용자 무료 테스트 할당량이 있어요(이상은 플랫폼 공개 설명이며, 구체적인 모델 호환성은 실제 테스트를 기준으로 확인하는 게 좋아요).
| 비교 항목 | Codex | Claude Code | DeepSeek Harness |
|---|---|---|---|
| 기본 연결 | ChatGPT 계정 로그인, 플랜 내 사용량 사용 | Claude 구독 로그인 | 기본적으로 DeepSeek 공식 API 연결 |
| 자체 API 키 | 지원, 추가 설정 필요, API 과금 | Anthropic Console, Bedrock, Vertex AI, Foundry 등 공식 채널 지원 | DEEPSEEK_API_KEY 등 환경 변수로 설정 |
| 사용자 지정 모델 주소 | 공식적으로 임의의 서드파티 모델 주소를 열어두지 않음 | CLI와 IDE는 서드파티 Provider 지원, 다만 모든 제품 진입점을 포괄하지는 않음 | DEEPSEEK_BASE_URL로 사용자 지정 주소 지정 가능 |
| 전환 자유도 | 공식 계정 체계와 과금 규칙의 제약을 받음 | 중간 이상, 조건부 제한 있음 | 가장 높지만 프로토콜과 도구 호출 호환성을 직접 검증해야 함 |

위 그림의 계층 구분은 이 글을 이해하는 핵심이에요. 모델 서비스 계층은 추론 능력만 제공하고, Agent 환경 계층은 작업을 어떻게 계획하고 실행할지 결정하며, 외부 도구 계층에서야 비로소 브라우저, 파일, 기업 백엔드에 닿아요. 모델을 바꾸는 건 가장 아래층을 해결하는 일이고, 자동화를 구축하는 건 중간과 최상층을 해결하는 일이라서 둘은 서로를 대체할 수 없어요.
업무 도구 연결: Codex, Claude Code, DeepSeek Harness 중 확장 방식이 더 유연할까?
일일 보고서 작업의 세 번째 단계인 “회사 백오피스에 입력하기”로 돌아가 보면, 이 단계에서 핵심은 도구 확장 능력이에요.
Codex는 MCP로 외부 도구를 연결하고, SDK로 자체 프로그램 안에서 Agent 작업을 시작하고 관리해요. App Server는 다른 애플리케이션이 Codex의 세션, 이벤트, 도구 호출, 승인 흐름에 접속할 수 있게 해주고, codex exec는 스크립트와 CI 환경을 겨냥해 반복 실행 가능한 자동화 작업을 만들기 쉽게 해줘요. 전체적인 접근은 “공식 완제품 + 표준화된 프로그래밍 인터페이스”예요.
Claude Code의 확장 체계는 MCP, Hooks, Subagents를 중심으로 구성돼요. 공식 MCP 예시로는 Google Drive 설계 문서 읽기, Jira에서 작업 가져오기, PostgreSQL 쿼리, Gmail 초안 만들기, 심지어 외부 이벤트나 Webhook으로 Agent 세션에 메시지 보내기가 있어요. Subagents는 독립적인 컨텍스트, 시스템 프롬프트, 도구 권한, 모델 선택을 가질 수 있고 백그라운드에서 병렬로 작업할 수 있어요. Hooks는 도구 호출 전후, 권한 요청, 세션 시작과 종료 등의 단계에서 사용자 정의 스크립트를 실행할 수 있어서 프로세스에 “체크포인트”를 추가하기에 알맞아요.
DeepSeek Harness의 확장 로직은 더 근본적이에요. 도구 레지스트리, Agent Loop, 샌드박스 승인 정책을 모두 교체할 수 있다는 뜻으로, 단순히 “도구를 추가”하는 데 그치지 않고 “모델이 어떤 도구를 호출할지, 실행을 어떻게 이어갈지”까지 바꿀 수 있어요. 그 대가는 분명해요. 모든 것을 스스로 구성하고 유지보수해야 하고, 공식 보안 설명에서도 프로젝트가 아직 보안 감사를 완료하지 않았으며 운영 환경에 적합한 보안 소프트웨어로 간주해서는 안 된다고 명확히 밝히고 있어요.
| 확장 기능 | Codex | Claude Code | DeepSeek Harness |
|---|---|---|---|
| 외부 도구 연동 | MCP, Plugins | MCP(공식 예시에 Drive, Jira, PostgreSQL, Gmail 등 포함) | 플러그인 체계와 도구 레지스트리 |
| 실행 과정 개입 | SDK, App Server, Hooks | Hooks로 도구 호출 전후, 권한 요청 등의 단계에서 스크립트 실행 가능 | Agent Loop 자체를 교체 가능 |
| 멀티 에이전트 협업 | 클라우드와 SDK를 통한 멀티태스크 오케스트레이션 | Subagents가 독립된 컨텍스트와 권한을 가지며 백그라운드에서 병렬 작업 가능 | 플러그인을 통한 자체 조합 |
| 업무 시스템 연동 | SDK, App Server, codex exec | MCP, Webhook으로 세션에 메시지 전송 가능 | Background Jobs, Webhook, SDK 실행 템플릿 |
자동화 구축: Codex, Claude Code, DeepSeek Harness 실행 방식 비교
일일 보고서 작업에서 가장 어려운 단계는 “내일도 자동으로 계속 실행되게 하는 것, 가능하면 컴퓨터를 켜지 않아도 되는 것”이에요. 이는 실행과 스케줄링 능력을 시험하는 문제라서, 먼저 세 가지 서로 다른 능력을 구분해야 해요: 로컬 프로세스 실행, 관리형 클라우드 작업, 지속적 스케줄링이에요.
Codex Cloud는 OpenAI가 관리하는 원격 컴퓨팅 환경을 제공하고, 각 작업에는 독립적인 작업 공간이 있어요. 컴퓨터가 절전 상태가 되어도 클라우드 작업은 계속 실행될 수 있어요. 공식 도움말 문서에 따르면 저장된 가상 머신 상태는 기본적으로 작업이 마지막으로 시작되거나 복원된 후 최대 7일까지 복구할 수 있어요(공식 설명). “종료 후에도 예약 작업이 계속 실행되어야 하는” 시나리오에는 Codex Cloud가 비교적 직접적인 공식 솔루션이에요.
Claude Code는 주로 로컬에서 실행되며, 백그라운드 Agent와 세션 간 Subagents는 구체적인 실행 방식에 따라 달라져요. 컴퓨터 종료 후 계속할 수 있는지는 실행 환경을 어디에 배포했는지에 달려 있어요. 공식적으로는 이를 “종료 후에도 이어서 실행할 수 있는” 클라우드 작업 제품으로 포지셔닝하지 않았어요.
DeepSeek Harness는 Background Jobs와 Webhook을 제공해 다른 자동화 시스템과 연동할 수 있지만, 공식 로컬 작업 백엔드는 실행 중인 프로세스에 의존해요. 24시간 내내 작동하게 하려면 직접 항상 켜져 있는 서버나 컨테이너에 배포해야 해요. 브라우저 조작의 경우 dsh-browser-use를 설치하고 Playwright MCP, Chrome DevTools MCP, Stagehand 등 실험적 제공자를 명시적으로 활성화해야 하며, 로그인 상태는 세션 로그에서 자동으로 복구되지 않아요. 이는 모두 “높은 자유도”에 따르는 비용이에요.
| 실행 방식 | Codex | Claude Code | DeepSeek Harness |
|---|---|---|---|
| 로컬 실행 | CLI가 로컬 터미널에서 실행 | Terminal CLI 및 IDE 통합 | Web, Headless, SDK 등 실행 템플릿 |
| 클라우드 실행 | Codex Cloud 원격 환경, 컴퓨터 절전 후에도 계속 가능 | 실행 방식과 배포 조건에 따라 다름 | 항상 켜져 있는 서버나 컨테이너를 직접 준비해야 함 |
| 백그라운드 작업 및 스케줄링 | 클라우드 작업, codex exec는 스크립트 및 CI 대상 | 백그라운드 Agent, 세션 간 Subagents | Background Jobs, Webhook(실행 중인 프로세스에 의존) |
| 브라우저 조작 | 브라우저 및 Computer Use 관련 역량 보유 | Chrome 확장 및 Computer Use(조건부) | dsh-browser-use 등 실험적 제공자 설치 필요 |
참고로 브라우저 검색, 브라우저 자동 조작, 데스크톱 제어는 서로 다른 등급의 역량이므로 평가할 때 혼동하면 안 돼요. 로컬 예약 실행과 클라우드 지속 실행 역시 전혀 다른 이야기예요.
Codex, Claude Code, DeepSeek Harness 빠르게 시작하기: 먼저 모델 계층 API부터 연동하기
어느 것을 선택하든 첫 단계는 모델 계층을 연동해 보는 것이에요. OpenAI 호환 API를 예로 들면, 십여 줄의 코드로 첫 호출을 마칠 수 있어요:
import openai
client = openai.OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.apiyi.com/v1" # APIYI 통합 인터페이스, OpenAI 호환
)
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "用一句话总结今天的 AI 新闻要点"}],
)
print(response.choices[0].message.content)
전체 구현 코드 보기: 도구 호출로 Agent Loop 이해하기
import json
import openai
client = openai.OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.apiyi.com/v1" # APIYI 통합 인터페이스
)
tools = [
{
"type": "function",
"function": {
"name": "search_news",
"description": "搜索今天的 AI 新闻",
"parameters": {
"type": "object",
"properties": {"keyword": {"type": "string"}},
},
},
}
]
def search_news(keyword):
# 실제 프로젝트에서는 검색 API 또는 업무 시스템 API로 교체하세요
return "关于 " + keyword + " 的示例新闻"
messages = [{"role": "user", "content": "搜索今天的 AI 新闻, 总结成一段日报"}]
for _ in range(5):
# Agent Loop: 모델과 도구가 작업이 완료될 때까지 반복적으로 상호작용합니다
response = client.chat.completions.create(
model="gpt-4o-mini", messages=messages, tools=tools
)
msg = response.choices[0].message
if msg.tool_calls:
messages.append(msg)
for call in msg.tool_calls:
args = json.loads(call.function.arguments or "{}")
result = search_news(args.get("keyword", "AI"))
messages.append({"role": "tool", "tool_call_id": call.id, "content": result})
else:
print(msg.content)
break
이 코드는 바로 “모델 API ≠ Agent 환경”이라는 점을 보여줘요. 모델은 ‘도구를 호출할지, 어느 도구를 호출할지’만 결정하고, search_news는 여러분이 직접 제공하는 실행 계층이며, for 반복문이 가장 단순한 Agent Loop예요. 도구 함수를 여러분의 업무 API로 바꾸고, 여기에 Codex SDK, Claude Code의 MCP, 또는 DeepSeek Harness의 플러그인 체계를 얹으면 각 서비스 자동화의 초기 형태가 됩니다. 도구 호출의 구체적인 매개변수 형식과 사용 가능 범위는 선택한 모델과 API 문서를 기준으로 해요.
🚀 빠른 시작: 먼저 APIYI apiyi.com을 통해 모델 계층을 연동해 보고, API 키와 신규 사용자 무료 테스트 크레딧을 받은 뒤, 통합 인터페이스로 도구와 스케줄링을 단계적으로 연결하는 것을 권장합니다. 플랫폼은 여러 주류 모델의 통합 인터페이스 호출을 지원하여 같은 환경에서 비교하고 전환하기 편리합니다(플랫폼 공개 설명).
⚠️ 주의: API 중계 서비스는 모델 연결과 전환을 도울 수 있지만, 브라우저 조작, 파일 권한, 클라우드 연산, 작업 스케줄링 능력을 자동으로 제공하지는 않아요. 모델 API를 호출하는 것과 Codex나 Claude의 제품 구독을 보유하는 것은 서로 다른 일이에요.
시나리오 추천: 모델 교체, API 연동, 자동화 구축은 어떻게 선택할까

| 요구사항 | 우선 고려 | 주된 이유 |
|---|---|---|
| 완성도 높은 코딩 Agent를 바로 사용하고 싶다 | Codex 또는 Claude Code | 공식 제품 형태가 완전하고 유지보수 비용이 낮아요 |
| GPT, Claude, DeepSeek 등 모델을 자유롭게 교체하고 싶다 | DeepSeek Harness | 어댑터를 교체할 수 있고, 사용자 정의 Base URL을 지원해요 |
| Agent를 자사의 업무 소프트웨어에 통합하고 싶다 | Codex SDK/App Server, Claude Agent SDK, DeepSeek Harness SDK | 세 가지 모두 프로그래밍 방식으로 접근할 수 있는 방법을 제공해요 |
| 컴퓨터 전원을 끈 후에도 정기 작업을 계속 실행하고 싶다 | Codex Cloud 또는 자체 배포한 Harness 서비스 | 공식 클라우드 작업과 자체 구축 상시 환경의 대비 |
| Agent의 실행 로직 자체를 개조하고 싶다 | DeepSeek Harness | MIT 오픈소스이며, Agent Loop를 교체할 수 있어요 |
의사결정 제안: 먼저 자신에게 얼마나 많은 자유도를 원하는지 물어보세요
- 완성도 높은 코딩 Agent를 바로 사용하고 싶다면: Codex 또는 Claude Code를 선택하세요. 두 제품 모두 개발 워크플로가 완전하고 공식에서 유지보수의 대부분을 담당하기 때문에, 작업을 바로 맡기고 최대한 빠르게 결과를 내고 싶은 팀에 적합해요. 다만 모델 선택과 사용량 규칙이 공식 제품에 의해 결정된다는 점은 받아들여야 해요.
- 모델과 실행 메커니즘을 자유롭게 교체하고 싶다면: DeepSeek Harness를 선택하세요. 플러그인 아키텍처가 최대한의 개조 공간을 제공하지만, Developer Preview라는 현재 상태, 보안 감사가 완료되지 않았다는 안내, 그리고 자체 배포와 자체 대응에 대한 모든 책임을 감당해야 해요.
- Agent를 자사의 업무 소프트웨어에 통합하고 싶다면: Codex SDK/App Server, Claude Agent SDK, DeepSeek Harness SDK 세 가지 프로그래밍 경로를 우선 검토하고, 현재 보유한 기술 스택과 원하는 모델 자유도에 맞춰 조합하세요.
💡 선택 제안: 어느 것을 선택할지는 원하는 자유도와 감당할 수 있는 유지보수 비용에 달려 있어요. 결정하기 전에 APIYI apiyi.com 같은 통합 인터페이스에서 계획 중인 모델을 하나씩 먼저 테스트해 보고, 모델 계층의 성능을 검증한 뒤 어떤 Agent 형태를 적용할지 결정하는 것을 권장해요.
자주 묻는 질문 FAQ
Q1: Codex, Claude Code, DeepSeek Harness의 본질적 차이는 무엇인가요?
Codex와 Claude Code는 각각 OpenAI와 Anthropic의 성숙한 코딩 에이전트 제품으로, 공식 계정과 사용 할당량, 확장 인터페이스를 갖추고 있어요. 반면 DeepSeek Harness는 MIT 라이선스로 공개된 에이전트 실행 프레임워크로, 모델과 도구, 실행 루프가 모두 교체 가능한 플러그인 형태이며 현재 Developer Preview 단계예요. 앞의 두 제품이 ‘바로 꺼내 쓸 수 있는 완성품’이라면, 후자는 ‘직접 개조할 수 있는 차체’에 가까워요.
Q2: DeepSeek Harness와 DeepSeek API 직접 호출은 무엇이 다른가요?
DeepSeek API를 직접 호출하면 모델의 추론과 생성 능력만 얻을 수 있어요. DeepSeek Harness는 모델을 감싸는 완전한 실행 환경으로, 도구 호출과 세션 기록, 샌드박스, 백그라운드 작업을 담당해요. 비유하자면 API는 엔진이고, Harness는 직접 개조할 수 있는 완성차예요. DeepSeek 이외의 모델로 바꾸고 싶다면 어댑터와 Base URL을 설정하고 프로토콜 및 도구 호출 호환성을 검증해야 해요. 또는 APIYI apiyi.com 같은 통합 인터페이스를 통해 모델 계층에서 먼저 횡적 비교를 해볼 수도 있어요.
Q3: Codex는 반드시 ChatGPT 구독이 있어야 하나요? 자체 API 키를 쓸 수는 없나요?
꼭 그렇지는 않아요. 공식 저장소에는 ChatGPT 계정 로그인을 지원한다고 안내되어 있고, 자체 API 키 사용도 지원해요(추가 설정 필요). 전자는 ChatGPT 플랜에 포함된 Codex 사용량을 쓰고, 후자는 API 사용료로 과금되며 두 방식의 할당량은 서로 통용되지 않아요. 오픈소스 Codex CLI 역시 구독 할당량과 바로 등호로 연결해서는 안 돼요.
Q4: Claude Code를 Claude가 아닌 모델로 바꿀 수 있나요?
공식 문서에는 Anthropic Console, Amazon Bedrock, Google Vertex AI, Microsoft Foundry 등의 연동 방식을 나열하고 있고, Terminal CLI와 VS Code, JetBrains 등 개발 인터페이스에서 서드파티 Provider 설정을 지원해요. 다만 이것이 모든 Claude 제품 진입점에서 임의의 모델로 교체할 수 있다는 뜻은 아니며, 구체적인 지원 범위는 사용 중인 버전의 공식 설명을 기준으로 확인해야 해요.
Q5: 모델 API를 빠르게 연동해 이 세 가지 에이전트를 검증하려면 어떻게 해야 하나요?
모델 계층에서 먼저 정상 동작을 확인한 뒤, 도구와 스케줄링을 단계적으로 붙이는 걸 권장해요:
1. APIYI apiyi.com에서 계정을 등록하고 API 키와 신규 사용자 무료 테스트 할당량을 받아요;
2. 본문 코드 예시의 `base_url`을 `https://api.apiyi.com/v1`로 바꾸고 첫 호출을 완료해요;
3. 모델 출력과 도구 호출 형식이 정상인지 확인한 다음, Codex SDK, Claude Code의 MCP, DeepSeek Harness의 플러그인을 각각 연동해요.
플랫폼은 OpenAI 호환 인터페이스와 다중 모델 연동을 제공한다고 공개하고 있어(플랫폼 공개 설명), 같은 코드에서 서로 다른 모델을 비교하기 편리해요.
Q6: DeepSeek Harness를 프로덕션 환경에 바로 쓸 수 있나요?
프로덕션에 바로 투입하는 것은 권장하지 않아요. 공식 보안 설명에 프로젝트가 아직 보안 감사를 완료하지 않았으며, 프로덕션 환경에 적합한 보안 소프트웨어로 간주해서는 안 된다고 명시되어 있어요. 이 도구는 모델이 생성한 코드와 명령을 실행할 수 있어, 권한이 부여된 파일과 네트워크, 프로세스, 자격 증명에 접근할 가능성이 있어요. 공식 문서는 최소 권한을 사용하고 일회용 가상 머신이나 컨테이너, 전용 환경에서 우선 실행할 것을 권장해요.
Q7: 모델 API가 도구 호출을 지원하면 에이전트가 반드시 돌아가나요?
꼭 그렇지는 않아요. 에이전트가 정상 동작하는지는 실행 환경과 도구 등록, 권한, 스케줄링에도 달려 있어요. Base URL을 설정할 수 있다고 해서 프로토콜이 자동으로 호환되는 건 아니에요. 모델 계층이 연결되더라도 브라우저 조작, 파일 접근, 예약 작업에는 각각에 대응하는 컴포넌트가 필요해요. 통합 전에는 ‘모델 계층 → 도구 계층 → 스케줄링 계층’ 순으로 단계별 검증을 권장해요.
Codex, Claude Code, DeepSeek Harness 핵심 포인트
- 포지셔닝 차이: Codex와 Claude Code는 성숙한 코딩 에이전트이고, DeepSeek Harness는 오픈소스 에이전트 실행 프레임워크예요.
- 모델 선택 자유도: Harness는 어댑터를 교체할 수 있고 사용자 정의 Base URL도 지원해요. 반면 앞의 두 제품은 공식 연결 채널의 제약을 받아요.
- 확장 방식: MCP와 SDK는 공통 언어예요. Hooks와 Subagents는 Claude Code의 특징이고, Harness는 Agent Loop까지 바꿀 수 있어요.
- 실행 방식 차이: Codex Cloud는 컴퓨터가 절전 모드로 전환된 뒤에도 계속 실행할 수 있어요. Harness의 예약 작업에는 상시 실행 환경을 직접 마련해야 해요.
- 보안 경계: DeepSeek Harness는 Developer Preview 단계로 보안 감사를 완료하지 않았어요. 직접 구축할 때는 최소 권한 원칙을 지켜야 해요.
- 도입 순서: 먼저 모델 계층 API를 정상적으로 연결해 검증한 뒤, 도구와 스케줄링을 계층별로 붙여 나가세요. 한 번에 완전 자동화를 추구하는 것은 피하는 게 좋아요.
요약
세 제품을 각자의 자리로 돌려놓고 보면 결론은 명확해요.
- Codex: 성숙한 코딩 에이전트에 Codex Cloud의 클라우드 작업까지 더한 제품으로, “작업을 위임하고 싶은” 팀에 적합해요.
- Claude Code: 성숙한 코딩 에이전트이며, MCP, Hooks, Subagents가 유연한 확장 생태계를 구성해요. 기존 개발 워크플로에 깊이 맞춤화하려는 경우에 적합해요.
- DeepSeek Harness: MIT 오픈소스로 개조 가능한 기반이며, 모델과 실행 메커니즘을 모두 바꿀 수 있어요. 자동화 시스템을 직접 구축하고 유지보수와 보안 책임을 감당할 수 있는 개발자에게 적합해요.
마지막으로 가장 중요한 경계로 돌아가 볼게요. 모델 API는 추론 능력을 결정하고, 에이전트 환경은 모델이 무엇을 호출할 수 있는지, 어떻게 실행할지, 결과를 사용자에게 어떻게 전달할지를 결정해요. 모델 교체, API 연결, 자동화 구축은 서로 다른 세 가지 계층의 일이에요. “모델 계층 → 도구 계층 → 스케줄링 계층” 순서로 하나씩 검증하는 편이 한 번에 처리하는 것보다 안정적이에요. 모델 계층의 효과를 빠르게 검증하려면 APIYI(apiyi.com)를 추천해요. 이 플랫폼은 OpenAI 호환 API, 여러 모델의 통합 연결, 신규 사용자 무료 크레딧을 제공해요.
참고 자료
- GitHub – Codex: OpenAI 공식 오픈소스 저장소
- 링크:
github.com/openai/codex -
설명: CLI 소스 코드, 계정 및 API 키 연동 방식 안내
-
Codex as a platform: OpenAI 개발자 블로그
- 링크:
developers.openai.com/blog/codex-as-a-platform -
설명: 오픈소스 Harness, SDK, App Server와 호스팅 서비스의 계층 구조 설명
-
Using Codex Cloud: OpenAI 공식 도움말 문서
- 링크:
help.openai.com/en/articles/20001545-using-codex-cloud -
설명: 원격 컴퓨팅 환경, 독립 워크스페이스, 가상 머신 상태 복원 규칙
-
Claude Code Docs: Anthropic 공식 문서
- 링크:
code.claude.com/docs/en/overview -
설명: 연동 방식, MCP, Subagents, Hooks 기능 안내
-
GitHub – DeepSeek Harness: DeepSeek 공식 저장소
- 링크:
github.com/deepseek-ai/deepseek-harness -
설명: 플러그인 아키텍처, 모델 어댑터 설정, 브라우저 서브시스템 및 보안 안내
-
APIYI 개발자 가이드: 플랫폼 공개 소개
- 링크:
help.apiyi.com/apiyi-wentuozhongxin-shangxian-kaifazhe-zhinan.html - 설명: OpenAI 호환 인터페이스, 통합 API 키, 멀티모델 연동 안내
작성자: APIYI 기술팀
기술 교류: APIYI 웹사이트 첫 페이지에서 저희에게 연락해 주세요. 더 많은 모델 연동 자료는 docs.apiyi.com 문서 센터에서 확인하실 수 있어요.
