TAU-HOME.COM
LOADING

Claude Code 기반 로컬 취업 지원 자동화 프레임워크 ai-job-search

로컬 환경에서 Claude Code를 활용해 채용 공고 수집부터 적합도 평가, LaTeX 기반 이력서·자기소개서 작성, 모의 면접까지 수행하는 오픈소스 도구 ai-job-search의 구조와 안전한 설정법을 살펴봅니다.

tau · 2026년 11월 15일

#claude-code #ai-job-search #career #ai-agents #latex

Claude Code 기반 로컬 취업 지원 자동화 프레임워크 ai-job-search

취업 준비 과정은 채용 공고 탐색부터 기업별 맞춤 서류 작성, 면접 대비까지 수많은 반복 작업으로 이루어집니다. 오픈소스 커뮤니티에서 주목받는 ai-job-search는 Anthropic의 터미널 기반 에이전트 도구인 Claude Code를 활용해 이 전 과정을 사용자 로컬 컴퓨터 안에서 체계적으로 자동화하는 프레임워크입니다. 2026년 3월 처음 공개된 이 프로젝트는 번들 기준 스타 7만 1,500여 개와 포크 2만 3,100여 개를 기록하며 개발자들의 큰 관심을 모았고, 2026년 11월 9일 주간 정기 릴리스 체계를 갖춘 v1.7.5 버전을 배포했습니다.

ai-job-search 깃허브 저장소 다이어그램 및 Claude Code 기반 취업 지원 워크플로

이미지 출처: https://github.com/ai-job-search-dev/ai-job-search

기존 구직 플랫폼의 자동화 기능이나 웹 기반 생성형 AI 서비스는 개인의 경력 사항과 희망 연봉 같은 민감한 정보를 외부 서버에 직접 전송해야 하는 프라이버시 부담이 있었습니다. ai-job-search-dev 조직이 관리하는 이 프레임워크는 모든 프로필 데이터와 작성 서류를 사용자의 로컬 환경에 저장하면서, 터미널 명령어 몇 개로 구직 파이프라인 전체를 관리할 수 있도록 설계되었습니다.

프로필 구성부터 모의 면접까지 이어지는 6단계 명령어 체계

ai-job-search의 핵심은 Claude Code의 대화형 CLI(Command Line Interface, 명령어 인터페이스) 환경 안에서 슬래시(/) 명령어로 구동되는 6단계 워크플로입니다. 사용자가 직접 프롬프트를 일일이 작성할 필요 없이, 사전 정의된 역할과 검증 규칙에 따라 에이전트가 순차적으로 작업을 수행합니다.

  • /setup (프로필 구축): 사용자의 기본 이력 데이터를 정형화합니다. 기존 이력서 PDF, 졸업 증명서, 경력 증명서, 과거 지원서 등이 담긴 documents/ 폴더를 자동 스캔하거나, 단일 이력서 텍스트 입력, 또는 에이전트와의 질의응답 인터뷰를 통해 경력과 기술 스택 프로필을 생성합니다.
  • /scrape (채용 공고 검색): 연결된 채용 포털에서 사용자 프로필에 부합하는 공고를 탐색하고, 중복 데이터를 제거한 뒤 적합도 순으로 정리해 반환합니다. 이미 확인한 공고는 기록 파일에 보관되어 에이전트 컨텍스트 창을 불필요하게 낭비하지 않도록 설계되었습니다.
  • /rank (적합도 일괄 채점): 수집된 공고가 많을 때 각 공고의 요구 조건과 사용자 경력 사이의 정합성을 일괄 평가해 우선순위 목록을 도출합니다.
  • /apply (맞춤 서류 생성 및 컴파일): 지원할 공고 URL이나 텍스트를 입력하면 공고 분석, 이력서 및 자기소개서 초안 작성, 2차 에이전트 검토, 최종 LaTeX 문서 컴파일까지 단일 파이프라인으로 처리합니다.
  • /interview (면접 준비): 지원한 기업과 직무에 맞춘 예상 질문을 추출하고, 전형 단계별 모의 인터뷰를 진행하며 답변 피드백을 제공합니다.
  • /outcome (지원 결과 추적): 서류 합격, 면접 결과, 최종 합격 여부 등 전형 진행 상황을 기록해 전체 지원 퍼널을 관리합니다.

자기소개서 작성과 경력 적합도 판정을 담당하는 코어 파이프라인은 언어와 국가에 구애받지 않고 작동합니다. 기본 제공되는 채용 포털 검색 도구는 덴마크 시장(Jobindex, Jobnet 등)을 중심으로 설정되어 있으나, /add-portal 명령어를 이용해 사용자가 활동하는 지역의 채용 웹사이트 검색 스크립트를 추가할 수 있습니다.

