[AI]Claude Code로 서버 운영하기 - AI 코딩 에이전트 실전 활용기

 

안녕하세요. 주식회사 서버몬 입니다.

 

터미널에서 대화하며 서버를 고친다

 

"아직 이카운트랑 연동이 되고 있나?"

한 줄 질문을 던졌더니, AI가 알아서 서버에 접속하고, 로그를 뒤지고, 코드를 읽고, 버그를 찾아냈습니다.

이것이 Claude Code를 실무에 투입하면서 겪은 변화입니다.

이번 글에서는 저희가 운영 중인 재고관리 시스템 자동동기화 서버를 Claude Code로 관리한 실제 사례를 정리했습니다.

Claude Code란?

Claude Code는 Anthropic이 만든 에이전틱 코딩 도구입니다. 터미널(CLI)에서 자연어로 요청하면,

AI가 직접 아래와 같이 움직입니다.

• 파일을 읽고 코드를 분석하고
• 쉘 명령어를 실행하고
• 서버 상태를 점검하고
• 코드를 수정하고
• 결과를 검증까지

일련의 작업을 스스로 판단해서 수행합니다. 사람이 "이거 해줘"라고 말하면,

어떤 파일을 봐야 하는지, 어떤 명령어를 실행해야 하는지 AI가 직접 결정합니다.

 

- 스케줄러 타임존 버그
저희는 재고관리 시스템(이카운트)과의 자동 동기화 서버를 운영 중입니다.

컨테이너로 8일째 구동 중이었고, 동기화는 계속 성공하고 있었습니다.

 

1. 질문 한 줄로 점검 시작

"아직 이카운트랑 연동이 되고 있나?"

이 질문에 Claude Code는:

1. 3개 패턴을 검색
2. 9개의 쉘 명령어 실행
3. 이전 대화 메모리 1건 조회

를 스스로 수행하고, 서버에 직접 접속해서 현재 상태를 확인했습니다.

발견한 결과

현재 상태
- 컨테이너 8일째 계속 구동 중
- 마지막 동기화 성공: 약 8시간 전 (380개 품목 중 371개 반영)
- 7/24~8/4까지 동기화 이력이 꾸준히 남아있어서 인증/API 연결 자체는 정상

동기화는 정상적으로 성공하고 있었습니다. 하지만 여기서 AI가 요청하지 않은 버그를 하나 더 찾아냈습니다.

 

 

2. 스스로 발견한 버그

스케줄이 "매일 08:00·19:00 (KST)"로 설계되어 있는데, 실제 동기화 시각 기록을 보니 UTC 08:00·19:00(=한국시각 17:00·04:00)에 돌고 있었습니다.

원인 분석:

# app/scheduler.py
# 원인: BackgroundScheduler(timezone=Asia/Seoul)은 설정했지만,
# 정작 CronTrigger(hour=8, minute=0)에는 timezone을 안 넘겨줘서
# 트리거 자체가 컨테이너 기본시간대(UTC)를 쓰고 있었음

BackgroundScheduler에는 서울 시간대를 설정했지만, 개별 CronTrigger에는 timezone이 전파되지 않는 구조적 문제였습니다. 동기화 자체는 계속 성공하고 있어서 데이터에는 문제가 없었지만, 의도한 "출근시간대(08시)/퇴근시간대(19시) 동기화"가 아니라 실제로는 새벽 4시/오후 5시에 도는 상태였습니다.

 

3. 수정 및 검증

Claude Code가 제안한 수정안:

# Before
scheduler.add_job(_run_sync, CronTrigger(hour=8, minute=0), 
                   id="ecount_sync_0800", replace_existing=True)
scheduler.add_job(_run_sync, CronTrigger(hour=19, minute=0), 
                   id="ecount_sync_1900", replace_existing=True)

# After
kst = ZoneInfo("Asia/Seoul")
scheduler.add_job(_run_sync, CronTrigger(hour=8, minute=0, timezone=kst), 
                   id="ecount_sync_0800", replace_existing=True)
