코딩 에이전트 다섯 종, 설정 형식은 대부분 호환되고 승인 기본값은 다릅니다

핵심 요약

먼저 알아 둘 용어

• AGENTS.md는 저장소에 두는 마크다운 지시 파일입니다. 빌드 명령, 코드 규칙처럼 에이전트가 작업 전에 알아야 할 내용을 적습니다. OpenAI가 만들었고, 2025-12-09 Linux Foundation이 세운 Agentic AI Foundation(AAIF)에 MCP와 함께 기부됐습니다.
• Agent Skills는 SKILL.md 파일 하나와 선택적인 스크립트·참고 문서로 이뤄진 폴더 형식의 공개 표준입니다(agentskills.io). 에이전트는 평소에 스킬의 이름과 설명만 보고, 필요할 때 본문을 읽습니다.
• MCP(Model Context Protocol)는 에이전트가 외부 도구와 데이터에 붙는 방식을 정한 공개 프로토콜입니다. 에이전트에 도구를 제공하는 프로그램을 MCP 서버라고 부릅니다.
• 승인 모드는 에이전트가 파일 수정·셸 명령·네트워크 요청 같은 행동을 하기 전에 사람에게 묻는지를 정하는 설정입니다. 이 글에서 분류기는 사람 대신 그 행동을 검토하는 별도의 모델을 말합니다.
• 샌드박스는 운영체제가 강제하는 실행 경계입니다. 셸 명령이 쓸 수 있는 경로와 접속할 수 있는 네트워크를 제한합니다. 승인 모드가 "묻는가"를 정한다면, 샌드박스는 "물어보지 않고 실행된 명령이 어디까지 닿는가"를 정합니다.

확인 방법

2026-10-06에 다섯 도구의 공식 문서를 원문으로 받아 대조했습니다. 요약 도구를 거치지 않으려고 Claude Code 문서는 Markdown 원본(주소 끝의 .md), Codex 문서는 learn.chatgpt.com의 Markdown 원본, GitHub 문서는 docs.github.com의 본문 API, Gemini CLI 문서는 GitHub 저장소의 원본 파일, Cursor 문서는 cursor.com의 Markdown 원본으로 읽었습니다. 각 표의 칸은 이 문서들에 적힌 문장에서 옮겼습니다.

버전 기준은 같은 날 npm 레지스트리에 공개돼 있던 가장 새 버전입니다. Claude Code 2.1.290, Codex CLI 0.160.1, Gemini CLI 0.62.0입니다. Cursor는 문서 안의 변경 기록(3.5·3.6)을 기준으로 삼았습니다. GitHub Copilot은 IDE·CLI·GitHub.com 여러 곳에서 쓰지만, 실행 위치와 격리를 비교한 부분은 GitHub.com에서 작업을 맡기는 Copilot cloud agent입니다. 이 기능의 문서 주소는 coding-agent로 남아 있고 본문 이름은 cloud agent입니다.

성능·정확도·속도는 비교하지 않았습니다. 벤치마크 수치를 어떻게 읽어야 하는지는 에이전트 평가 글에, 도구별 사용률은 사용률 조사 비교 글에 따로 정리했습니다.

지시 파일: AGENTS.md는 네 곳이 바로 읽습니다

저장소에 지시를 남기는 파일은 도구마다 이름이 달랐지만, 2026-10-06 기준 다섯 도구 모두 AGENTS.md를 읽을 수 있습니다. 차이는 어떤 조건에서 읽는가입니다.

여기서 실무에서 주의할 지점은 두 가지입니다. 첫째, Claude Code는 CLAUDE.md가 하나라도 있으면 AGENTS.md를 건너뜁니다. 개인용 CLAUDE.local.md를 하나 추가해도 마찬가지입니다. 문서는 이 경우 CLAUDE.md 첫 줄에 @AGENTS.md를 넣어 가져오라고 안내합니다. 2.1.281 전에는 텔레메트리를 끈 세션 같은 일부 세션에서 AGENTS.md를 읽지 않았는데, 이 문제는 따로 정리한 글이 있습니다. 둘째, Codex 사용자가 쓰는 AGENTS.override.md는 Codex 전용입니다. Claude Code 문서는 이 파일을 읽지 않는다고 명시합니다.

