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

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

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

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