scheduler.add_job(_run_sync, CronTrigger(hour=19, minute=0, timezone=kst), 
                   id="ecount_sync_1900", replace_existing=True)

수정 후 진행 과정:

1. docker compose up -d --build로 반영
2. 재시작 확인
3. 다음 실행 시각이 2026-08-05 19:00:00+09:00 / 2026-08-06 08:00:00+09:00로 KST 기준으로 정확히 잡히는지 검증

소요 시간: 2분 4초

이 사례에서 확인한 것

1. 진단부터 수정, 검증까지 한 흐름으로 처리

사람이 개입한 부분은 "연동 되고 있나?"라는 한 줄 질문과, 수정 이후 "실제 19시에 도는지 확인해달라"는 후속 요청뿐이었습니다. 로그 확인, 코드 원인 분석, 수정, 재배포, 검증을 AI가 순서대로 수행했습니다.

2. 요청하지 않은 문제도 함께 발견

"연동 여부"만 물어봤는데, 스케줄 시각이 어긋나 있다는 것은 별도로 코드를 들여다보다가 발견한 것입니다. 정상 작동 중인 시스템이라도 코드를 실제로 읽어보지 않으면 놓치기 쉬운 종류의 문제였습니다.

3. 컨테이너 환경의 흔한 함정을 짚어냄

컨테이너 기본 시간대가 UTC인 상태에서, 애플리케이션 레벨 timezone 설정이 일부 객체에만 적용되고 하위 트리거에는 전파되지 않는 문제는 실무에서 자주 나오는 패턴입니다. BackgroundScheduler와 CronTrigger가 timezone을 독립적으로 관리한다는 것은 APScheduler 사용 시 흔히 놓치는 부분입니다.

실무에서 이렇게 활용 중입니다

서버 상태 점검

"○○ 서버 디스크 얼마나 남았어?"
"오늘 새벽 배치 잘 돌았나 확인해줘"

장애 대응

로그 위치를 몰라도, "에러 나는 것 같은데 원인 찾아줘"라고 하면 관련 로그 파일을 찾아서 분석합니다.

코드 수정 후 즉시 배포 검증

수정 → 빌드 → 재시작 → 실제 동작 확인까지 이어서 처리합니다.

도입 시 고려할 점

장점:

• 반복적인 점검/진단 작업 시간 단축
• 사람이 놓치기 쉬운 부분(위 사례의 timezone 전파 문제)을 코드 레벨에서 짚어냄
• 자연어로 요청하면 되므로 정확한 명령어나 파일 경로를 몰라도 작업 가능

주의할 점:

• 프로덕션 서버에 직접 접근 권한을 주는 것이므로 권한 범위 설정이 중요
• 중요한 변경(배포, 설정 변경)은 AI가 진행 상황을 보고하되, 최종 확인은 사람이 하는 프로세스 필요
• 재고관리처럼 데이터 정합성이 중요한 시스템은 수정 후 반드시 실제 값 검증 필요

마무리

터미널에 자연어로 질문 하나 던졌을 뿐인데, 서버 상태 점검부터 숨어있던 버그 수정, 재배포, 검증까지 이어진 사례였습니다.

특히 인상적이었던 부분은 "연동되고 있나?"라는 단순한 질문에 대한 답 이상으로, 코드를 실제로 읽으면서 스케줄 시각이 설계와 다르게 동작하고 있다는 것까지 짚어냈다는 점입니다.

앞으로 저희 서버/보안 운영 사례에서 Claude Code를 활용한 경험이 쌓이면 시리즈로 계속 정리해보겠습니다.

 