스킬: 같은 표준을 따르지만 폴더는 하나로 모이지 않습니다

다섯 도구의 문서는 모두 Agent Skills를 공개 표준이라고 소개합니다. 표준이 정한 SKILL.md 머리말(frontmatter, 파일 맨 앞에 YAML로 쓰는 메타데이터) 필드는 여섯 개이고, 그중 name과 description이 필수입니다. name은 소문자·숫자·하이픈으로 64자 이내여야 하고 폴더 이름과 같아야 합니다.

그런데 각 도구가 프로젝트 스킬을 찾는 폴더는 다릅니다.

.agents/skills/는 Codex·Copilot·Cursor·Gemini CLI 네 곳의 문서에 있지만, Claude Code의 스킬 위치 표에는 없습니다. .claude/skills/는 Claude Code·Copilot·Cursor 세 곳의 문서에 있고, Codex와 Gemini CLI 문서에는 없습니다. 그래서 문서에 적힌 동작만 놓고 보면 다섯 도구가 모두 읽는 프로젝트 폴더는 하나도 없습니다.

MCP: 지원은 같고, 설정 파일과 제약이 다릅니다

다섯 도구 모두 MCP 서버를 붙일 수 있습니다. 서버 정의를 적는 자리는 도구마다 다릅니다.

같은 MCP 서버를 쓰더라도 도구마다 설정 형식이 JSON, TOML, 웹 설정으로 달라서, 지시 파일이나 스킬처럼 설정 파일 하나를 저장소에 두고 여러 도구가 함께 쓰는 방식은 아직 어렵습니다. 표의 "—"는 이 글이 본 문서 범위에서 따로 적을 제약을 확인하지 못했다는 뜻입니다.

로컬 승인 기본값: 같은 "자동"이 서로 다른 것을 뜻합니다

도구 선택에서 가장 크게 다른 부분입니다. 에이전트를 내 컴퓨터에서 실행할 때 기본으로 누가 행동을 승인하는지, 셸 명령이 샌드박스 안에서 실행되는지를 정리했습니다.

표에서 "자동"이라는 말이 세 번 나오지만 가리키는 것은 다릅니다.

• Claude Code의 auto는 사람이 하던 확인을 분류기가 대신합니다. 셸 샌드박스는 기본으로 꺼져 있으므로, 분류기가 통과시킨 명령에는 운영체제 수준의 경계가 따로 없습니다. 문서도 샌드박스나 컨테이너를 더하면 방어가 한 겹 늘어난다고 적습니다.
• Codex의 auto_review에서는 샌드박스가 먼저 파일 쓰기와 네트워크 접근을 제한하고, 그 경계를 넘으려는 요청만 검토 에이전트가 확인합니다. 기본값은 사람이 검토하는 쪽입니다.
• Cursor의 Auto-review는 둘을 섞습니다. 샌드박스에서 돌릴 수 있는 셸 명령은 샌드박스로, 돌릴 수 없는 명령과 MCP·Fetch 호출은 분류기로 보냅니다.

그래서 이 표를 읽을 때 물어야 할 것은 "자동 승인이 있는가"가 아니라 "분류기가 잘못 통과시켰을 때 무엇이 남는가"입니다. 샌드박스가 같이 켜져 있으면 쓰기 경로와 네트워크 제한이 남고, 꺼져 있으면 사용자 계정 권한 전체가 남습니다. 샌드박스가 실제로 무엇을 막고 무엇을 못 막는지는 에이전트 샌드박스 글에서 측정 논문으로 다뤘습니다.

클라우드 실행: 승인 대신 환경이 경계가 됩니다

다섯 도구 중 네 곳은 작업을 클라우드에 맡기는 실행 방식이 있습니다. 클라우드에서는 사람이 실시간으로 승인하지 않는 경우가 많으므로, 환경을 어떻게 격리하고 네트워크와 비밀값을 어떻게 다루는지가 경계가 됩니다.

