AI Job Search: Claude Code 기반 로컬 구직 자동화 프레임워크

오픈소스 개발자 Mads Lorentzen이 공개한 'ai-job-search'는 Anthropic의 Claude Code CLI 환경을 기반으로 구직자의 로컬 머신에서 구직 전 과정을 직접 구동하는 오픈소스(MIT 라이선스) AI 구직 지원 프레임워크입니다. 클라우드 서비스에 이력서나 개인 식별 정보를 전송하지 않고, 사용자의 자체 로컬 워크스페이스에서 채용 공고 탐색부터 문서 작성, 면접 대비까지 완결하는 아키텍처를 표방합니다.

이미지 출처: MadsLorentzen/ai-job-search via GitHub

기존의 상용 온라인 취업 플랫폼이나 AI 서류 작성 서비스들은 사용자의 경력 사항, 희망 급여, 연락처 등 민감한 개인정보를 원격 서버에 저장해야 하는 프라이버시 부담이 있었습니다. 또한 일반적인 챗봇 프롬프트 방식은 채용 공고가 바뀔 때마다 동일한 이력 정보를 반복해서 입력해야 하는 번거로움이 있었습니다. ai-job-search는 사용자의 로컬 파일시스템에 프로필과 지원 이력을 구조화해 보관하면서, 전용 슬래시 명령어 인터페이스를 통해 구직 파이프라인의 각 단계를 자동화합니다.

Claude Code CLI 기반 전 과정 슬래시 명령어 파이프라인

ai-job-search는 Claude Code 터미널 환경에서 직관적으로 호출할 수 있는 단계별 전용 슬래시 커맨드를 제공하여 구직 활동의 시작부터 마감까지 유기적으로 연결합니다.

• /setup (프로필 및 기준 설정): 구직자의 기본 인적 사항, 상세 경력 기술서, 포트폴리오 요약, 희망 직무 및 목표 연봉 기준을 로컬 환경에 최초 등록하고 정형 데이터로 구조화합니다.
• /scrape (채용 공고 수집): 다중 채용 포털을 순회하며 설정된 조건에 부합하는 최신 채용 공고 원문을 스크래핑해 로컬 저장소로 수집합니다. 기본 번들된 스크래퍼는 덴마크 현지 구직 사이트를 기반으로 구성되어 있으나, 모듈형 CLI 구조로 설계되어 타 지역 포털 연동 확장이 가능합니다.
• /rank (적합도 평가 및 우선순위화): 수집된 공고 내용과 등록된 구직자 프로필을 대조 분석하여 기술 스택 일치도, 자격 요건 충족 여부, 경력 부합도를 산출하고 우선적으로 지원해야 할 공고 목록을 순위화합니다.
• /apply (맞춤형 지원서 및 서류 생성): 선별된 공고의 세부 직무 요구사항에 맞추어 강점을 부각하는 맞춤형 이력서(CV)와 커버레터를 자동으로 작성하고 조판합니다.
• /interview (면접 대비 모의 질의응답): 지원 대상 기업의 공고 내용과 생성된 지원서를 기반으로 예상 면접 질문을 도출하고, 기술 및 인성 면접에 대비할 수 있는 모의 인터뷰 시뮬레이션을 진행합니다.
• /outcome (지원 결과 추적 및 기록): 각 기업별 서류 접수일, 전형 진행 상황, 서류 통과 여부 및 피드백 결과를 체계적으로 기록하여 구직 파이프라인 전반을 관리합니다.

작성자-리뷰어 2인 에이전트 교정 루프와 LaTeX 기반 고품질 조판

이 도구의 핵심 기술적 차별점은 단순한 1회성 텍스트 생성을 넘어, 두 개의 독립적인 에이전트가 상호 검토하는 2단계 교정 루프와 전문 조판 엔진 연동에 있습니다.

• Drafter & Reviewer 2단계 협업 체계: 먼저 작성자(Drafter) 에이전트가 채용 공고 요건에 맞춰 초안을 작성하면, 이어 리뷰어(Reviewer) 에이전트가 공고 원문의 핵심 키워드 누락 여부, 문법적 완성도, 과장 표현, 논리적 연결성을 엄격히 대조 검토합니다. 피드백을 반영해 문안을 보정하는 루프를 거침으로써 AI 특유의 무미건조한 나열식 서술이나 환각(Hallucination) 위험을 줄입니다.
• LuaLaTeX 및 XeLaTeX 기반 전문 PDF 조판: 마크다운이나 일반 워드프로세서 서식 대신 전문 출판 조판 엔진인 LaTeX를 채택했습니다. 이력서(CV)는 LuaLaTeX 엔진으로, 커버레터는 XeLaTeX 엔진으로 각각 컴파일하여 서체 정렬과 시각적 완성도가 높은 전문 규격의 PDF 결과물을 출력합니다.
• 버전별 맞춤 서류 아카이빙: 지원한 공고마다 사용된 LaTeX 소스 코드와 최종 PDF 파일이 로컬 디렉터리에 버전별로 격리 보관되어, 서류 전형 통과 후 면접 단계에서 제출본을 정확히 복기할 수 있습니다.

환경 요구사항과 프라이빗 저장소 복제 등 실무 운영 시 주의사항

ai-job-search를 로컬 환경에 도입하여 원활하게 운용하려면 몇 가지 전제 조건과 보안 수칙을 사전에 점검해야 합니다.

• 런타임 및 컴파일 환경 요구: 시스템에 Python 3.10 이상과 Bun 런타임이 설치되어 있어야 하며, PDF 생성을 위해 LuaLaTeX 및 XeLaTeX 컴파일러를 포함하는 TeX 환경(TeX Live, MacTeX, TinyTeX 등)이 구비되어 있어야 합니다.
• Claude Code 라이선스 및 API 비용: Claude Code CLI는 무료 티어를 제공하지 않으므로, 정상 구동을 위해 Claude Pro/Max/Team 구독을 이용하거나 Anthropic API 크레딧이 충전된 계정이 필수적입니다.
• 프라이빗 저장소 복제 권장: GitHub의 오픈소스 저장소를 공개(Public) 상태로 직접 포크(Fork)할 경우, /setup 명령어를 실행할 때 입력된 실명, 연락처, 세부 경력, 희망 연봉 등의 민감 정보가 공개 커밋으로 외부에 노출될 위험이 있습니다. 반드시 프라이빗(Private) 저장소로 복제한 후 업스트림(Upstream)을 연결해 사용하는 방식이 강력히 권장됩니다.
• 공고 텍스트 주입 방어 및 최종 서류 검토: 수집된 외부 채용 공고 텍스트에 대해 프롬프트 인젝션 방어 규칙이 적용되어 있으나, 완전한 OS 샌드박스 격리가 이루어지는 것은 아니므로 생성된 지원 서류를 기업에 최종 발송하기 전에 구직자 본인의 육안 검토를 필히 거쳐야 합니다.

출처

• GitHub 저장소: MadsLorentzen/ai-job-search