OpenHands SDK 시작 — 첫 소프트웨어 에이전트 만들기

OpenHands SDK 시작

OpenHands SDK는 코드·파일·시스템 명령과 상호작용하는 AI 에이전트를 만드는 모듈식 파이썬 프레임워크예요. 에이전트가 bash 명령 실행, 파일 편집, 웹 탐색 같은 도구를 쓰도록 조립하고, 대화를 통해 작업을 시키는 구조예요.

출처: https://docs.openhands.dev/sdk/getting-started

설치와 모델 키

먼저 LLM API 키를 얻고, SDK를 설치해요. 사용할 모델은 환경변수로 지정할 수 있어요.

export LLM_MODEL="openhands/claude-sonnet-4-5-20250929"

첫 에이전트

LLM·에이전트·대화를 만들고 도구를 연결한 뒤 메시지를 보내면 에이전트가 작업을 수행해요.

import os

from openhands.sdk import LLM, Agent, Conversation, Tool
from openhands.tools.file_editor import FileEditorTool
from openhands.tools.task_tracker import TaskTrackerTool
from openhands.tools.terminal import TerminalTool

llm = LLM(
    model=os.getenv("LLM_MODEL", "anthropic/claude-sonnet-4-5-20250929"),
    api_key=os.getenv("LLM_API_KEY"),
    base_url=os.getenv("LLM_BASE_URL", None),
)

agent = Agent(
    llm=llm,
    tools=[
        Tool(name=TerminalTool.name),
        Tool(name=FileEditorTool.name),
        Tool(name=TaskTrackerTool.name),
    ],
)

conversation = Conversation(agent=agent, workspace=os.getcwd())
conversation.send_message("Write 3 facts about the current project into FACTS.txt.")
conversation.run()

핵심 개념

Agent — 도구를 쓰며 추론·계획·실행하는 AI 개체
Tools — bash 실행, 파일 편집, 웹 탐색 같은 능력 단위
Workspace — 에이전트가 작업하는 실행 환경
Conversation — 에이전트와의 상호작용 수명주기 관리