ghuntley/how-to-build-a-coding-agent
Claude API를 기반으로 파일, 셸, 검색 도구를 하나씩 추가하며 코딩 에이전트를 만드는 과정을 알려주는 단계별 Go 워크숍입니다.
- 스타
- 5,907
- 포크
- 668
- 열린 이슈
- 8
- 마지막 커밋
- 3일 전
어떤 프로젝트인가요?
Go로 나만의 AI 코딩 어시스턴트를 만드는 실습형 워크숍입니다. Anthropic API를 통해 Claude와 대화하는 기본 챗봇부터 시작해 파일 읽기, 디렉터리 목록 조회, 셸 명령 실행, 파일 수정, ripgrep을 이용한 코드 검색 도구를 차례로 추가합니다.
각 단계는 chat.go, read.go, edit_tool.go 같은 독립 실행형 Go 프로그램으로 제공되어, 모든 버전을 직접 실행하고 비교할 수 있습니다. 사용자 입력을 모델에 전달하고, 도구 호출을 실행한 뒤 결과를 다시 보내 Claude가 최종 답변을 내놓을 때까지 이어지는 핵심 이벤트 루프를 설명합니다. 또한 도구 이름과 Go 구조체에서 생성한 입력 스키마, 함수로 도구를 정의하는 방법도 다룹니다.
Cline, Cursor, Claude Code 같은 에이전트의 내부 동작을 이해하려는 개발자를 위한 프로젝트이며, 실행하려면 Anthropic API 키가 필요합니다.
핵심 기능
- 01Go로 코딩 에이전트의 발전 단계를 담은 여섯 가지 버전을 만듭니다.
- 02기본 채팅 루프로 Anthropic Claude API에 연결합니다.
- 03파일 읽기, 디렉터리 목록 조회, 셸 명령 실행, 파일 수정, 코드 검색 도구를 제공합니다.
- 04Go 구조체에서 도구 입력 스키마를 생성합니다.
- 05자세한 로그를 확인할 수 있는 verbose 모드와 실험용 샘플 파일을 제공합니다.
활용 사례
- Cline이나 Cursor 같은 AI 코딩 에이전트의 내부 동작을 학습합니다.
- 직접 만든 도구를 사용하는 로컬 개발자 어시스턴트를 구축합니다.
- Go 개발자에게 LLM tool calling의 기초를 가르칩니다.
빠른 시작
- 1
devenv 개발 환경에 진입합니다(권장).
devenv shell - 2
또는 Go 종속성을 수동으로 설치합니다.
go mod tidy - 3
Anthropic API 키를 환경 변수로 설정합니다.
export ANTHROPIC_API_KEY="your-api-key-here" - 4
기본 채팅 프로그램을 실행합니다.
go run chat.go
사용 전 알아둘 점
- Claude를 사용하려면 유료 Anthropic API 키가 필요합니다.
- 저장소에 라이선스가 지정되어 있지 않습니다.
토픽
자주 묻는 질문
- how-to-build-a-coding-agent은(는) 무엇인가요?
- Claude API를 기반으로 파일, 셸, 검색 도구를 하나씩 추가하며 코딩 에이전트를 만드는 과정을 알려주는 단계별 Go 워크숍입니다. Go로 나만의 AI 코딩 어시스턴트를 만드는 실습형 워크숍입니다. Anthropic API를 통해 Claude와 대화하는 기본 챗봇부터 시작해 파일 읽기, 디렉터리 목록 조회, 셸 명령 실행, 파일 수정, ripgrep을 이용한 코드 검색 도구를 차례로 추가합니다.
- how-to-build-a-coding-agent은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- how-to-build-a-coding-agent에는 명시된 라이선스가 없습니다. 코드는 공개되어 있지만 라이선스가 없으면 재사용 허가가 명확하지 않으므로, 사용 전에 작성자에게 문의하는 것이 좋습니다.
- how-to-build-a-coding-agent은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. how-to-build-a-coding-agent의 마지막 커밋은 2026년 10월 17일입니다.
- how-to-build-a-coding-agent은(는) 어디에 사용할 수 있나요?
- Cline이나 Cursor 같은 AI 코딩 에이전트의 내부 동작을 학습합니다. 직접 만든 도구를 사용하는 로컬 개발자 어시스턴트를 구축합니다. Go 개발자에게 LLM tool calling의 기초를 가르칩니다.
- how-to-build-a-coding-agent는 어떻게 설치하나요?
- devenv 개발 환경에 진입합니다(권장).: devenv shell 또는 Go 종속성을 수동으로 설치합니다.: go mod tidy Anthropic API 키를 환경 변수로 설정합니다.: export ANTHROPIC_API_KEY="your-api-key-here" 기본 채팅 프로그램을 실행합니다.: go run chat.go
- how-to-build-a-coding-agent은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ghuntley/how-to-build-a-coding-agent
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
프롬프트로 Blender에서 3D 씬을 만들고 수정하고 살펴보는 Blender 애드온 및 MCP 서버
질문을 계획하고 웹·로컬 자료를 수집해 인용이 포함된 보고서를 작성하는 오픈소스 자율 연구 에이전트
AI 에이전트가 실제 작업을 수행하도록 Docker 기반 Linux 데스크톱, 브라우저, 문서 도구를 제공하는 오픈 에이전트 프레임워크
Go로 LLM 애플리케이션과 AI 에이전트를 구축하기 위한 프레임워크로, 조합 가능한 컴포넌트, 그래프 오케스트레이션, 휴먼 인 더 루프 인터럽트를 지원합니다.
LLM 애플리케이션을 만드는 Rust 라이브러리와, Bevy 플러그인으로 구성된 터미널 코딩 에이전트입니다.