두 가지가 눈에 띕니다. Cursor 문서는 Cloud Agents가 "승인을 묻지 않는다"고 명시합니다. 그리고 Copilot 문서는 방화벽의 한계를 직접 적었습니다. MCP 서버 프로세스는 방화벽이 직접 막지 않고, 정교한 공격은 방화벽을 우회할 수 있다는 것입니다. 클라우드 환경에 넣는 비밀값과 네트워크 허용 범위는 에이전트가 그 안에서 무엇이든 할 수 있다는 전제로 정하는 편이 문서의 설명과 맞습니다.

요금 단위: 다섯 도구가 다섯 가지로 셉니다

가격은 자주 바뀌므로 금액보다 무엇을 세는지를 적었습니다. 모두 2026-10-06에 확인한 내용입니다.

요청 수, 토큰, 크레딧, 구독 한도가 섞여 있어서 같은 작업의 비용을 도구끼리 바로 비교할 수 없습니다. 비교하려면 자기 작업 몇 개를 각 도구에서 실행해 사용량 화면의 값을 직접 보는 수밖에 없습니다. 이 글은 그 측정을 하지 않았습니다.

6월 초기 노트에서 바뀐 것

이 글은 2026-06-16에 낸 초기 노트를 다시 쓴 것입니다. 초기 노트의 서술 가운데 오늘 공식 문서와 대조한 결과를 적습니다.

오늘 할 수 있는 것

위 문서 대조에서 직접 따라 나오는 것만 적었습니다.

아직 결론이 아닌 것

• 이 글은 2026-06-16 초기 노트를 다시 쓴 것입니다. 초기 노트는 블로그·비교 글을 주로 인용했고, 상당수 수치의 1차 출처를 대조하지 않았습니다. 이번 판은 각 개발사의 공식 문서와 표준 문서만 근거로 삼았고, 대조하지 못한 서술은 뺐습니다.
• 자체 측정은 하지 않았습니다. 모든 칸은 문서에 적힌 동작입니다. 예를 들어 Claude Code가 .agents/skills/를 실제로 읽는지, Codex가 .claude/skills/를 읽는지는 실행해서 확인하지 않았습니다. 문서에 없는 경로가 실제로는 동작할 수도 있고, 그 반대일 수도 있습니다.
• 분류기의 정확도는 알 수 없습니다. 세 개발사 모두 분류기가 틀릴 수 있다고 적었지만, 얼마나 자주 틀리는지는 공개 문서에서 확인하지 못했습니다. 이 글은 분류기 방식의 우열을 말하지 않습니다.
• 다섯 도구만 봤습니다. 초기 노트에 있던 Windsurf, AWS Kiro, Google Antigravity, Jules, Devin, Aider, Cline, OpenCode는 이번에 공식 문서로 대조하지 않아 뺐습니다. 이 도구들이 덜 중요하다는 뜻이 아닙니다.
• Copilot은 cloud agent 위주로 봤습니다. AGENTS.md·스킬 지원은 Copilot의 여러 실행 환경에 걸친 문서를 근거로 했지만, 승인 방식은 Copilot CLI·IDE 쪽을 대조하지 않았습니다.
• 모델 성능과 작업 품질은 비교하지 않았습니다. 같은 작업에서 어느 도구가 더 나은 결과를 내는지는 이 글로 알 수 없습니다.
• 기본값과 요금은 빨리 바뀝니다. Claude Code의 auto 기본값은 2.1.283부터, Cursor의 Auto-review 권장 기본값은 3.6부터입니다. 이 글의 버전 기준(Claude Code 2.1.290, Codex CLI 0.160.1, Gemini CLI 0.62.0)보다 새 버전에서는 표가 맞지 않을 수 있습니다.

참고자료

공식 문서는 Markdown 원본이나 본문 API로 받아 2026-10-06에 대조했습니다.

2026-06-16 초기 노트를 2026-10-06에 현재 기준으로 다시 썼습니다. 초기 노트의 벤치마크·시장 수치와 2차 출처 인용은 1차 출처로 대조하지 못해 뺐습니다. 기본값이나 요금이 바뀌면 이 글을 고치고 개정 날짜를 적겠습니다.