FastAPI 서버에 Claude API 연결하기
2026.08.06
소개
지난 글에서 만든 POST /plan은 "시간 안에 들어가면 오늘, 넘치면 내일"이라는 고정 규칙으로만 판단했습니다. 이번에는 예고했던 대로 Claude API를 연결해, 마감과 중요도까지 고려해 AI가 우선순위를 직접 판단하는 엔드포인트(POST /plan-ai)를 추가했습니다.
진행 방법
활용한 툴: Claude Code(클코) - 코드 수정·에러 해결 / Anthropic Python SDK - Claude API 호출 / FastAPI + uvicorn - 기존 서버 / Windows PowerShell - 실행·테스트 / Swagger UI - 엔드포인트 테스트
API 키 발급하고 환경변수로 저장하기
Anthropic 콘솔에서 API 키를 발급받고, 코드에 직접 쓰지 말라는 클코의 조언대로 PowerShell에서 setx ANTHROPIC_API_KEY 로 환경변수에 저장했습니다. 처음에 401 인증 에러가 났는데 키를 복사할 때 공백이 함께 들어간 것이 원인이었고, PowerShell 창을 새로 열어야 반영된다는 것도 이때 배웠습니다. (사진: 콘솔 API 키 화면)
Claude에게 판단을 맡기는 엔드포인트 추가하기
클코에게 쓴 프롬프트 전문: "main.py에 POST /plan-ai 엔드포인트를 추가해줘. 기존 /plan과 입력은 같은데, 각 할 일에 deadline(마감)과 importance(중요도)를 추가로 받아. 이걸 Claude API에 보내서 무엇을 오늘 하고 무엇을 미룰지, 그 이유까지 JSON으로 받아서 돌려줘. 모델은 claude-haiku 써줘." 클코가 pip install anthropic 설치를 안내한 뒤 코드를 작성해 줬습니다.
Swagger UI에서 AI 판단 테스트하기
가용 시간 120분에 은행 업무(30분, 마감 오늘), 발표자료(90분, 중요도 상), 블로그 글쓰기(60분, 마감 없음)를 보냈습니다. 결과는 고정 규칙과 같았지만 /plan-ai는 "은행 업무는 오늘 마감이라 미룰 수 없고, 발표자료는 중요도가 높아 우선 배치"라는 이유까지 돌려줬습니다. 판단 근거를 사람이 읽을 수 있다는 것이 규칙 로직과의 가장 큰 차이였습니다. (사진: Swagger 응답 화면)
결과와 배운 점
시행착오: 환경변수 미반영(새 창 필요), 401 인증 에러(키 공백), Claude가 JSON 앞뒤에 설명을 붙여 json.loads가 실패한 문제를 겪었고, 프롬프트 강화와 방어 코드로 해결했습니다.
도움이 필요한 부분: AI 응답이 매번 조금씩 달라지는데 재현 가능한 데모가 필요할 때 좋은 방법이 있을까요? 24시간 서버에서 API 키를 안전하게 관리하는 방법도 궁금합니다.
앞으로의 계획: 이 서버를 백그라운드 실행과 자동 재시작으로 24시간 돌리고, 아침마다 오늘 계획을 스스로 만들어 알려주는 에이전트로 완성할 계획입니다.
배운 점: 규칙 로직과 AI 판단은 대체 관계가 아니라 역할 분담이었습니다. 확실한 계산은 코드가, 애매한 우선순위 판단은 AI가 맡는 구조가 안정적이었습니다.
도움 받은 글
Claude Code로 FastAPI API 서버 만들기'에서 만든 서버를 그대로 확장했습니다.




Joy님, 401 인증 에러의 범인이 키를 복사할 때 딸려온 공백이었다는 대목에서 소리 내어 웃었습니다. 이런 공백은 어디에나 하나쯤 묻혀 있죠. 눈에 안 보이니까요.
게다가 파워셸 창을 새로 열어야 반영된다는 것까지 겹쳤으니, 키는 제대로 넣어놓고도 한참 헤매셨겠어요. Claude가 JSON 앞뒤에 설명을 붙여서 읽기가 실패한 것도 비슷한 결이고요. 정작 막히는 자리는 로직이 아니라 늘 이런 언저리더라고요. 저였으면 키만 노려봤을 겁니다.
가용 시간 120분에 은행 업무와 발표자료를 넣었더니 결과는 고정 규칙과 똑같았는데, 이번엔 왜 그렇게 골랐는지가 같이 돌아왔다는 대목이 좋았어요. 답이 같아도 이유가 붙으면 다른 물건이 되네요. 답만 보고 넘어가기 쉬운데요.
아침마다 스스로 오늘 계획을 만들어 알려주는 데까지 가시겠다니, 이제 서버를 24시간 세워두는 일이 남았네요. 매번 조금씩 달라지는 응답을 데모에서 어떻게 붙잡으실지도 같이 궁금해졌습니다. 다음 편 보러 오겠습니다.