비개발자가 Claude Code로 업무 계산기 11개를 만든 방법

연차가 며칠 남았는지, 퇴직금이 얼마인지, 연봉을 올리면 실수령액이 얼마나 느는지는 물어볼 때마다 다시 계산해야 한다. 이런 계산을 이 사이트의 계산기 11개로 만들었다. 코드는 Claude Code(내 PC의 파일을 직접 읽고 고치는 Claude의 작업 도구)가 썼다. 나는 무엇을 계산할지와 어떤 기준으로 할지를 정하고, 나온 숫자가 맞는지 검산했다.

코드를 배운 적이 없어도 계산기는 만들 수 있다. 어려운 곳은 코드 쪽이 아니었다. 기준이 되는 숫자를 어디서 가져오는지, 결과를 어떻게 보여 주는지, 틀린 곳을 어떻게 찾는지였다.

다시 계산하게 되는 것만 계산기로 만든다

사이트에는 글과 계산기가 따로 있다. 값을 바꿔 가며 여러 번 계산하는 것은 계산기로, 판단 과정은 글로 둔다. 예를 들어 육아휴직 급여를 어떻게 계산하는지 설명하는 글은 한 번 읽으면 되지만, 휴직 기간이나 월급을 바꿔 보는 일은 계산기가 편하다.

만들기 전에 규칙 네 가지를 정했다

계산기를 하나씩 만들 때마다 설명하지 않도록, 프로젝트 규칙 파일(CLAUDE.md)에 계산기 규칙을 먼저 적었다. Claude Code는 일을 시작할 때 이 파일을 읽으니, 새 계산기도 같은 규칙으로 나온다.

1. 입력칸과 결과를 스크롤 없이 한 화면에 둔다. 계산기는 값을 여러 번 바꿔 보는 도구다. 결과가 화면 밖에 있으면 값을 바꿀 때마다 화면을 오르내려야 한다.
2. 입력값은 서버로 보내지 않고 브라우저에서 계산한다. 급여와 입사일 같은 값이 사이트 서버에 남지 않게 한다.
3. 계산에 쓰는 숫자는 공식 원문에서 가져오고, 페이지 아래 “계산 기준”에 원문 링크를 둔다. 최저임금, 보험요율, 세액이 그런 숫자다.
4. 해마다 바뀌는 숫자는 코드 맨 위 한곳에 모으고 연도를 적는다. 아직 시행되지 않은 인상안은 넣지 않는다.

4번 덕분에 기준이 바뀌면 고칠 곳이 한곳뿐이다. 규칙 파일에는 “해마다 확인할 값” 표도 따로 두었다. 최저임금, 국민연금·건강보험·고용보험 요율, 간이세액표가 언제 바뀌는지 적어 두고, 각 기준이 바뀌는 시점에 맞춰 점검한다. 대부분은 1월에 바뀌지만, 국민연금 기준소득월액은 7월에 바뀐다.

2번에는 한계가 있다. 계산 결과를 링크로 보낼 수 있게, 계산기 대부분이 입력한 값을 주소창 뒤에 붙인다. 서버로 가지는 않지만 브라우저 방문 기록에 남고, 링크를 보내면 값도 같이 간다. 실제 급여를 넣고 계산했다면 그 링크는 보내지 않는 편이 낫다.

결과가 입력칸보다 먼저 보이게 했다

처음 만든 계산기는 입력칸 아래에 결과가 있었다. 휴대폰에서는 값을 넣고 한참 내려야 결과가 보였다. 그래서 “계산기 결과값까지 스크롤 이동 없이 바로 보일 수 있는 방법 찾아라“라고 했다.

Claude Code는 결과 상자를 입력칸 위로 올리고, 화면을 내려도 위에 붙어 있게 바꿨다. 휴대폰에서는 상자를 줄여 입력칸이 같이 보이게 했다. 자세한 표와 계산 과정은 결과 아래에 둔다.

처음 열 때는 예시 값으로 계산된 화면이 나온다. 빈칸만 있으면 무엇을 넣어야 할지 모른다. 값을 하나라도 고치면 “예시” 표시가 사라진다.

숫자는 원문에서 가져온다

AI에게 “2026년 국민연금 요율”을 물으면 그럴듯한 숫자가 나오지만, 계산기에 넣을 숫자는 그렇게 받지 않았다. 법령과 고시 원문을 찾아 확인한 숫자만 넣고, 어느 원문인지 코드에 주석으로 남겼다. 예를 들어 2026년 국민연금 근로자 부담은 4.75%인데, 코드에는 근거가 된 법 조항과 부칙이 같이 적혀 있다.

근로소득 간이세액표는 따로 손이 갔다. 월급과 부양가족 수로 매달 뗄 세액을 정하는 표인데, 계산기는 이 표의 값을 그대로 찾아 써야 맞는다. 그래서 법령에 붙은 표를 기준으로 삼기로 하고, 국가법령정보센터에서 표가 실린 PDF를 받아, PDF의 표를 계산기가 읽는 데이터 파일로 바꾸는 작은 프로그램을 Claude Code가 만들었다. 세액표가 개정되면 새 PDF를 넣고 이 프로그램을 다시 돌리면 된다.

검산은 손으로 계산한 값과 맞춰 본다

만든 쪽은 자기가 세운 계산 방식으로 다시 보기 쉽다. 그래서 만든 뒤에 “계산 오류는 없는지 다시 한번 확인해줘”라고 따로 시킨다. 다만 이건 다시 봐 달라는 요청이다. 검산은 같은 값을 손으로 계산해 계산기 결과와 맞춰 보는 것이다.

만든 뒤 고친 오류는 이런 것들이다.

• 일할계산이 1원 모자랐다. 월 280만 원을 30일 중 21일만 일했을 때, 비율 0.7을 먼저 구해 곱하면 컴퓨터 안에서는 195만 9,999.999…원이 된다. 원 단위 아래를 버리니 1원이 모자랐다. 금액에 일한 날수를 먼저 곱하고 나중에 나누게 고쳤다.
• 빼기 부호를 못 읽었다. 안내 문구대로 “−25”를 넣었는데 감소로 계산되지 않았다. 문서에서 복사한 빼기 기호(−)가 키보드의 빼기(-)와 다른 글자였다.
• 목표 기간이 2.5년이면 표가 3년까지 나왔다. 딱 떨어지지 않는 기간은 마지막 줄에 목표 시점을 따로 보여 주게 고쳤다.
• 링크로 열면 예시 값이 안 나왔다. 메신저나 광고에서 누른 링크에는 주소 뒤에 추적용 값이 붙는데, 이것을 공유된 입력값으로 잘못 읽고 빈 화면을 띄웠다.

1원 차이는 결과만 봐서는 알기 어렵다. 손으로 계산한 값을 옆에 두어야 보인다. 계산기는 숫자가 틀리면 쓸모가 없어서, 검산은 만드는 것과 따로 한 번 더 한다.

요청하는 법

계산기 하나를 만들 때는 무엇을 넣으면 무엇이 나와야 하는지와 기준이 되는 원문을 말한다.

퇴직금 계산기 만들어줘.
입사일, 퇴사일, 최근 3개월
월급을 넣으면 나오게.
기준은 근로자퇴직급여
보장법 원문으로 확인해.

다 만들면 결과가 나오는 화면을 휴대폰 폭으로 확인하고, 예시 값 몇 개를 손으로 계산한 값과 맞춰 본다. 틀린 곳이 없으면 “계산 오류는 없는지 다시 한번 확인해줘”로 한 번 더 넘긴다.