ai-job-search: 클로드 코드 구직 자동화, 한국에서 써도 될까
깃허브 인기 순위를 보다가 숫자 하나에 멈췄어요. 구직용 도구 하나가 별 5만 개를 넘겼더라고요. 이름은 ai-job-search. 클로드 코드에 공고를 넣으면 나한테 맞는지 점수를 매기고, 이력서와 커버레터를 공고에 맞춰 고쳐 쓰고, 면접 준비까지 해 준다는 오픈소스예요. 한국어 자료는 아직 거의 없어서, 공식 저장소 README와 깃허브 정보를 2026년 10월 18일에 직접 확인해 “한국에서 쓰면 어디서 막히는지”까지 정리해 봤어요.

ai-job-search, 정체가 뭔가요
저장소 설명을 그대로 옮기면 “내 컴퓨터에서 돌아가는 구직”이에요. 클로드 코드(Anthropic의 터미널용 AI 코딩 도구) 위에 명령어·스킬·템플릿을 얹어서, 구직 과정을 하나의 작업 흐름으로 묶어 놓은 틀이에요. 별도 웹사이트나 가입 절차는 없고, 저장소를 내 컴퓨터로 복사해서 클로드 코드로 여는 방식이에요.

깃허브 API 기준으로 별 50,157개, 포크 16,896개이고 라이선스는 MIT예요. 2026년 3월에 처음 올라왔고, 최신 버전은 9월 29일에 나온 v1.7.2예요. README 첫머리에 “Anthropic과 관계없는 독립 프로젝트”라고 분명히 적혀 있고, 관련 코인이나 유료 후원 프로그램도 없으니 그런 걸 내세우면 사기로 보라는 경고도 붙어 있어요. 이름이 알려지면 꼭 이런 게 따라붙죠.
이렇게 뜬 이유는 제작자 이야기 덕이 커요. 지구물리학을 전공한 Mads Lorentzen이 2025년 말 일자리를 잃고 자기 구직용으로 이걸 만들었고, 맞춤 지원서 69건, 1차 면접 20건, 계약 1건을 거쳐 2026년 6월 AI 엔지니어로 입사했다고 README에 적었어요. 면접관들에게도 이 도구를 쓴다고 밝혔는데 오히려 기술 이야기가 오가는 계기가 됐다고요. 다만 이건 제작자 한 사람의 경험이에요. 이걸 쓴다고 면접률이 그만큼 나온다는 보장은 어디에도 없어요.

세 명령으로 돌아가는 구조
핵심은 /setup → /scrape → /apply 세 단계예요. /setup은 내 프로필을 만드는 단계로, documents 폴더에 넣어 둔 이력서 PDF·링크드인 내보내기·졸업장 같은 자료를 읽거나, 이력서 하나를 대화창에 붙여 넣거나, 질문에 하나씩 답하는 방식 중에 고를 수 있어요. /scrape는 구인 사이트를 뒤져 내 프로필과 맞는 공고를 적합도 순으로 보여 주고, 공고가 많으면 /rank로 한꺼번에 점수를 매겨 추린 목록을 받을 수 있어요.

제일 공을 들인 건 /apply예요. 공고 주소나 공고 본문을 넣으면 ① 공고를 읽고 ② 기술·경력·문화·지역·커리어 방향으로 적합도를 평가한 다음 ③ LaTeX(조판 프로그램)로 맞춤 이력서와 커버레터 초안을 써요. 그다음이 재미있는데, ④ 새 대화로 띄운 검토 에이전트가 회사를 조사하고 초안을 비판하면 ⑤ 그걸 받아 고쳐요. 마지막으로 PDF를 실제로 만들어 이력서는 정확히 2쪽, 커버레터는 1쪽이 되도록 다듬고, 채용 시스템(ATS)이 PDF 글자를 제대로 읽어 가는지까지 확인해요.

