Claude Code로 코드 수정 자동화하기 (AI 코딩 에이전트)

 

"이 함수 비동기로 바꿔줘", "이 파일 리팩토링해줘~!" 말 한마디면 AI가 직접 코드를 고쳐주는 시대가 왔습니다.

Claude Code는 터미널에서 실행되는 AI 코딩 에이전트로, 채팅 명령만으로 파일 수정부터 Git 작업까지 처리해 줍니다.

 

이번 글에서는 소스코드의 개선사항을 Claude Code로 수정하는 과정을 살펴보겠습니다 🙂

---

Claude Code가 뭔가요?

Claude Code는 Anthropic이 만든 터미널 기반 AI 코딩 에이전트입니다.

기존에 AI 코딩 도구들이 IDE 플러그인이나 웹 인터페이스 형태였다면, Claude Code는 터미널에서 직접 실행되며 아래와 같은 작업을 자연어 명령으로 처리해 줍니다.

• 파일 읽기 / 수정 / 생성
• Git 작업 (diff, commit, branch 등)
• 코드 리팩토링 및 버그 수정
• 코드베이스 분석 및 설명

마치 옆에서 함께 고민하며 코드를 작성해 주는 든든한 AI 동료라고 생각하면 될 것 같아요 🙋‍♂️

---

실습 배경

기존 FastAPI 기반 서비스의 "/review" API는 모든 처리가 끝난 뒤에만 응답을 보내는 방식이었습니다.

그러다 보니 내부 로직은 금방 끝나는데도 GitLab CI/CD 파이프라인이 응답을 계속 기다리며 최대 10분 동안 '실행 중' 상태에 머물러 있게 되는 문제가 있었어요. 파이프라인의 효율을 높이기 위해 불필요한 대기 시간을 줄이는 개선 작업을 Claude Code를 이용하여 진행했습니다.

---

[실습] Claude Code로 코드 수정 자동화하기

1. Claude Code 설치

Claude Code를 설치하는 방법은 크게 두 가지가 있습니다. 

 

방법 A: npm으로 설치

Node.js 환경이 구축되어 있다면 가장 확실하고 공식적인 방법입니다.

# 글로벌 설치
npm install -g @anthropic-ai/claude-code

# 설치 확인
claude --version

 

💡 참고

• Node.js 버전: npm 설치 시 Node.js 18.x 이상의 버전이 필요합니다.
• 권한 문제: npm 설치 시 EACCES 에러가 발생한다면 명령어 앞에 sudo를 붙이거나, npm 기본 경로 설정을 확인해 주세요.

 

방법 B: Homebrew로 설치 (macOS 사용자)

터미널 패키지 관리자인 Homebrew를 선호하신다면 아래 명령어를 사용합니다.

(최근에는 별도의 tap을 추가해야 하는 경우가 많으니 확인이 필요합니다.)

# Homebrew를 통한 설치
brew install anthropic-ai/tap/claude-code

# 설치 확인
claude --version

 

 

2. Git 저장소 클론 및 브랜치 생성

수정할 프로젝트를 로컬에 받아옵니다.

cd ~/dev  # 작업 디렉토리
git clone https://gitlab.example.com/your-team/your-project.git
cd your-project

# 수정 내용에 맞는 브랜치 생성
git checkout -b fix/code-quality-async-review

 

 

3. Claude Code 실행 및 로그인

claude

 

처음 실행하면 브라우저가 열리면서 Anthropic 계정 로그인을 요청합니다. 로그인을 완료하면 터미널로 돌아오고 아래처럼 Claude Code 홈 화면이 나타납니다.

 

⚠️ Claude Pro 이상 구독이 필요해요 :)

 

 

워크스페이스 신뢰 여부를 묻는 화면이 나오면 1. Yes, I trust this folder 를 선택하고 Enter를 누릅니다.

---

4. 채팅(자연어)으로 파일 수정 요청

Claude Code 프롬프트(>)에서 수정 내용을 자연어로 입력합니다.

app/main.py 파일을 수정해줘.

변경사항:
1. 첫 번째 import 라인에 BackgroundTasks 추가:
   from fastapi import FastAPI, APIRouter, HTTPException, BackgroundTasks

2. review_merge_request 함수:
   - @router.post("/review", status_code=202) 로 변경
   - 파라미터에 background_tasks: BackgroundTasks 추가
   - 기존 로직 전체를 내부 async def _run(): 으로 감싸기
   - background_tasks.add_task(_run) 호출 후 즉시 {"status": "accepted", "message": "리뷰 요청이 접수되었습니다."} 반환

3. review_feature_push 함수도 동일하게:
   - @router.post("/review/push", status_code=202) 로 변경
   - 동일한 BackgroundTasks 패턴 적용
   - 즉시 {"status": "accepted", "message": "Push 리뷰 요청이 접수되었습니다."} 반환

 

"Yes, allow all edits during this session" 을 선택하면 이후 수정도 자동으로 승인됩니다.

Yes, allow all edits during this session

 

 

Claude Code가 파일을 읽고 변경된 내용을 보여줍니다.

변경 완료 메시지가 뜨면 성공~ 🎉

Claude Code가 변경사항 diff를 보여주는 화면

---

5. 변경사항 확인 후 Push

Claude Code를 종료하고 소스코드를 반영하면 끄읏~! 🙌

# Claude Code 종료
/exit

# 변경 내용 확인
git diff app/main.py

# 커밋 및 push
git add app/main.py
git commit -m "커밋 메시지"
git push origin 브랜치명

---

마치며

AI가 코드를 짜주는 시대, 거부하고 싶을 때도 있지만 파도는 이미 밀려오고 있습니다. 🌊

변화의 파도에 올라타 즐길 것인지, 아니면 휩쓸릴 것인지는 한 끗 차이인 것 같아요.

Claude Code 같은 도구를 내 보조 개발자로 활용하며 익숙해지는 연습이 꼬옥~ 필요한 시점인 것 같습니다 :)

 

보드 위에 올라설 준비, 되셨나요~? 🌊 🏄‍♂️🏄

 

 

터미널이 낯선 분들을 위한 TIP
VS Code에서 Claude 확장 플러그인을 설치하면 터미널 없이도 동일한 작업을 GUI 환경에서 편하게 할 수 있어요.
터미널 환경이 익숙치 않으시다면, VS Code를 사용하는 것을 추천드려요 :)

 

👉 Visual Studio Code Download: https://code.visualstudio.com/

Visual Studio Code - The open source AI code editor | Your home for multi-agent development

Claude Code with VS Code