Notebase

AGENTS.md가 무엇인지, Codex·Claude Code·Cursor에서 프로젝트 지침 파일을 어떻게 쓰는지 정리합니다. Claude Code의 CLAUDE.md, Cursor Rules와 .mdc 파일 구조, 실제 작성 예시와 주의사항까지 초보자 기준으로 설명합니다. AGENTS.md는 AI 코딩 에이전트에게 “이 프로젝트에서는 이렇게 작업해라”라고 알려주는 지침 파일이다. Codex를 쓰다 보면 자주 보이고, Claude Code나 Cursor까지 같이 쓰면 파일명이 달라서 헷갈리기 쉽다.먼저 결론부터 정리하면 이렇다.도구기본 프로젝트 지침 파일동작 방식CodexAGENTS.md작업 전 프로젝트 지침으로 참고Claude CodeCLAUDE.mdClaude Code 메모리/프로젝트 지침으로 참고C..

FastAPI에서 .env와 pydantic-settings를 사용해 DB 주소, SECRET_KEY, 디버그 설정을 코드와 분리하는 방법을 예제로 정리합니다. FastAPI 환경변수 설정을 제대로 해두면 DB 주소, JWT 비밀키, 디버그 옵션을 코드에서 분리할 수 있다. 처음에는 main.py에 직접 적는 게 편해 보이지만, GitHub에 올리거나 서버에 배포하는 순간 문제가 될 수 있다.이 글은 2026년 6월 기준 FastAPI 최신 버전과 Pydantic v2 흐름을 기준으로 작성했다. 설정 관리는 pydantic-settings를 사용하고, 로컬 개발 환경에서는 .env 파일을 함께 사용하는 방식으로 설명한다.환경변수 설정은 단순히 .env 파일을 하나 만드는 작업이 아니다.개발 환경과 운영 ..

파이썬 openpyxl로 엑셀 파일을 만들고, 읽고, 수정하고, 저장하는 기본 흐름을 초보자 기준으로 정리합니다. 자주 발생하는 오류와 사용 시 주의할 점도 함께 다룹니다. 엑셀 파일을 매번 열어서 값을 붙여넣고, 날짜를 바꾸고, 합계를 확인하는 작업이 반복된다면 openpyxl을 써볼 만합니다. 파이썬으로 .xlsx 파일을 만들고, 읽고, 수정하고, 다시 저장할 수 있기 때문입니다.다만 처음부터 “회사 업무 전체를 자동화하겠다”는 식으로 접근하면 금방 막힙니다. 먼저 엑셀 파일 구조를 파이썬 코드로 어떻게 다루는지 이해하는 게 중요합니다.이 글은 openpyxl을 처음 쓰는 사람을 기준으로, 가장 기본이 되는 흐름만 정리합니다.엑셀 파일 새로 만들기셀에 값 입력하기기존 엑셀 파일 읽기기존 파일 수정 후..

Gemini CLI 종료 이슈와 Antigravity CLI 전환 이유를 정리했습니다. 개인·기업용 차이와 기존 사용자의 점검 사항도 살펴봅니다. Gemini CLI를 쓰고 있었다면 가장 먼저 확인해야 할 점은 하나다.이 변화는 단순한 이름 변경이 아니라, Google이 터미널용 AI 코딩 도구를 Antigravity 플랫폼 안으로 통합하는 전환에 가깝다.개인 사용자 기준으로는 Gemini CLI를 계속 그대로 쓰기 어렵다. Google은 Gemini CLI와 Gemini Code Assist IDE 확장이 개인 사용자, Google AI Pro, Google AI Ultra 사용자 대상으로 요청 처리를 중단한다고 안내했다.다만 모든 사용자가 한 번에 끊기는 것은 아니다.기업용 라이선스나 Google C..

바이브 코딩을 시작하기 전에 정해야 할 기능, 화면, 데이터, 로그인, 보안, 테스트, 배포 기준을 실전 체크리스트로 정리했습니다. AI 코딩 도구로 프로젝트를 만들기 전 참고하기 좋습니다. 바이브 코딩은 AI에게 “이런 앱 만들어줘”라고 말하는 것만으로 끝나지 않는다. 실제로는 만들기 전에 무엇을 정했는지가 결과물의 품질을 거의 결정한다.AI 코딩 도구가 좋아지면서 작은 웹앱이나 자동화 도구는 예전보다 훨씬 빠르게 만들 수 있다. Cursor, Claude Code, Codex, Gemini CLI, GitHub Copilot 같은 도구를 쓰면 코드 작성과 수정 속도는 확실히 빨라진다.문제는 속도다.너무 빨리 만들어지기 때문에, 처음에 기준을 정하지 않으면 나중에 어디서 꼬였는지 찾기 어려워진다. 기능..