README가 여러 번 강조하는 원칙이 하나 있어요. 이력서와 커버레터의 모든 내용은 내 프로필에 있는 것만 쓰고, 없는 경력이나 기술은 지어내지 않는다는 거예요. 공고에 있는 키워드라도 내 프로필이 뒷받침하지 못하면 “부족한 점”으로 남겨 두고 억지로 끼워 넣지 않는대요.
그 밖에 명령이 10개 더 있어요. /interview는 실제로 낸 이력서·커버레터를 바탕으로 예상 질문과 모의 면접을 준비해 주고, /outcome은 서류 결과·면접 단계를 기록하고 연락이 끊긴 지원 건에 보낼 후속 메일 초안을 만들어요(보내지는 않고 초안만). /gmail-sync는 지메일에서 면접 안내·불합격 메일을 찾아 기록을 바꿀지 물어보고, /upskill은 내가 노리는 공고들과 내 프로필의 차이를 보고 공부 계획을 짜 줘요.

시작하려면 뭐가 필요할까
여기서 먼저 걸러지는 분이 꽤 있을 거예요. README에 적힌 준비물은 클로드 코드, Python 3.10 이상, Bun(구인 사이트 검색 도구용 자바스크립트 실행기), 그리고 lualatex·xelatex가 들어 있는 LaTeX 배포판(TeX Live, MiKTeX 등)이에요. 무엇보다 클로드 코드는 무료 플랜이 없어요. Pro·Max·Team 구독이나 Anthropic API 크레딧이 있어야 하고, README는 가끔 쓰는 정도면 쓴 만큼 내는 API가 대체로 더 싸다고 적어 놨어요. 코덱스·제미나이 CLI 같은 다른 에이전트 도구용 안내(AGENTS.md)도 있지만, 전체 흐름은 클로드 코드 기준이에요.

설치 순서는 저장소 복사 → python3 tools/install_portal_clis.py로 검색 도구 설치 → claude 실행 후 /setup이에요. 그런데 첫 단계에 README가 굵게 경고해 둔 게 있어요.
공개 저장소를 포크하면 그 포크도 항상 공개예요.
/setup은 이름·연락처·경력·희망 연봉을 저장소에 기록되는 파일에 써요.
즉 아무 생각 없이 “Fork” 버튼을 누르고 프로필을 채운 뒤 올리면 내 이력이 인터넷에 그대로 공개될 수 있어요. 내 구직용이라면 포크하지 말고 비공개 저장소를 따로 만들어 이 저장소를 upstream으로 연결하라는 게 README 안내예요(SETUP.md 8장). 포크가 1만 6천 개가 넘는다는 걸 생각하면 실수로 공개한 사람도 있겠다 싶어서, 이 부분은 꼭 짚고 싶었어요.

한국에서 쓰면 어디서 막히나
README는 프로필 작성·적합도 평가·초안-검토 흐름이 “언어와 나라를 가리지 않는다”고 해요. 하지만 그대로 받아서 한국 구직에 쓰기엔 걸리는 게 몇 가지 있어요.

