본문으로 건너뛰기
공원나연조회 2

AI 에이전트 개발을 위한 실습 환경 구축 가이드

AI 에이전트 실습을 위해 VS Code에서 GitHub 코드를 복제하고 uv를 활용해 고속으로 가상환경 및 패키지를 세팅하는 방법을 안내한다.

챕터별 상세

00:59

실습 코드 확인 및 GitHub 저장소 소개

실습에 필요한 모든 소스 코드가 포함된 GitHub 저장소(hanbit-aiagent) 구조를 확인한다. README 파일을 통해 프로젝트 구성, 실행 방법, 필요한 Python 버전(3.11 이상) 등의 요구사항을 파악한다. 저장소에는 각 챕터별 에이전트 구현 코드와 MCP, A2A 실전 프로젝트 내용이 포함되어 있다.
01:50

VS Code에서 Git Clone 진행하기

VS Code의 터미널을 열고 git clone 명령어를 사용하여 원격 저장소의 코드를 로컬 디렉토리로 복제한다. 이 과정을 진행하기 위해서는 시스템에 Git이 사전에 설치되어 있어야 하며, 설치되지 않은 경우 Git 공식 홈페이지에서 설치가 필요하다. 복제가 완료되면 VS Code 탐색기에서 챕터별로 구분된 폴더 구조를 볼 수 있다.

Git은 소스 코드의 버전 관리를 위한 도구로, 원격 저장소의 데이터를 로컬로 가져오는 데 필수적이다.

bash
git clone https://github.com/gongwon-nayeon/hanbit-aiagent.git

GitHub 저장소의 실습 코드를 로컬로 복제하는 명령어

03:11

uv를 활용한 고속 패키지 설치 및 가상환경 세팅

Python 패키지 관리 도구인 uv를 설치하고 이를 통해 실습 환경을 구축한다. uv sync 명령어를 실행하면 pyproject.toml 파일에 명시된 의존성 패키지들을 버전에 맞춰 자동으로 설치한다. uv는 기존 pip 방식보다 속도가 월등히 빠르며 가상환경 생성과 패키지 관리를 통합하여 수행한다. 설치 완료 후 가상환경 활성화 명령어를 통해 실습 준비를 마친다.

uv는 최근 Python 생태계에서 주목받는 Rust 기반의 패키지 매니저로, 속도와 일관성 측면에서 강점이 있다.

bash
uv sync

uv를 사용하여 프로젝트에 필요한 패키지를 자동으로 설치하고 동기화하는 명령어

05:32

환경 변수 및 API 키 설정

AI 모델 호출에 필요한 OpenAI API 키 등을 설정하기 위해 .env 파일을 생성한다. 제공된 .env.example 파일을 복사하여 .env 파일을 만들고, 그 안에 본인의 API 키를 입력한다. 이렇게 설정된 환경 변수는 코드 실행 시 자동으로 로딩되어 에이전트가 LLM 서비스와 통신할 수 있게 한다. 타빌리(Tavily) 검색 API 등 추가 리소스 키도 동일한 방식으로 관리한다.

.env 파일은 API 키와 같은 보안 정보를 코드와 분리하여 안전하게 관리하기 위해 사용된다.

bash
copy .env.example .env

환경 변수 설정을 위해 예시 파일을 실제 .env 파일로 복사하는 명령어

용어 해설

uv
Rust로 작성된 매우 빠른 Python 패키지 및 프로젝트 관리 도구이다. 기존 pip나 conda보다 월등히 빠른 속도로 패키지를 설치하고 가상환경을 구축하며, 프로젝트의 의존성을 일관되게 관리할 수 있도록 돕는다.
깃 클론(Git Clone)
원격 저장소(GitHub 등)에 있는 소스 코드와 모든 변경 이력을 로컬 컴퓨터로 복제하는 명령어이다. 이를 통해 개발자는 오픈소스 프로젝트나 협업 중인 코드를 자신의 환경으로 가져와 실습하거나 수정할 수 있다.
환경 변수(Environment Variable)
운영체제나 실행 환경에서 프로세스가 참조하는 동적인 값이다. AI 개발에서는 API 키와 같은 민감한 정보를 코드에 직접 노출하지 않고 안전하게 관리하기 위해 .env 파일 등을 통해 설정한다.
AI 분석 전체 내용 보기

AI 요약 · 북마크 · 개인 피드 설정 — 무료

출처 · 인용 안내

원문 발행 2026. 05. 04.수집 2026. 05. 04.출처 타입 YOUTUBE

인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.