1U서버 / 2U서버 / AI서버 / alyac / APC / APC UPS / backup / carepack / centos / chakramax / cuda / DAS / DB / DB서버 / defog / DEFOG랙 / dell5820 / dell5820t / dell7920 / dellpoweredge / dellr240 / dellr340 / dellr350 / dellr450 / dellr540 / dellr630 / dellr640 / dellr740 / dellr750 / dellserver / dellt40 / dellt440 / dellt5820 / dell서버 / DELL서버CPU / DELL서버RAID컨트롤러 / DELL서버SAS하드디스크 / DELL서버가격비교 / DELL서버가격비교견적 / DELL서버견적 / DELL서버구매 / DELL서버디스크교체 / DELL서버메모리 / dell서버서버몬 / DELL서버펌웨어 / DELL서버하드디스크구매 / dell옵션 / dell워크스테이션 / dl20 / dl20gen10 / dl20gen11 / dl360 / dl360gen10 / dl360gen11 / dl380 / dl380g10 / dl380gen10 / dl380gen11 / ECC메모리 / EDFOG랙가격 / embedded / est security / ESTSOFT / FIRMWARE / GPU / gpu서버 / gpu타워형서버 / greenlake / HA솔루션 / HP GPU / hp hdd / hpdl20 / HPDL20Gen10 / hpdl360 / hpdl360gen10 / hpdl380 / hpdl380g10 / HPDL380Gen10 / HPE / HPE GPU / hpe hdd / hpe rok / HPE Service Pack for Proliant / HPE SPP / hpe ssa / hpedl20 / hpedl20gen10 / hpedl360gen10 / hpe서버 / HPE서버CPU / HPE서버RAID컨트롤러 / HPE서버SAS하드디스크 / HPE서버가격비교 / HPE서버가격비교견적 / HPE서버견적 / HPE서버구매 / HPE서버드라이버설치 / HPE서버디스크교체 / HPE서버메모리 / HPE서버비용 / hpe서버소음 / HPE서버펌웨어 / HPE서버하드디스크구매 / hpe옵션 / hpe정품 / hpgen10 / hpml30 / hpserver / hpz2 / hpz4 / hpz4g4 / hpz6g4 / hpz8g4 / hp마이크로서버 / hp서버 / hp서버cto / hp서버pc / HP서버메모리 / hp서버소음 / hp서버컴퓨터 / HP서버파워 / HP서버펌웨어 / HP서버하드디스크 / hp옵션 / hp워크스테이션 / hp정품 / hp프로라이언트 / HYPER BACKUP / ibm서버 / ilo / Intelligent Provisioning / internetdisk / KVM / KVM 기술지원비(비용) / KVM 설치비 / L2스위치 / L3스위치 / LENONO서버SAS하드디스크 / lenovop620 / lenovor650 / LENOVO서버 / LENOVO서버CPU / LENOVO서버RAID컨트롤러 / LENOVO서버가격비교 / LENOVO서버가격비교견적 / LENOVO서버견적 / LENOVO서버구매 / LENOVO서버디스크교체 / LENOVO서버메모리 / LENOVO서버하드디스크구매 / LENOVO펌웨어업데이트 / Linux / ML30 / ml30gen10 / ml30gen11 / ML350GEN10 / ml350gen11 / ML360 / MS CSP / MSSQL / MSSQL 기술지원비(비용) / MSSQL 설치비 / MYSQL / MySQL 기술지원비(비용) / MySQL 설치비 / NAS / NVIDIA / Office 365 / oneview / orange / OS설치 / PA-410 / PA-440 / paloalto / poweredger740 / poweredger750 / precision5820 / QUADRO / r240 / r250 / r340 / r360 / r440 / r550 / r650 / r660 / r740 / r750xs / r760 / r760xs / RAID / redhat / RHEL설치 / RMS랙 / rocky / s100i / securedisk / server / serverpc / smart storage administrator / SPP / sql server / sr250 / sr650 / SYNOLOGY / SYNOLOGY나스 / t150 / t360 / UPS / UPS기술지원 / UPS납품 / UPS설치 / V3 / veeam / vroc / windows server / Windows서버설치 / XEON서버 / z8g4 / 가상서버 / 가성비서버 / 기술지원비(비용) / 나스기술지원 / 나스설치지원 / 네트워크스위치 / 네트워크장비 / 더블테이크 / 데이터베이스 / 델5820 / 델서버 / 델서버비용 / 델서버펌웨어업데이트 / 델옵션 / 델워크스테이션 / 델컴퓨터워크스테이션 / 디포그 / 디포그랙 / 디포그랙가격 / 딥러닝 / 딥러닝pc / 딥러닝서버 / 랙 / 랙(RACK) 기술지원비(비용) / 랙(RACK) 설치비 / 랙납품설치 / 랙설치 / 레노버p620 / 레노버서버 / 레노버워크스테이션 / 레노보서버 / 레노보서버펌웨어 / 레드헷설치 / 레이드 / 레이드구성 / 록키리눅스 / 리눅스 / 리눅스 기술지원비(비용) / 리눅스 설치비 / 리눅스서버 / 리눅스서버설치 / 리눅스서버트러블슈팅 / 리눅스트러블슈팅 / 문서보안 / 문서중앙화 / 미니서버 / 미니서버랙 / 미니서버렉 / 미디어서버 / 방화벽 / 방화벽 기술지원비(비용) / 방화벽 설치비 / 방화벽엔지니어 / 백업 / 백업 기술지원비(비용) / 백업 서버 / 백업서비스 / 백업솔루션 / 보안솔루션 / 보안솔루션구매 / 보안솔루션설치 / 보안툴 / 빔백업 / 샤크라맥스 / 서버 / 서버 기술지원비(비용) / 서 버 랙마운트비용 / 서버 설치비 / 서버 장애조치비용 / 서버CPU / 서버MEMORY / 서버OS설치 / 서버pc / 서버가격 / 서버가속기 / 서버견적 / 서버교체 / 서버구매 / 서버구입 / 서버구축 / 서버기술지원 / 서버납품 / 서버디스크장애처리 / 서버랙 / 서버렉 / 서버렉마운트 / 서버메모리 / 서버 몬 / 서버몬기술지원 / 서버백업 / 서버보안 / 서버부품 / 서버엔지니어 / 서버옵션 / 서버용GPU / 서버용PC / 서버용그래픽카드 / 서버용메모리 / 서버 / 컴퓨터 / 서버용하드디스크 / 서버재고 / 서버컴 / 서버컴퓨터 / 서버트러블슈팅 / 서버판매 / 서버하드 / 서버호스팅 / 스위치 / 스위치 기술지원비(비용) / 스위치 설치비 / 스토리지 / 스토리지 기술지원비(비용) / 스토리지 랙마운트비용 / 스토리지 설치비 / 스토리지 장애조치비용 / 스토리지납품설치 / 스토리지서버 / 시놀로지DS918 / 시놀로지HyperBackup / 시놀로지나스 / 시놀로지나스백업 / 시놀로지하이퍼백업 / 시큐어디스크 / 안랩 / 알약 / 앱서버 / 오피스 365 / 우분투설치 / 워크스테이션 / 워크스테이션pc / 워크스테이션컴퓨터 / 윈도우서버 / 윈도우서버2016 / 윈도우서버2019 / 윈도우서버2022 / 윈도우서버설치 / 윈도우서버컴퓨터 / 윈도우서버트러블슈팅 / 윈도우즈 기술지원비(비용) / 윈도우즈 설치비 / 이스트소프트 / 이스트 시큐리티 / 이중화솔루션 / 이중화솔루션구매 / 이중화솔루션설치 / 인터넷디스크 / 임베디드 / 저가서버 / 저렴한서버 / 정품서버 / 정품서버옵션 / 제온서버 / 젠서버 / 중고서버 / 중고워크스테이션 / 카보나이트 / 카스퍼스키 / 컴퓨터서버 / 케어팩 / 타워서버 / 타워형서버 / 팔로알토 / 페도라설치 / 프로라이언트