OpenHands와 Claude Code 비교: 워크플로, 샌드박싱 및 총비용

지원되는 터미널 코딩 에이전트를 원하고 한 번의 명령으로 설치한 뒤 계정으로 결제하고 싶다면 Claude Code를 선택하세요. 실행 환경을 직접 소유하는 것 자체가 요구 사항이라면 OpenHands를 선택하세요. 이 구분은 2026년 9월에 특히 중요합니다. 두 제품은 더 이상 같은 형태가 아니기 때문입니다. Claude Code는 독점 터미널 에이전트입니다. OpenHands는 Agent Canvas가 모노레포에 통합된 이후 주로 셀프 호스팅 브라우저 제어 센터가 되었으며, 직접 비교할 수 있는 유일한 표면인 자체 터미널 CLI는 유지 관리 단계로 명시되어 있습니다.

두 제품은 중간 지점에서도 만납니다. 따라서 단순한 양자택일로 설명하면 오해를 부릅니다. Agent Canvas는 Agent Client Protocol을 통해 Claude Code를 하위 프로세스로 실행할 수 있으므로, "둘 다"는 실제 구성이며 하나를 선택하기 전에 확인할 만한 결제상의 결과가 따릅니다.

실제로 비교하는 대상

두 프로젝트 모두 최근에 이동했기 때문에 2025년 리뷰를 보면 잘못된 저장소로 안내됩니다. 이전에 All-Hands-AI/OpenHands에 있던 저장소는 이제 OpenHands/OpenHands이며 이전 경로는 이곳으로 리디렉션됩니다. docs.all-hands.dev는 docs.openhands.dev로 리디렉션되고, 독립된 OpenHands/agent-canvas 저장소는 Canvas가 모노레포에 통합되었기 때문에 보관 처리되었습니다. Claude Code의 문서도 이동했습니다. docs.claude.com/en/docs/claude-code/…는 이제 code.claude.com/docs/en/…로 301 리디렉션됩니다.

모든 출처는 2026년 9월 21일에 다시 확인했습니다. OpenHands 저장소 API, 해당 README, 컴포넌트 맵(CLI 상태 문구와 아래의 Local GUI 참고 사항을 모두 포함), CLI 페이지(uv tool install 명령을 게시), Claude Code npm 레지스트리 항목, 해당 LICENSE.md 및 설정 문서입니다.

CLI 관련 질문은 숫자 하나만으로도 결론이 납니다. OpenHands 문서의 설치 명령은 PyPI openhands 패키지를 가져오며, 이 패키지는 2026년 5월 8일 업로드된 1.16.0에 머물러 있습니다. 릴리스는 34개이고 봄 이후에는 아무것도 없습니다. 같은 기간 그 기반 라이브러리는 계속 출시되었습니다. openhands-sdk 1.49.2는 2026년 9월 17일에 업로드되었습니다. 두 터미널 에이전트를 비교하려고 이 페이지에 왔다면 그 격차가 답입니다. OpenHands의 터미널 표면은 개발이 집중되는 곳이 아닙니다.

누가 무엇을 선택해야 하나요

Claude Code를 선택하세요 이미 체크아웃한 저장소에서 한 개발자가 변경을 주도하는 워크플로를 사용하고, 에이전트를 직접 운영하기보다 구매하고 싶다면 말입니다. 실행은 자신의 사용자 계정과 권한 아래 워크스테이션에서 로컬로 이루어지고, 권한 요청은 Claude Code 자체의 프롬프트를 따르며, 설정은 설치 명령 한 번과 로그인으로 끝납니다. 비용 경로는 Anthropic 플랜, API 계정 또는 사용자가 지정하는 게이트웨이입니다. 함께 다른 것을 시도하기 위해 기존 설정을 제거할 필요도 없습니다. 메모리 문서는 프로젝트 지침을 저장소 자체의 CLAUDE.md 또는 AGENTS.md 파일에 넣도록 안내합니다.

