OpenAI Codex 실무 기능 총정리, Skill·MCP·Subagent·AGENTS.md 활용법

OpenAI Codex를 처음 보면 그냥 코딩을 도와주는 채팅창처럼 느껴질 수 있습니다.
그런데 조금만 써보면 느낌이 달라요.
질문에 답하는 수준을 넘어서, 프로젝트를 읽고 수정하고 실행 흐름까지 이어가는 AI 코딩 업무 에이전트에 더 가깝습니다.

 

 

특히 실무에서 Codex를 제대로 쓰려면 기능 이름만 외우기보다, 어떤 작업을 어디에 맡길지 나누는 게 중요합니다.
반복 지시는 Skill, 외부 도구 연결은 MCP, 큰 작업 분할은 Subagent, 프로젝트 규칙은 AGENTS.md, 권한 관리는 Approval Mode로 보면 훨씬 정리가 쉽습니다.

 

 

Codex는 “코드 짜줘” 한마디로 끝나는 도구가 아닙니다.
반복 업무를 구조화하고, 프로젝트 규칙을 고정하고, 실행 권한을 조절할 때 훨씬 강해집니다.

 

 

Skill은 반복 지시를 줄여주는 기능입니다

Skill은 자주 쓰는 작업 방식을 미리 저장해두는 기능으로 이해하면 쉽습니다.
예를 들어 블로그 글 형식, 코드 리뷰 기준, 리포트 작성 순서처럼 매번 같은 말을 반복하는 작업이 있다면 Skill로 묶어두면 좋습니다.
그다음부터는 짧게 요청해도 정해둔 방식에 맞춰 결과가 나옵니다.

 

 

여기서 포인트는 내 개인 작업 스타일을 저장한다는 점입니다.
프로젝트가 바뀌어도 반복해서 쓰는 말투, 검토 기준, 출력 형식이 있다면 Skill이 잘 맞습니다.
콘텐츠 제작, 코드 리뷰, 문서 정리처럼 패턴이 뚜렷한 작업일수록 체감이 커요.

 

 

MCP는 최신 자료와 외부 도구를 연결합니다

MCP는 Codex가 외부 도구나 문서에 접근할 수 있게 해주는 연결 방식입니다.
최신 개발 문서, GitHub 이슈, PR, Figma 디자인, Sentry 에러 로그처럼 프로젝트 밖에 있는 정보를 참고해야 할 때 유용합니다.
빠르게 바뀌는 라이브러리나 프레임워크를 다룰 때는 특히 도움이 됩니다.

 

 

예전 문서 기준으로 코드를 짜면 지금은 안 되는 방식이 섞일 수 있습니다.
이럴 때 MCP로 현재 문서나 실제 프로젝트 이슈를 연결하면 틀린 전제에서 출발하는 실수를 줄일 수 있습니다.
다만 연결 과정에는 인증과 권한 설정이 들어갈 수 있으니 처음에는 필요한 도구부터 하나씩 붙이는 게 좋습니다.

 

 

Subagent는 큰 작업을 역할별로 나눌 때 씁니다

Subagent는 큰 작업을 여러 관점으로 나눠서 처리할 때 쓰기 좋습니다.
예를 들어 코드 리뷰를 한다면 한쪽은 보안 취약점, 다른 한쪽은 테스트 커버리지, 또 다른 쪽은 가독성과 유지보수성을 보는 식입니다.
한 명에게 모든 걸 맡기는 것보다 역할을 나누면 놓치는 부분이 줄어듭니다.

 

 

하지만 처음부터 무조건 쓸 필요는 없습니다.
Subagent는 작업이 커질수록 유용하지만, 그만큼 토큰 사용량과 흐름도 복잡해질 수 있습니다.
작은 수정이나 단순 질문에는 과하고, 큰 리뷰, 복잡한 분석, 여러 관점이 필요한 작업에서 꺼내 쓰는 편이 좋습니다.

 

 

Subagent는 멋있어 보여서 쓰는 기능이 아니라,
혼자 보기 어려운 큰 작업을 나눠 보기 위한 기능입니다.

 

 

AGENTS.md는 프로젝트 규칙을 고정합니다

AGENTS.md는 Codex에게 “이 프로젝트에서는 이렇게 일해줘”라고 알려주는 규칙 파일입니다.
테스트 명령어, 코드 스타일, 건드리면 안 되는 파일, 답변 형식, 배포 전 체크리스트 같은 내용을 넣을 수 있습니다.
프로젝트마다 기준이 다르다면 이 파일이 정말 중요해집니다.

 

 

Skill과 헷갈릴 수 있는데, 구분은 간단합니다.
Skill은 개인 작업 방식이고, AGENTS.md는 프로젝트 고유 규칙입니다.
여러 프로젝트를 동시에 다루거나 팀 단위로 작업한다면 AGENTS.md를 잘 정리해두는 것만으로도 요청이 훨씬 덜 흔들립니다.

 

 

Approval Mode는 안전장치입니다

Codex가 파일을 수정하거나 명령어를 실행할 수 있다면 편하긴 하지만, 그만큼 조심해야 합니다.
Approval Mode는 Codex가 어디까지 스스로 행동할 수 있는지 정하는 권한 설정입니다.
읽기만 허용할지, 작업 폴더 안 수정만 허용할지, 명령어 실행이나 네트워크 접근 전에 승인을 받을지 조절할 수 있습니다.

 

 

처음 쓰는 분이라면 전체 허용부터 켜는 것보다 수정과 실행 전에 승인받는 방식으로 시작하는 게 안전합니다.
AI가 의도와 다르게 파일을 바꾸거나, 필요 없는 명령을 실행하는 상황을 막을 수 있기 때문입니다.
익숙해진 뒤 작업 성격에 따라 권한을 조금씩 넓혀도 늦지 않습니다.

 

 

비개발자도 Codex를 쓸 수 있을까

Codex가 코딩 도구로 알려져 있지만, 꼭 개발자만 쓰는 건 아닙니다.
자료 정리, CSV 데이터 정돈, 회의 브리프 작성, 보고서 초안, 슬라이드 구조 잡기처럼 비개발 업무에도 활용할 수 있습니다.
중요한 건 “무엇을 해줘”가 아니라 어떤 자료를 바탕으로 어떤 결과물을 만들지를 구체적으로 맡기는 것입니다.

 

 

다만 결과물 검토는 꼭 필요합니다.
Codex가 초안을 빠르게 만들어줄 수는 있지만, 최종 판단과 책임까지 대신해주지는 않습니다.
특히 회사 자료, 고객 정보, 코드 변경, 배포 작업처럼 민감한 일은 승인 단계와 검수 기준을 반드시 세워두는 게 좋습니다.

 

 

처음 시작한다면 이 순서가 좋습니다

처음부터 Skill, MCP, Subagent, AGENTS.md, Approval Mode를 모두 쓰려고 하면 오히려 복잡합니다.
먼저 반복해서 시키는 작업을 Skill로 저장하고, 프로젝트 규칙은 AGENTS.md로 정리해보세요.
그다음 최신 문서나 외부 이슈가 필요한 작업에서 MCP를 연결하면 됩니다.

 

 

큰 리뷰나 분석이 필요해졌을 때 Subagent를 써보고, 전체 과정에서는 Approval Mode로 안전장치를 걸어두면 좋습니다.
정리하면 Codex 실무 활용의 핵심은 반복은 저장하고, 규칙은 고정하고, 외부 정보는 연결하고, 위험한 실행은 승인받는 것입니다.
이 구조만 잡아도 Codex를 단순 채팅이 아니라 실무 파트너처럼 활용할 수 있습니다.