
Zero Setup AI Coding with OpenHands
All Hands AI · 코딩
OpenHands는 소프트웨어 엔지니어링 에이전트를 위한 오픈소스 플랫폼이다. 브라우저, 터미널, SDK에서 코딩 에이전트를 돌리며, 클라우드 버전은 아무것도 설치할 필요가 없다.

Zero Setup AI Coding with OpenHands 소개
What Is OpenHands
OpenHands는 소프트웨어 엔지니어링 에이전트를 돌리는 오픈소스 플랫폼이다. 저장소를 읽고, 파일을 고치고, 테스트를 돌리고, 스스로 pull request를 여는 부류의 AI를 말한다. 같은 에이전트를 네 가지 방식으로 쓴다. 브라우저의 Agent Canvas, 터미널 명령 인터페이스, 자체 도구에 에이전트를 넣는 Python SDK, 그리고 사내 네트워크 안에서 돌리는 엔터프라이즈 버전이다.
겨냥하는 문제는 AI 코딩 에이전트가 흔히 데려오는 설치 부담이고, 설치 없는 AI 코딩이 바로 그 핵심이다. 로컬에서 돌리려면 보통 첫 문장을 보내기 전에 Docker를 깔고 LLM 키를 설정하고 샌드박스를 준비해야 한다. OpenHands Cloud는 그 대부분을 건너뛴다. 웹 앱에 로그인하고, 에이전트를 저장소로 향하게 하고, 대화를 시작하면 된다. 모든 일이 관리형 샌드박스에서 일어나므로 개인 노트북이 등장할 일은 드물다. 오픈소스 코어는 여전히 MIT 라이선스라, 클라우드에서 도는 같은 소프트웨어를 읽고, 직접 호스팅하고, 고칠 수 있다.
고정된 기능이 아니라 범용 에이전트이므로 폭이 넓다. 버그 수정, 테스트, 리팩터링, 의존성 업그레이드, 코드 리뷰, 레거시 이전까지 다룬다. 가장 큰 한계는 건네는 작업 자체에 있다. 모호한 지시와 여러 파일에 걸친 대규모 재작성은 여전히 쪼개야 하고, 운영 코드를 건드리는 변경은 내보내기 전에 사람이 봐야 한다.
Getting Started
- OpenHands Cloud 웹 앱을 열고 로그인한다. 터미널이 좋다면 OpenHands CLI를 설치한다.
- GitHub, GitLab, Bitbucket 연동으로 저장소를 연결하거나, 에이전트를 로컬 워크스페이스로 향하게 한다.
- 키로 LLM을 추가하거나, 에이전트형 코딩 모델을 제공하는 OpenHands 프로바이더를 쓰고, 에이전트 프로파일을 고른다.
- 동료에게 부탁하듯 작업을 적는다. 무엇을 바꾸고, 관련 파일이 어디에 있고, 무엇이 되면 성공인지 밝힌다.
- 에이전트의 diff를 확인하고, 제안한 테스트를 돌리고, 열린 pull request를 병합한다.
제품 정보
Zero Setup AI Coding with OpenHands의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.
추천 대상
이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.
사용자
- 아무것도 설치하지 않고 오픈소스 코딩 에이전트를 써보려는 개발자. 클라우드 버전은 관리형 샌드박스에서 돌아가므로 브라우저 로그인이 설정의 전부다.
- 개인 개발자와 작은 팀. MIT 라이선스 코어는 무료로 직접 호스팅할 수 있어, 저장소를 맡기기 전에 코드를 읽고 싶은 사람에게 맞는다.
- 플랫폼 엔지니어와 개발자 경험 담당자. OpenHands SDK는 Python 라이브러리가 되어, 소프트웨어 엔지니어링 에이전트를 자사 제품에 넣는 팀에 어울린다.
- 큰 회사의 기술 리드. OpenHands Enterprise는 제어 평면을 갖춰 VPC 안에서 돌아가므로, 보안팀 승인이 필요한 상황에서 힘을 발휘한다.
작업
- 재현 절차가 명확한 버그 수정. 에이전트가 오류를 읽고, 코드를 따라가고, 수정을 쓰고, 테스트를 더한다. 범위가 분명한 문제에 잘 맞는다.
- 테스트 커버리지 보강. 기존 코드가 곧 명세라, 관례를 따르는 단위 테스트와 통합 테스트를 쓴다.
- 의존성 업그레이드. 라이브러리를 바꾸고, 호환성 깨짐을 처리하고, 전체 테스트를 돌려 아무것도 깨지지 않았는지 확인한다.
- pull request 리뷰. 자동 리뷰어가 diff에 코멘트를 달아, 사람이 파일을 열기 전에 문제를 잡는다.
- 레거시 코드 현대화. COBOL 같은 옛 시스템을 문서화하고 이전해, 전문 인력이 떠나는 팀을 돕는다.
- 인시던트 분류. 로그와 모니터링 데이터를 읽어 유력한 원인을 짚어, 수정에 착수하기까지의 시간을 줄인다.
활용 상황
- 몇 분 만에 코딩 에이전트 시작. 로그인하고 저장소를 연결하고 대화를 시작한다. 로컬 Docker는 필요 없다.
- 저장소를 오래 깔끔하게 유지. 예약된 자동화가 의존성 업그레이드나 테스트 보강 같은 반복 작업을 맡는다.
- 낯선 코드에 대한 질문 해결. 에이전트가 저장소를 살피고, 손대기 전에 그 부분이 어떻게 돌아가는지 설명한다.
- 자율 코딩을 팀으로 확장. 조직 워크스페이스가 자동화를 공유하고 사용량을 추적해, 여러 사람이 같은 토대에서 일한다.
주요 기능
브라우저 UI Agent Canvas
Agent Canvas는 OpenHands의 대화와 자동화를 다루는 브라우저 클라이언트이자 제어 중심이다. 세션을 열고, 에이전트가 일하는 모습을 단계별로 보고, 다른 길을 시험하고 싶으면 이전 메시지에서 갈라져 나온다. 로컬, 자체 호스팅, 클라우드, 엔터프라이즈 백엔드에 연결되므로 같은 화면이 어떤 구성에서도 따라온다. 로컬 설치를 피하려는 사람에게 가장 빠른 입구다.
로컬 설치 없는 클라우드
OpenHands Cloud는 샌드박스 작업을 덜어내는 관리형 서비스다. 호스팅 실행, 연동, 접근 제어, 예산 관리는 OpenHands 인프라에서 도므로, 저장소를 연결하면 바로 시작된다. 사용량 보고서와 지출 한도가 팀이 커질수록 비용을 지켜본다. Docker를 깐 뒤가 아니라 오늘 에이전트를 일하게 하려는 사람을 위한 선택이다.
소프트웨어 에이전트 SDK
OpenHands SDK는 코드를 다루는 에이전트를 만들기 위한 조합 가능한 Python 라이브러리다. 추론 루프, 도구, 대화, 워크스페이스를 재사용 부품으로 제공하고, 같은 저장소에 Agent Server도 들어 있다. REST와 WebSocket API로 에이전트 실행을 노출한다. 자사 제품을 만드는 팀은 루프를 처음부터 짜지 않고 에이전트형 개발을 넣을 수 있다. 사용자 정의 도구와 파일로 정의한 하위 에이전트로, 다시 쓰지 않고 넓힌다.
스킬과 재사용 지침
스킬은 구조화된 지침으로 에이전트에 전문화된 행동을 준다. 키워드, 파일 경로, 저장소 자체가 방아쇠가 된다. 매 세션 같은 지침을 되풀이하는 대신, 팀이 코드를 어떻게 리뷰하고 라이브러리를 어떻게 올리는지를 한 번 스킬로 써둔다. 사용자 간에 공유하는 전역 스킬과 조직 수준 스킬이 정책을 일관되게 유지한다. 범용 에이전트를 사내 규칙을 따르는 에이전트로 바꾸는 층이다.
자동화와 연동
자동화는 일정이나 이벤트로 에이전트 작업을 띄우고, OpenHands는 GitHub, Slack, Jira에 연결돼 무슨 일이 생기면 맞는 에이전트가 작동한다. 이슈가 열리면 에이전트가 집어 들고, 일을 끝내고, pull request를 올린다. 전부 기록되고, 수동 세션과 같은 비용과 보안 정책을 따른다. 자동화 QA 테스트는 diff를 읽는 데 그치지 않고 소프트웨어를 실제로 돌린다. 이벤트에서 pull request로 가는 이 길이 반복 작업을 개인에게 떨어지지 않게 하는 지점이다.
엔터프라이즈 제어 평면
OpenHands Enterprise는 에이전트를 대규모로 돌리는 팀을 위한 거버넌스 층을 더한다. Kubernetes로 VPC 안에 직접 설치하고, RBAC, LLM 게이트웨이, 예산, 관측성을 갖추며, 모두 소스를 구할 수 있다. 어떤 모델이 돌고, 어떤 데이터를 건드리고, 누가 작업을 시작할 수 있는지를 직접 쥔다. 규제를 받는 팀에게 이 통제는 시범 도입과 전사 확산의 차이다.
모델 유연성과 로컬 LLM
OpenHands는 LiteLLM이 지원하는 모든 모델에 연결한다. OpenAI, Anthropic, Google, AWS Bedrock, Azure, Groq, OpenRouter 등이 포함된다. Ollama, vLLM, LM Studio 같은 로컬 서버로 향하게 하거나, 에이전트형 코딩 모델을 제공하는 OpenHands 프로바이더를 쓸 수도 있다. LLM 프로파일로 대화 도중에 모델을 바꾸거나, 값싼 작업을 더 작은 모델로 보낼 수 있다. 데이터 규칙이나 예산 때문에 단일 벤더에서 벗어나야 할 때 이 폭이 의미를 갖는다.
장단점
장점
- 클라우드 버전은 로컬 설치를 건너뛰어, 브라우저 로그인만으로 코딩 에이전트가 일을 시작한다.
- 오픈소스 코어는 MIT 라이선스라, 저장소를 맡기는 코드를 읽거나 직접 호스팅하려는 팀에 맞는다.
- 한 에이전트가 브라우저, 터미널, Python SDK를 아우르므로 취향에 따라 골라 쓴다.
- LiteLLM 호환이면 로컬 모델까지 연결돼, 벤더 종속을 낮게 유지한다.
- GitHub, Slack, Jira 연동으로 에이전트가 이벤트로 작동하고, 중간에 사람 없이 pull request를 연다.
단점
- 코딩 에이전트는 명확하고 범위가 정해진 작업을 필요로 해서, "더 낫게 만들어" 같은 모호한 목표는 멈추고 작업을 쪼개야 한다.
- 긴 세션과 아주 큰 코드베이스는 시간과 컨텍스트 한도에 부딪혀, 큰 작업은 나눠야 한다.
- 엔터프라이즈 제어 평면은 유료 자체 호스팅 제품이라, 거버넌스를 찾는 작은 팀은 더 큰 약속을 진다.
- 에이전트는 프런트엔드 시각 확인과 끝까지 실행할 수 없는 작업에 약해, 그런 곳은 여전히 사람 확인이 필요하다.
자주 묻는 질문
OpenHands는 소프트웨어 엔지니어링 에이전트를 위한 오픈소스 플랫폼이다. 코딩 에이전트가 저장소를 읽고, 파일을 고치고, 테스트를 돌리고, pull request를 열게 한다. 브라우저, 터미널, Python SDK로 쓴다.
관련 콘텐츠
Zero Setup AI Coding with OpenHands와 관련된 도구, 스킬, 아티클을 살펴보세요.
Zero Setup AI Coding with OpenHands 대안
Base Code
Base44 (Wix) · 코딩 · 생산성Base Code는 Base44가 만든 공유 클라우드 개발 환경이다. 팀은 기존 GitHub 저장소에 대한 변경을 채팅으로 설명하고, 미리보기로 확인한 뒤 풀 리퀘스트로 돌려보낸다.
Google EmbeddingGemma 2
Google DeepMind · 글쓰기 · 이미지 · 코딩Google EmbeddingGemma 2는 7억 4000만 파라미터의 오픈 모델로, 텍스트와 코드, 이미지, 오디오, 영상 프레임을 하나의 768차원 공간에 벡터로 바꿔 스마트폰과 노트북에서 실행한다.
GitGlow
GitGlow · 코딩 · 생산성GitGlow는 내 코드와 AI 에이전트의 변경을 한 리뷰에 모으는 데스크톱 Git 클라이언트다. 배포 전에 내 기계에서 무엇이 나가는지 확인할 수 있다.