OpenHands를 선택하세요 실제로 필요한 것이 제어 플레인인 경우입니다. 선택한 백엔드에 대해 여러 대화와 예약된 자동화를 실행하고, 샌드박스 경계를 가정이 아니라 명시적인 결정으로 다루고 싶을 때입니다. 샌드박스 문서는 Docker 샌드박스(권장), "안전하지 않지만 빠름"이며 "컨테이너 격리 없음"으로 설명된 Process 샌드박스, 그리고 RUNTIME 환경 변수로 선택하는 Remote 샌드박스를 제공합니다. 이는 기능 격차가 아니라 형태의 실제 차이입니다. Claude Code는 macOS, Linux 및 WSL2에서 운영 체제가 기본 제공하고 강제하는 자체 샌드박스 Bash 도구를 문서화하지만, 사용자가 이미 앉아 있는 컴퓨터에서 명령을 샌드박싱합니다. 반면 OpenHands에서는 전체 에이전트 서버가 실행될 백엔드를 선택할 수 있습니다. 선택은 진정한 선택이며, 이제 그 운영 작업도 사용자가 맡게 됩니다.

팀에서 OpenHands를 선택하기 전에 한계를 확인하세요. 자체 FAQ에는 다음과 같이 나와 있습니다. "OpenHands는 단일 사용자가 자신의 로컬 워크스테이션에서 실행하도록 설계되었습니다. 여러 사용자가 동일한 인스턴스를 공유하는 멀티테넌트 배포에는 적합하지 않습니다. 기본 제공 인증, 격리 또는 확장성이 없습니다." 다중 사용자는 가격을 공개하지 않는 Enterprise 플랜에서 제공됩니다. 또한 Canvas 자체는 아무것도 샌드박싱하지 않습니다. 설치 페이지에는 에이전트와 ACP 프로세스를 신뢰할 수 없는 것으로 취급해야 하며, "Agent Canvas는 클라이언트일 뿐 격리를 제공하지 않는다"고 명시되어 있습니다. 컴퓨터에서 직접 실행되는 백엔드에서는 에이전트가 사용자 계정의 권한으로 동작할 수 있습니다.

둘 다 선택하세요 Canvas의 운영 표면과 Claude Code의 에이전트 동작을 함께 원한다면 말입니다. 이는 문서화된 구성이고, 두 섹션 아래에서 다룹니다.

플랜 및 각 플랜의 제한 사항

2026년 9월 21일에 openhands.dev/pricing 및 anthropic.com/pricing에서 확인했습니다. 다른 곳에서 보게 될 수치에 관한 참고 사항입니다. Max 20x는 월 $200로 널리 인용되지만 Anthropic 페이지에는 "From $100"만 표시되고, 마크업에 있는 유일한 $200은 Pro 연간 선불 요금입니다. 제3자 표를 신뢰하기보다 업그레이드 화면에서 20x 가격을 확인하세요. 이 페이지도 예외가 아닙니다.

두 공급업체 출처가 OpenHands의 로컬 브라우저 인터페이스에 대해 서로 다른 내용을 말하므로, 무엇을 설치하는지 알아둘 필요가 있습니다. 가격 페이지의 기능 표에는 무료 Local 플랜 아래에 "Web-based GUI"가 나열되어 있지만, 문서의 컴포넌트 맵은 Local GUI를 "이전 OpenHands 모노레포에서 제공되던 더 이상 사용되지 않는 Docker 기반 브라우저 애플리케이션"이라고 부르며 "활성 브라우저 클라이언트 개발에는 Agent Canvas를 사용"하라고 합니다. 컴포넌트 맵을 따르세요.

모델에 관해서는 OpenHands Cloud의 Individual 등급이 자체 라우팅 공급자를 "마크업 없이 원가로" 제공합니다. 공개된 요금표에는 "표시된 가격은 마크업 없는 공급자 요금을 반영합니다"라고 명시되어 있지만, 현재 Claude 카탈로그로 읽어서는 안 됩니다. 여기에 나열된 최신 Sonnet은 Sonnet 4.5로 백만 토큰당 $3/$15인 반면, Anthropic의 자체 가격 페이지에는 Sonnet 5가 $2/$10으로 표시됩니다. 여기서 받아들여야 할 주장은 원가, 마크업 없음이라는 메커니즘입니다. 이 페이지에서는 OpenHands Cloud에 로그인하지 않았으므로 해당 계정이 오늘 실제로 어떤 모델을 제공하는지는 말할 수 없습니다.

Canvas는 Claude Code를 실행할 수 있으며 로그인 정보가 키보다 우선합니다

