Sitemap

Claude Code — Celery Java

4 min readOct 14, 2025

--

Press enter or click to view image in full size

이 글은 최근 Claude Code와 Codex 같은 AI 에이전트를 실무에 적용하기 전에, 테스트로 진행한 프로젝트를 구현하면서 경험한 내용을 정리한 것이다.

프로젝트 선정

AI와 협업할 프로젝트를 고민하던 중, 예전에 작성해 두었던 Celery를 Java에서 호출하는 코드가 눈에 들어왔다.

이 코드를 작성할 당시 참고했던 오픈소스 라이브러리는 이미 오래전에 유지보수가 중단된 상태였다.

라이브러리를 사용하는 데 큰 문제는 없었지만, 유지보수가 중단된 코드를 직접 다듬어보는 것도 좋은 연습이 될 것 같았다.

한 번에 구현해보기

처음에는 요구사항으로 정리한 모든 기능을 한 번에 Claude Code에게 요청했다.

Claude Code는 프로젝트 초기 설정부터 기능 구현, 오류 수정까지 순서대로 진행했다.
겉보기에는 제법 완성도 있는 코드처럼 보였다.

하지만 실제로 빌드와 실행을 시도하자 여러 오류가 발생했다.
몇 차례 수정 요청 끝에 빌드는 통과했지만, 코드 곳곳에 `TODO` 주석이 남아 있었다.

구현되지 않은 기능을 정리해 다시 요청하면 새로운 오류가 생겼고,
Claude Code가 이미 구현된 기능이라고 착각하는 일도 있었다.
이런 과정이 반복되면서 코드는 점점 복잡해졌고,
어느 순간부터는 수정에 드는 시간이 더 길어지기 시작했다.

결국 이 상태로는 유지보수조차 어렵겠다는 판단이 들었고,
처음부터 다시 만드는 것이 더 빠르겠다는 결론에 이르렀다.

작업을 나누어서 해보기

첫 번째 시도가 실패한 원인은 한 번에 너무 많은 작업을 시도했기 때문이었다.

그래서 이번에는 작업을 더 작게 나누어 다시 시작해 보기로 했다.
요구사항을 1~2일 단위로 세분화해 문서로 정리하고, 각 단계를 순서대로 Claude Code에 요청했다.
구현이 끝날 때마다 빌드와 테스트를 진행하며, 발견된 오류는 즉시 수정했다.

Get dain’s stories in your inbox

Join Medium for free to get updates from this writer.

하지만 시간이 지나면서 또다시 이상한 점이 보이기 시작했다.
비슷한 오류가 반복적으로 발생하고 있었던 것이다.
문제의 원인은 두 가지 였다.

  • 새로운 기능을 추가하면서 이전 코드로 되돌아가는 문제
  • Claude Code가 근본적인 해결 대신 임시 회피용 코드를 추가하는 문제

이 문제들이 쌓이면서 코드가 복잡해졌고, 정상적으로 실행되던 시점으로 되돌리기엔 너무 늦어 있었다.
결국, 다시 처음으로 돌아가 새롭게 시작하는 편이 낫겠다고 판단했다

반복 커밋으로 작은 이정표 세우기

다시 시작하면서, 빌드와 테스트가 정상적으로 통과될 때마다 Git 커밋을 남기기로 했다.
이 커밋들은 잘못된 방향으로 갔을 때 언제든 되돌릴 수 있는 작은 안전지점이 되어 주었다.

이 방식 덕분에 이전에 정상적으로 동작하던 코드로 돌아가거나,
새로운 코드와 비교해 어느 부분에서 오류가 발생했는지를 쉽게 파악할 수 있었다.
즉, 매번 작게나마 ‘확실히 작동하는 상태’를 남기며 앞으로 나아갈 수 있었던 것이다.

속도는 빠르지 않았지만, 이 방식은 꾸준히 전진할 수 있는 작은 이정표가 되어주었다.

작업 흐름 정리하기: Todo 리스트로 관리하기

Claude Code에 작업을 요청하면서 동시에 다른 일을 진행할 때가 많았다.
그러다 보니 방금까지 무엇을 하고 있었는지 헷갈릴 때가 자주 있었다.
이럴 때마다 이전 명령을 다시 확인하며 상황을 파악해야 했는데, 시간이 꽤 낭비되었다.

이 문제를 해결하기 위해 간단한 **할 일 목록(Todo 리스트)**을 도입했다.
앞으로 진행할 작업을 문서로 정리한 뒤, Claude Code에 요청할 때는 그 항목을 기준으로 “처리 → 완료” 흐름으로 진행하도록 했다.

단순한 도구였지만, 작업의 맥락을 잃지 않고 일관된 흐름을 유지하는 데 큰 도움이 되었다.

프로젝트 마무리

프로젝트는 계획한 범위까지 구현을 완료하며 마무리할 수 있었다.
모든 기능을 구현한 것은 아니지만, Celery Task를 동기·비동기로 호출하는 핵심 기능을 완성했고, AI와 협업해 실제로 동작하는 결과물을 만들었다는 점에서 의미 있는 경험이었다.

프로젝트 전체 코드는 GitHub에서 확인할 수 있으며,
완료된 부분은 별도의 프로젝트로 정리해 따로 공유했다.

프로젝트를 마치고 난 후

이번 프로젝트를 진행하며, AI 도구가 개발자의 역할을 근본적으로 바꾸고 있음을 실감했다.
마치 아이폰이 피처폰에서 스마트폰 시대로 전환을 이끌었듯,
AI 역시 개발 방식의 패러다임을 완전히 바꾸는 전환점이 되고 있다.
머지않아 AI와 협업하는 개발 방식은 자연스럽게 일상 속으로 스며들며, 하나의 새로운 개발 문화로 자리 잡게 될 거라 생각된다.

--

--