첫째, 구인 사이트 검색 도구가 덴마크용이에요. 기본으로 들어 있는 건 Jobindex·Jobnet·Jobdanmark·Akademikernes Jobbank 네 곳에, 나라와 상관없이 쓰는 링크드인 공개 공고 검색과 freehire.me(해외 개발 직군 모음) 정도예요. 링크드인 검색도 README가 “링크드인 이용약관에 어긋나는 자동 접근이니 개인용으로, 적게 쓰라”고 적어 뒀어요. 국내 사이트를 쓰려면 /add-portal에 사이트 주소를 주고 검색 도구를 새로 만들게 해야 하는데, 로그인해야 볼 수 있는 사이트는 만들지 않는다고 해요. 10월 18일 제가 본 커뮤니티 포크 목록(토론 #78) 첫 화면에선 한국 사이트용 포크는 찾지 못했어요.

둘째, 서류 양식이에요. 이력서는 moderncv라는 영문 LaTeX 템플릿으로 2쪽, 커버레터는 1쪽에 맞추게 돼 있고, 커버레터 기본 글꼴인 Lato·Raleway에는 한글 글자가 없어요. 한글 이력서를 원하면 /add-template으로 한글 글꼴을 쓰는 템플릿을 따로 등록해야 해요. 그리고 우리나라 공채에서 흔한 “문항별 자기소개서”용 틀은 들어 있지 않아요. 외국계나 해외 지원처럼 영문 이력서·커버레터를 내는 경우가 이 도구와 가장 잘 맞아요.
제 생각엔 한국 구직자에게 당장 쓸모 있는 건 /scrape보다 /apply예요. 공고 본문을 직접 붙여 넣어도 되니까, 사람인이든 원티드든 마음에 드는 공고를 복사해서 적합도 평가와 서류 초안·검토만 받아 보는 식으로 쓰면 구인 사이트 연결 문제는 비켜 갈 수 있어요. 물론 이건 README에 적힌 기능을 조합해 본 제 판단이고, 한글 공고로 직접 돌려 본 결과는 아니에요.
써 보기 전에 짚을 보안 문제
구직 도구는 내 이름·연락처·경력·연봉이 다 들어가는 도구예요. README도 이 점을 꽤 진지하게 다뤄요. 공고는 “믿을 수 없는 입력”으로 취급해서 공고 안에 숨겨진 지시를 따르지 않고 공고 속 링크도 열지 않게 해 뒀지만, 이건 지시문 수준의 방어일 뿐 샌드박스(격리 실행)가 아니니 낯선 사이트 공고라면 보내기 전에 결과를 한 번 훑어보라고 해요.
다른 사람이 만든 포털 스킬을 가져올 때도 마찬가지예요. 이 스킬들은 설정 파일(.claude/settings.json)에서 미리 허용돼 있어서 매번 묻지 않고 실행돼요. 그래서 README는 코드를 전부 읽고, 네트워크 요청이 그 구인 사이트로만 가는지, package.json에 의존성이나 설치 스크립트(postinstall 등)가 없는지, 자기 폴더 밖을 건드리지 않는지 확인하라고 해요. 자동 설치 기능을 일부러 안 만든 것도 “직접 코드를 읽는 단계”를 건너뛰지 않게 하려는 보안 판단이라고 적혀 있어요.

클로드 코드에 플러그인이나 스킬을 붙이는 방식이 낯설다면 앞서 쓴 클로드 코드 공식 플러그인 사용법과 클로드 코드 사용법 총정리를 먼저 보시면 이 저장소 구조가 훨씬 쉽게 읽혀요.
누구에게 맞을까
이런 분께 맞아요. 클로드 코드를 이미 유료로 쓰고 있고, 터미널과 깃 정도는 다룰 줄 알고, 영문 이력서로 외국계·해외 회사에 여러 곳 지원해야 하는 분이요. 공고마다 이력서를 고쳐 쓰는 일을 덜고, 지원 기록과 후속 연락까지 한곳에서 관리할 수 있어요. 처음 써 본다면 README에 링크된 사용 영상(2026년 8월 녹화라 명령이 조금 바뀌었을 수 있대요)을 먼저 보는 걸 권해요.

반대로 국내 공채 자기소개서를 주로 쓰거나, 클로드 코드를 써 본 적이 없거나, 설치 과정 자체가 부담스럽다면 지금은 굳이 맞출 필요가 없어요. LaTeX 설치부터 비공개 저장소 설정까지 넘어야 할 단계가 꽤 많거든요.
개인적으로는 이 저장소에서 “없는 경력은 쓰지 않는다”, “검토 에이전트를 따로 둔다” 같은 규칙이 제일 인상 깊었어요. AI로 서류를 쓰는 사람은 이미 많은데, 결국 차이는 이런 원칙에서 나는 것 같거든요. 혹시 한국 구인 사이트용으로 고쳐 쓰는 포크가 나오면 이어서 소개해 볼게요. 여러분은 AI로 이력서를 고쳐 본 적 있으세요?
클로드 코드 관련 다른 글은 클로드 코드 태그에 모아 두고 있어요.
출처
· MadsLorentzen/ai-job-search 깃허브 저장소·README
· ai-job-search 릴리스 (v1.7.2, 2026년 9월 29일)
· Community forks & adaptations (토론 #78)
· The Next New Thing — ai-job-search 사용 영상 (YouTube)
(2026년 10월 18일 확인)
컴퓨터가 고장 났다면 부산 컴퓨터수리 · 출장수리 부컴에 맡겨 주세요. 부산·울산·김해·양산 어디든 직접 방문합니다.