모노레포 README에는 Agent Canvas가 "로컬, 원격 및 클라우드 백엔드 전반에서 OpenHands, Claude Code, Codex, Gemini 또는 ACP 호환 에이전트를 실행"할 수 있다고 나와 있습니다. ACP 에이전트 페이지는 Claude Code의 기본 명령을 npx -y @agentclientprotocol/claude-agent-acp로 제시하고 메커니즘을 명확히 설명합니다. 공급업체 자체 CLI가 하위 프로세스로 실행되며, Agent Server가 "하위 프로세스와 자격 증명을 소유하고, Agent Canvas는 실행할 에이전트가 무엇인지만 기록하며 필요한 비밀 정보를 입력하는 양식을 표시"합니다.

결제 세부 정보는 인증 섹션에 있으며 많은 사람이 놀랍니다. 구독 로그인은 Claude Code 자체의 자격 증명 저장소(즉 macOS 키체인 또는 Linux의 ~/.claude/.credentials.json)에서 자동으로 감지되며, 문서에는 "로그인이 API 키보다 우선합니다. 로그인되어 있는 동안 환경에 설정된 키는 사용되지 않습니다"라고 명시되어 있습니다. 따라서 Pro 또는 Max로 claude을 실행하고 로그인한 적이 있는 컴퓨터에서는 키로 사용량이 측정된다고 생각했던 작업이 대신 구독을 사용합니다. 같은 페이지에서는 반대의 경우도 설명합니다. "깨끗한 클라우드 샌드박스에는 저장된 로그인이 없으므로 대신 API 키가 필요합니다." 즉 동일한 Canvas 설정도 어떤 백엔드에서 실행되는지에 따라 두 가지 방식으로 청구될 수 있습니다. 모델 구성 페이지는 다음과 같이 결론을 내립니다. "Claude Code, Codex 및 Gemini CLI와 같은 ACP 에이전트는 자체 모델 액세스를 관리합니다." 따라서 OpenHands LLM 프로필이 해당 하위 프로세스를 다른 곳으로 리디렉션하지는 않습니다.

동일한 게이트웨이, 서로 다른 두 URL 문자열

두 클라이언트 중 하나를 자신의 API 키 하나로 라우팅한다면 가장 흔한 실패는 URL 형태입니다. 두 규칙이 서로 반대이기 때문입니다. Claude Code는 Anthropic Messages 형식을 사용하며 origin을 요구합니다. OpenHands는 LiteLLM을 통해 라우팅하며 /v1를 포함하는 기본 URL과 공급자 접두사가 붙은 모델 ID를 요구합니다.

# ANTHROPIC_BASE_URL takes the ORIGIN. Claude Code appends /v1/messages
# itself, so a trailing /v1 produces /v1/v1/messages, which your gateway
# will not be serving.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-your-kunavo-key

# Pin models Kunavo serves. Claude Code's default and its opus alias are the
# newest Opus — pinned here to Opus 5.5, which needs Claude Code v2.1.280 or
# later (run `claude update`). The sonnet alias asks for Sonnet 5.5, which
# Kunavo does not serve: unpinned, /model sonnet, opusplan's execution phase
# and sonnet subagents 404.
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5

# On this path background tasks run on the main model unless this variable
# pins one, so it is worth setting.
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

# OpenHands routes through LiteLLM, so the id carries a provider prefix
# and the base URL INCLUDES /v1 — the opposite convention to the one above.
LLM_MODEL=openai/claude-sonnet-5
LLM_API_KEY=sk-your-kunavo-key
LLM_BASE_URL=https://api.kunavo.com/v1

# In Agent Canvas the same three values are Settings > LLM > Advanced:
#   Custom Model / Base URL / API Key

Claude Code 변수는 환경 변수 페이지에 문서화되어 있습니다. ANTHROPIC_BASE_URL은 "프록시 또는 게이트웨이를 통해 요청을 라우팅하도록 API 엔드포인트를 재정의"하고, ANTHROPIC_AUTH_TOKEN는 "Authorization 헤더의 사용자 지정 값(여기서 설정한 값에는 Bearer가 접두사로 추가됨)"입니다. 게이트웨이 프로토콜 페이지에는 엔드포인트가 /v1/messages 및 선택적 /v1/messages/count_tokens로 나열되어 있으므로, 변수에는 origin만 사용합니다. OpenHands 필드는 LLM 설정 페이지의 Custom Model, 즉 "공급자를 접두사로 사용하여 사용자 지정 모델을 설정"; Base URL; API Key에서 가져옵니다. 모델 구성 페이지는 openai/<served-model-id>를 지정하며, 정확한 ID는 "대개 GET /v1/models 엔드포인트에서" 가져옵니다.