React, Vue, Next.js 같은 프론트엔드에서 FastAPI API 호출이 CORS 오류로 막히는 이유와 CORSMiddleware 설정 방법을 초보자 기준으로 정리합니다. FastAPI CORS 설정은 프론트엔드에서 백엔드 API를 호출할 때 자주 막히는 지점이다. React, Vue, Next.js 개발 서버와 FastAPI 서버를 따로 실행하면 브라우저 콘솔에 CORS 오류가 뜨는 경우가 많다.처음 보면 FastAPI 코드가 잘못된 것처럼 보인다.하지만 실제로는 API 로직 문제가 아니라 브라우저 보안 정책 때문에 요청이 차단되는 상황인 경우가 많다. CORS가 뭔가요?CORS는 Cross-Origin Resource Sharing의 줄임말이다.한국어로 풀면 “교차 출처 리소스 공유” 정도..

FastAPI에서 JWT 로그인 인증이 어떻게 동작하는지 로그인 요청, 토큰 발급, Bearer 헤더 인증, 보호된 API 접근 흐름을 중심으로 정리합니다. FastAPI JWT 로그인은 사용자가 로그인하면 서버가 토큰을 발급하고, 이후 요청에서 그 토큰을 확인해 사용자를 인증하는 방식이다. 핵심은 “로그인 상태를 서버가 계속 들고 있지 않는다”는 점이다.일반적인 웹 로그인에서는 서버 세션을 떠올리기 쉽다.사용자가 로그인하면 서버가 세션을 만들고, 브라우저는 쿠키를 들고 다닌다. 요청이 올 때마다 서버는 쿠키에 연결된 세션 정보를 확인한다.JWT 방식은 조금 다르다.서버는 로그인 성공 시 서명된 토큰을 만들어 클라이언트에 전달한다. 클라이언트는 이후 API 요청마다 이 토큰을 함께 보낸다. 서버는 토큰의..

Codex, Claude Code, Cursor 같은 AI 코딩 도구가 만든 코드를 그대로 실행하기 전, 초보자가 반드시 확인해야 할 코드 검토 기준을 정리했습니다. AI 코딩 도구를 쓰면 개발 속도는 확실히 빨라집니다.Codex, Claude Code, Cursor, GitHub Copilot 같은 도구는 코드를 대신 작성해 주고, 오류를 고쳐 주고, 때로는 여러 파일을 한 번에 수정하기도 합니다.하지만 여기서 중요한 문제가 하나 있습니다.AI가 만든 코드라고 해서 무조건 안전한 코드는 아닙니다.특히 개발을 막 시작한 초보자라면 AI가 제안한 코드가 맞는지, 위험한지, 내 프로젝트에 적절한지 판단하기 어려울 수 있습니다.이 글에서는 AI 코딩 에이전트가 만든 코드를 그대로 실행하기 전에 초보자가 반드시..

FastAPI 프로젝트가 커질 때 main.py 하나로 관리하기 어려워집니다. APIRouter, schemas, models, database 파일을 어떤 기준으로 나누면 좋은지 초보자 눈높이에서 정리합니다. FastAPI 프로젝트 구조는 처음부터 복잡하게 잡을 필요는 없습니다. 다만 API가 늘어나고 데이터베이스, 요청 모델, 응답 모델이 생기면 main.py 하나로 관리하기 어려워집니다.처음에는 한 파일로 시작해도 괜찮습니다.하지만 어느 순간 이런 문제가 생깁니다.main.py 안에- API 코드- Pydantic 모델- DB 연결 코드- 테이블 모델- 예외 처리- 비즈니스 로직이 전부 섞여 있음 이렇게 되면 코드를 고치기 어려워집니다.새로운 API를 추가할 때마다 main.py를 계속 열어야 하고..

FastAPI로 간단한 CRUD API를 만드는 방법을 예제로 정리했습니다. GET, POST, PUT, DELETE 요청이 각각 어떤 역할을 하는지 코드와 함께 확인할 수 있습니다. FastAPI CRUD API를 처음 만들 때는 데이터베이스부터 연결하기보다, 메모리 데이터를 사용해 흐름을 먼저 잡는 게 좋습니다. GET, POST, PUT, DELETE가 각각 어떤 역할을 하는지 코드로 바로 확인할 수 있기 때문입니다.이번 예제에서는 상품 정보를 다루는 간단한 CRUD API를 만들어보겠습니다.데이터베이스는 아직 사용하지 않습니다.파이썬 딕셔너리에 데이터를 저장하는 방식으로 API 구조만 먼저 익힙니다. CRUD API란?CRUD는 데이터를 다룰 때 가장 기본이 되는 4가지 작업입니다.CRUD의미HT..