실행 환경 구성과 2단계 에이전트 검증 파이프라인

프레임워크를 구동하려면 네 가지 핵심 환경이 로컬 머신에 갖추어져 있어야 합니다. 먼저 Claude Code CLI가 필요하며, 무료 티어를 제공하지 않으므로 유료 구독(Claude Pro/Max/Team)이나 Anthropic API 크레딧이 연동되어 있어야 합니다. 채용 포털 검색 CLI 도구를 실행하기 위한 자바스크립트 런타임 Bun, 내부 도구를 제어하기 위한 Python 3.10 이상 버전, 그리고 서류를 조판할 LaTeX 배포판(TeX Live, MacTeX, TinyTeX, MiKTeX 등)이 필수입니다.

문서 작성 과정에서 /apply 명령어가 작동하는 방식은 단순한 텍스트 생성을 넘어섭니다. 이력서(CV)는 lualatex 엔진으로 컴파일하고, 전용 스타일 클래스를 사용하는 자기소개서는 fontspec 패키지를 지원하는 xelatex 엔진으로 각각 나누어 빌드합니다. 이를 통해 글꼴 오류를 방지하고 고품질 PDF를 생성합니다. 선택 사항인 pypdf 라이브러리를 설치하면, 기업 채용 담당자가 사용하는 ATS(Applicant Tracking System, 지원자 추적 시스템)가 생성된 PDF에서 텍스트를 정상적으로 추출할 수 있는지 기계 판독성 검사까지 거칩니다.

또한 작성 단계에서는 초안을 작성하는 에이전트와 작성된 내용을 지원자 실제 경력 및 공고 요건과 대조해 교차 검증하는 검토 에이전트가 분리되어 동작합니다. 과장된 표현이나 지원자 프로필에 없는 허위 경력이 들어가지 않도록 통제하는 안전장치입니다.

공개 포크 금지와 비공개 복제(Private Clone) 원칙

ai-job-search를 사용할 때 가장 주의해야 할 부분은 깃허브 저장소 관리 방식입니다. GitHub 정책상 공개 저장소를 웹 인터페이스에서 일반 '포크(Fork)'하면 생성된 포크 저장소 역시 무조건 공개 상태로 유지됩니다.

프레임워크에서 /setup 명령어를 실행하면 사용자의 실명, 전화번호, 이메일, 세부 경력 사항, 희망 연봉이 담긴 설정 파일이 깃 추적 대상 파일로 생성됩니다. 만약 공개 포크 상태에서 이 파일들을 커밋하고 원격 저장소에 푸시하면 개인정보가 인터넷 전체에 노출되는 치명적인 프라이버시 사고가 발생할 수 있습니다.

따라서 오픈소스 코드 자체에 기여하려는 목적이 아니라 실제 구직 활동에 프레임워크를 활용하려는 사용자라면, GitHub CLI를 사용해 비공개 원격 저장소로 복제하는 방식을 반드시 따라야 합니다.

# 공식 저장소를 로컬로 클론
gh repo clone ai-job-search-dev/ai-job-search
cd ai-job-search

# 기존 origin 원격을 upstream으로 변경
git remote rename origin upstream

# 본인 계정에 비공개(private) 저장소를 생성하고 푸시
gh repo create ai-job-search --private --source=. --remote=origin --push
gh repo set-default <본인-깃허브-사용자명>/ai-job-search

# 포털 CLI 의존성 설치
python3 tools/install_portal_clis.py

이 방식을 취하면 개인 정보가 담긴 설정 파일은 본인만 열람할 수 있는 비공개 저장소에 안전하게 유지되면서, 공식 저장소의 최신 업데이트는 upstream 원격을 통해 지속적으로 동기화할 수 있습니다.

아울러 외부 채용 공고 본문은 신뢰할 수 없는 데이터로 취급해야 합니다. ai-job-search는 공고 웹페이지에 숨겨진 텍스트, 비가시 문자, 시스템 지시문 형태의 문장을 탐지하는 무결성 검증 단계를 갖추고 있으나, LLM을 조작하려는 간접 프롬프트 인젝션 공격을 완벽히 차단하는 가상 샌드박스는 아닙니다. 에이전트가 채용 공고를 분석해 서류를 완성하더라도, 지원서를 최종 제출하기 전 출력된 PDF 내용과 공고 원문을 사용자가 직접 검토하는 작업은 필수적입니다.

출처

Impact-Site-Verification: 9b3ebd10-6c45-44cf-a014-5b8c19b7b285