공급업체 자체 페이지에서 확인한 네 가지 실용적인 주의 사항입니다. 테스트 결과가 아닙니다.

• Claude Code에서 조용히 비용이 증가하는 문제. 게이트웨이가 cache_control를 변경 없이 전달하지 않으면 게이트웨이 페이지에 "오류 없음: 모든 턴에서 대화가 캐시되지 않은 입력으로 청구됨"이라고 나와 있습니다. 오류 메시지는 없지만 가격 차이가 발생합니다.
• 사용자 지정 호스트에서 비활성화되는 기능. ANTHROPIC_BASE_URL를 자사 호스트가 아닌 호스트로 설정하면 기본적으로 MCP 도구 검색이 비활성화됩니다(tool_reference 블록을 프록시가 전달하는 경우 ENABLE_TOOL_SEARCH=true로 다시 활성화). 또한 v2.1.196부터 Remote Control이 비활성화됩니다. 게이트웨이 모델 검색도 기본적으로 꺼져 있습니다.
• 스트림을 버퍼링해서는 안 됩니다. Claude Code는 SSE 핑을 포함한 릴레이된 바이트를 계산하며 "기본적으로 300초 동안 조용한 스트림을 중단합니다".
• OpenHands는 저장할 때 유효성을 검사하며 연결 가능성은 백엔드의 문제입니다. 로컬 프로필을 저장하면 먼저 백엔드에 대해 유효성을 검사하고 실패 시 저장을 차단합니다. 또한 기본 URL은 백엔드에서 연결 가능해야 합니다. Canvas가 Docker에서 실행되고 엔드포인트가 호스트에 있다면 127.0.0.1는 컨테이너를 가리킵니다. 계정당 LLM 프로필은 최대 10개까지 유지할 수 있습니다.

Kunavo는 Anthropic 형식 경로에 대한 설정 참고 자료인 ANTHROPIC_BASE_URL 및 Claude Code 통합과 OpenAI 형식 경로에 대한 빠른 시작을 제공합니다. 이는 게시된 구성 참고 자료이지 호환성 테스트가 아닙니다. 이 페이지를 위해 어느 클라이언트도 설치하거나 엔드포인트에 연결해 실행하지 않았습니다. 여기에는 OpenHands 전용 설정 페이지가 없으며 OpenHands에 대해 문서화된 Anthropic 접두사 경로도 어느 쪽이든 검증되지 않았습니다. 따라서 위의 openai/ 형식을 문서화된 경로로 취급하고 자체 환경에서 확인하세요.

하나의 사용량 측정 키에서 세션에 드는 비용

이는 측정된 작업 비용이 아니며 청구 한도도 아닌 예시용 토큰 계산입니다. 작은 작업이 캐시되지 않은 입력 150k 토큰과 출력 8k 토큰을 사용하고, 긴 에이전트 실행이 캐시되지 않은 입력 800k 토큰과 출력 40k 토큰을 사용한다고 가정합니다. 파일과 도구 결과가 다시 전송되므로 에이전트 세션은 입력 비중이 높습니다. 요금은 백만 토큰당 Kunavo 카탈로그의 현재 가격이며, 어느 클라이언트가 요청을 보내는지와 관계없이 동일하게 적용됩니다.

자사 수치와 규모를 비교해 보면, Anthropic의 자체 비용 문서는 "엔터프라이즈 배포 전반에서 평균 비용은 개발자 1명당 활동일 기준 하루 약 $13, 개발자 1명당 월 $150~250이며, 사용자의 90%는 활동일 기준 하루 비용이 $30 미만입니다"라고 보고합니다. 위의 가정에 따르면 $13은 Claude Sonnet 5에서 각각 $1.400 및 $0.266의 요금으로 대략 긴 실행 9회 또는 작은 작업 49회에 해당합니다. Anthropic의 수치는 자체 엔터프라이즈 배포에 한정되며 게이트웨이 견적이 아닙니다. 이 계산은 예측이 아니라 규모를 확인하기 위한 점검입니다. 캐싱에 따라 어느 방향으로든 크게 달라집니다. 프롬프트 캐싱을 참고하세요.

Kunavo의 카탈로그 금액은 상한이 아니라 청구 하한입니다. 업스트림이 요금을 보고하면 청구 금액은 카탈로그 비용과 업스트림 비용에 해당 마크업을 곱한 값 중 큰 금액입니다. 캐시 요금과 외부 도구는 이 예시에 포함되지 않습니다. 최소 충전 금액은 선불 크레딧 $10입니다. 이는 작업 요금이나 구독료가 아닌 자금 충전 최소 금액입니다. 결제 세부 정보를 참고하세요.

