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..

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 같은 도구를 쓰면 코드 작성과 수정 속도는 확실히 빨라진다.문제는 속도다.너무 빨리 만들어지기 때문에, 처음에 기준을 정하지 않으면 나중에 어디서 꼬였는지 찾기 어려워진다. 기능..

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

바이브 코딩의 뜻과 최근 AI 코딩 흐름을 정리하고, AI가 만든 코드를 그대로 쓰면 안 되는 이유를 코드 품질, 보안, 유지보수 관점에서 설명합니다. 바이브 코딩은 AI에게 자연어로 원하는 기능을 설명하고, 생성된 코드를 바탕으로 빠르게 개발하는 방식이다. 코드 한 줄을 직접 고민하기보다 “이런 기능 만들어줘”에 가깝게 개발 흐름을 가져간다.이름 그대로 세부 구현을 한 줄씩 통제하기보다, 전체적인 방향을 잡고 AI가 코드를 만들어가게 두는 방식에 가깝다. 개발자가 모든 코드를 직접 작성하는 대신, 구현의 흐름과 결과물을 조정하는 쪽으로 역할이 이동하는 것이다.예전에는 개발자가 문법, 라이브러리, 구조를 직접 잡고 AI는 보조 역할을 했다. 지금은 흐름이 조금 달라졌다. Cursor, Claude Cod..

Codex가 무엇인지, ChatGPT와 어떤 점이 다른지 개발 작업 흐름 기준으로 정리했습니다. Codex CLI, 코드 수정, 리뷰, 테스트, 보안 주의사항까지 개발자가 알아야 할 핵심을 설명합니다. Codex는 OpenAI가 제공하는 개발용 AI 코딩 에이전트다. ChatGPT가 코딩 질문에 답하고 개념을 설명해주는 도구에 가깝다면, Codex는 실제 프로젝트 안에서 코드를 읽고, 수정하고, 실행하는 흐름까지 도와주는 도구에 가깝다.처음 들으면 “그냥 코딩 잘하는 ChatGPT 아닌가?” 싶을 수 있다.틀린 말은 아니지만, 정확히는 조금 다르다.ChatGPT가 대화창에서 개발을 도와주는 방식이라면, Codex는 개발 환경 안으로 들어와서 작업을 함께 처리하는 쪽에 더 가깝다.여기서 말하는 Codex는..

Claude Code가 무엇인지, 일반 AI 챗봇·코드 자동완성 도구와 무엇이 다른지, 터미널에서 파일 수정과 명령 실행까지 돕는 AI 코딩 에이전트의 개념을 정리합니다. Claude Code는 Anthropic이 제공하는 AI 코딩 도구입니다. 단순히 코드를 추천해주는 챗봇이 아니라, 개발자가 작업 중인 코드베이스를 읽고, 파일을 수정하고, 터미널 명령어 실행 흐름까지 도와주는 AI 코딩 에이전트에 가깝습니다.기존 AI 챗봇은 보통 이런 방식으로 사용했습니다.코드를 복사합니다.질문을 입력합니다.답변을 다시 복사해서 IDE나 터미널에 붙여넣습니다.에러가 나면 다시 설명합니다.Claude Code는 이 중간 과정을 줄이는 데 초점이 있습니다. 개발자가 터미널에서 “이 버그 원인 찾아줘”, “테스트 실패 이..

Context7은 AI 코딩 도구가 최신 개발 문서와 코드 예제를 참고하도록 돕는 MCP 기반 도구입니다. Context7의 개념, MCP와의 관계, 사용 방식, 주의할 점을 초보자도 이해하기 쉽게 정리했습니다. AI 코딩 도구를 쓰다 보면 Context7이 자주 언급됩니다. Context7은 AI가 오래된 기억만으로 코드를 작성하지 않도록, 최신 개발 문서와 코드 예제를 프롬프트에 넣어주는 MCP 기반 도구입니다.개발자는 AI에게 질문합니다.“Next.js 미들웨어 코드 작성해줘.”“Supabase 로그인 구현해줘.”“Cloudflare Workers 캐싱 예제 만들어줘.”문제는 여기서 시작됩니다.AI가 답은 해주지만, 그 답이 현재 버전과 맞지 않을 수 있습니다. 예전 문법을 쓰거나, 더 이상 존재하..

MCP(Model Context Protocol)가 무엇인지, AI 에이전트가 외부 도구와 데이터를 어떻게 연결하는지 초보자도 이해할 수 있게 정리합니다. MCP란 AI 에이전트가 외부 도구, 데이터, 앱과 연결될 수 있도록 만든 표준 프로토콜이다. 정식 명칭은 Model Context Protocol이다.쉽게 말하면, AI가 혼자 대화만 하는 수준을 넘어 파일을 읽고, 데이터베이스를 조회하고, 개발 도구를 다루고, 업무 앱과 연결될 수 있게 해주는 연결 규칙이다.Anthropic 공식 문서에서는 MCP를 “AI 애플리케이션을 위한 USB-C 포트”에 비유한다. USB-C가 여러 기기와 주변기기를 하나의 방식으로 연결하듯, MCP는 AI 모델과 다양한 데이터·도구를 표준화된 방식으로 연결한다. MCP는 ..

AI 코딩 에이전트가 무엇인지, 기존 코드 자동완성과 어떤 차이가 있는지 초보자도 이해할 수 있게 정리했습니다. 실제 개발 업무에서 맡길 수 있는 일과 주의할 점까지 함께 설명합니다. AI 코딩 에이전트는 단순히 코드를 추천하는 도구가 아닙니다. 개발자가 목표를 주면 코드베이스를 읽고, 파일을 수정하고, 테스트를 실행하며, 경우에 따라 PR까지 제안하는 AI 개발 도구에 가깝습니다.기존 코드 자동완성이 “다음 줄을 추천하는 도구”였다면, AI 코딩 에이전트는 “작업을 맡길 수 있는 도구”에 가깝습니다.2026년 5월 기준으로 Claude Code, Cursor Agent, OpenAI Codex, GitHub Copilot coding agent 같은 도구들이 이 흐름을 대표합니다. 이들은 단순히 코드를..