하나가 아닌 세 가지 비용 항목

사람들이 잘못 이해하는 비교는 "무료 클라이언트와 유료 클라이언트"입니다. 대신 예산을 나누어 보세요.

1. 모델 토큰. 두 제품에 동일한 질문을 사용하며 위 표에서 답을 확인할 수 있습니다. OpenHands Individual 플랜에서 사용량이 측정되는 것으로 보이는 유일한 항목이지만, 가격 페이지는 컴퓨팅 또는 샌드박스 비용에 대해 어느 쪽이든 명시적으로 설명하지 않습니다.
2. 샌드박스를 실행하는 컴퓨터. Claude Code의 문서화된 기본 경로에서는 에이전트와 기본 제공 Bash 샌드박스가 이미 보유한 워크스테이션에서 실행되므로 추가 컴퓨터가 필요하지 않습니다. 셀프 호스팅 OpenHands의 경우 비용은 0이 아니지만 공개되지 않았습니다. 문서에는 Docker, VM 및 원격 백엔드가 설명되어 있으나 비용 모델은 공개되어 있지 않으므로 자체 공급자의 요금으로 VM 시간, 저장 공간 및 샌드박스 컨테이너 실행 시간을 예산에 반영해야 합니다. 이 페이지에서는 수치를 임의로 만들지 않습니다.
3. 청구되는 계정. Claude 플랜, API 잔액 또는 Canvas에서 Claude Code를 실행하는 경로에서는 해당 컴퓨터가 로그인 정보를 보유한 두 계정 중 하나입니다.

일반적으로 사람들이 이동하는 방향에서는 둘 사이의 마이그레이션 비용이 낮습니다. Claude Code는 프로젝트 지침을 저장소 파일에 보관하므로 OpenHands를 시도하기 위해 무엇인가를 삭제할 필요가 없습니다. 또한 Canvas가 ACP를 통해 Claude Code를 구동할 수 있으므로 평가가 반드시 전환을 의미하지도 않습니다. 비용이 큰 방향은 팀을 셀프 호스팅 OpenHands로 표준화하는 경우입니다. 단일 사용자 제한과 직접 소유해야 하는 인프라 비용이 나타나는 곳이기 때문입니다.

경계를 정한 작업 하나로 시작하세요

어느 쪽을 선택하든 두 제품에서 동일한 작고 검증 가능한 변경을 실행하세요. 실패하는 테스트가 있는 버그를 동일한 커밋에서 별도의 작업 공간으로 수정하고, diff와 검토에 든 노력 및 계정에 실제로 기록된 비용을 기록하세요. 이 페이지에서 공급업체의 것이 아닌 사용자 자신의 비교는 이것뿐입니다.

사용량 측정 경로를 원한다면 Claude Code 통합 가이드에 Anthropic 형식 구성이 있고, Kunavo 계정 생성으로 키에 자금을 충전할 수 있습니다. 빠른 시작의 OpenAI 형식 값은 OpenHands의 Advanced 탭에서 요구하는 값입니다. 그래도 공급자가 아니라 클라이언트 중에서 결정하지 못했나요? OpenHands와 OpenCode 비교에서는 두 오픈 소스 표면을 비교하고, Claude Code 가격에서는 플랜 측면을 전체적으로 다루며, 구독 없이 Claude Code 사용에서는 게이트웨이 경로만 다룹니다.

자주 묻는 질문

저장소, 패키지 레지스트리, 가격 및 문서 출처를 2026년 9월 21일에 다시 확인했으며, 기반 조사는 2026년 9월 18일에 수집했습니다. 이 페이지를 위해 어느 클라이언트도 설치, 구성하거나 Kunavo 엔드포인트에 연결해 실행하지 않았습니다. 모든 구성 관련 주장은 문서에 근거하며 호환성 또는 성능 테스트는 수행되지 않았습니다. 두 에이전트에 대한 중립적인 벤치마크를 찾지 못했으므로 작업 성공률이나 속도 비교는 제공하지 않습니다. Kunavo 토큰 요금은 현재 카탈로그에서 가져왔으며 이 페이지의 모든 달러 예시는 예시용 토큰 계산입니다.