AI 코딩 에이전트란?
Claude Code·Codex·Gemini CLI
차이 쉽게 정리★
ChatGPT로 코드를 만들어본 적이 있다면 이런 생각을 해본 적 있을 거예요.
“이제는 그냥 코드만 물어보는 게 아니라, AI가 직접 프로젝트를 고쳐주는 시대인가?”
예전에는 AI에게 코딩을 맡긴다고 하면 보통 이런 방식이었어요.
“엑셀 VBA 코드 만들어줘.”
“구글시트 Apps Script 오류 고쳐줘.”
“HTML 버튼이 작동하지 않는 이유 알려줘.”
이런 식으로 질문하면 AI가 코드 예시를 만들어주거나 오류 원인을 설명해줬죠.
그런데 최근에는 AI 코딩 에이전트라는 표현이 자주 나와요.
Claude Code, OpenAI Codex, Gemini CLI 같은 도구들이 대표적이에요.
처음 보면 이름부터 헷갈립니다.
Claude Code는 Claude랑 뭐가 다를까?
Codex는 ChatGPT 안에 있는 기능일까, 별도 도구일까?
Gemini CLI는 개발자만 쓰는 터미널 도구일까?
일반 직장인이 업무 자동화할 때도 쓸 일이 있을까?
결론부터 말하면, AI 코딩 에이전트는 단순히 코드 한 줄을 알려주는 AI가 아니라, 코드베이스를 읽고 수정하고 테스트 흐름까지 도와주는 AI 도구라고 보면 쉬워요.
다만 모든 사람이 처음부터 코딩 에이전트를 쓸 필요는 없어요.
짧은 코드 질문은 ChatGPT 같은 일반 AI 대화 도구로 충분하고, 여러 파일을 함께 수정하거나 실제 프로젝트를 고쳐야 할 때 AI 코딩 에이전트가 더 유용합니다.
이번 글에서는 AI 코딩 에이전트가 무엇인지, Claude Code·Codex·Gemini CLI는 어떻게 다른지, 그리고 엑셀·구글시트·업무 자동화 사용자 입장에서는 어떤 기준으로 선택하면 좋은지 쉽게 정리해볼게요.
1. AI 코딩 에이전트란?
AI 코딩 에이전트는 사용자의 요청을 바탕으로 코딩 작업을 도와주는 AI 도구예요.
일반적인 AI 코딩 질문과 다른 점은 작업 범위가 더 넓다는 데 있어요.
일반 ChatGPT식 코딩 질문은 보통 이런 느낌이에요.
코드 한 부분 설명
짧은 함수 작성
오류 메시지 뜻 해석
엑셀 VBA 예시 생성
구글시트 Apps Script 초안 작성
HTML, CSS, JavaScript 코드 샘플 만들기
반면 AI 코딩 에이전트는 이런 작업에 더 가깝습니다.
기존 코드 파일 읽기
여러 파일을 함께 이해하기
버그 원인 찾기
수정할 부분 제안하기
실제 코드 수정하기
테스트 방법 정리하기
변경 전후 차이 확인하기
개발 흐름을 단계별로 진행하기
쉽게 말하면, 일반 AI가 **“코딩 질문에 답하는 도구”**라면, AI 코딩 에이전트는 **“코딩 작업을 함께 진행하는 도구”**에 가까워요.
2. 그냥 ChatGPT에 코드 물어보는 것과 뭐가 다를까?
이 차이를 이해하면 훨씬 쉬워요.
예를 들어 구글시트 자동화가 필요하다고 해볼게요.
ChatGPT에는 이렇게 물어볼 수 있어요.
“구글시트에서 J열 값에 따라 같은 이름의 시트로 행을 복사하는 Apps Script 코드를 만들어줘.”
이 경우 ChatGPT는 코드 초안을 만들어줄 수 있어요.
그런데 이미 사용 중인 Apps Script 파일이 있고, 그 안에서 중복 복사 오류가 생긴다면 상황이 조금 달라져요.
이때는 단순 코드 초안보다 아래 작업이 더 중요합니다.
기존 코드가 어떤 순서로 실행되는지 파악
중복 복사가 발생하는 위치 찾기
기존 기능은 유지하면서 수정
대상 시트가 없을 때 처리
샘플 데이터로 테스트
데이터가 중복으로 쌓이지 않는지 확인
이런 작업은 프로젝트 흐름을 이해하고 수정하는 방식이 필요해요.
AI 코딩 에이전트는 바로 이런 쪽에 더 잘 맞습니다.
3. Claude Code는 어떤 도구인가요?
Claude Code는 Anthropic의 Claude를 코딩 작업에 활용하는 도구예요.
쉽게 말하면, Claude의 코드 이해력과 긴 맥락 처리 능력을 개발 작업에 연결한 형태라고 보면 됩니다.
Claude Code는 특히 이런 작업에 잘 맞아요.
기존 코드베이스 이해
기능 추가 방향 정리
버그 수정
리팩터링
테스트 코드 작성
프로젝트 구조 설명
여러 파일 흐름 파악
Claude Code의 장점은 긴 코드 맥락을 읽고 설명하는 데 강한 편이라는 점이에요.
그래서 “이 코드가 왜 이렇게 짜여 있는지”, “어디를 고치면 안전한지”, “수정 전에 구조를 먼저 설명해달라”는 요청에 잘 맞습니다.
예를 들어 이렇게 요청할 수 있어요.
복사해서 쓰는 프롬프트-------------------------------------------------------------------------------------
이 프로젝트 구조를 먼저 설명해줘.
특히 아래 기준으로 정리해줘.
주요 파일 역할
데이터가 흐르는 순서
사용자가 입력하는 부분
오류가 발생할 가능성이 큰 부분
기능을 추가하려면 어느 파일부터 봐야 하는지
초보자가 수정하면 위험한 부분
아직 코드를 수정하지 말고, 먼저 구조 설명만 해줘.
----------------------------------------------------------------------------------------------------------------
이런 식으로 요청하면 바로 코드를 고치기보다, 먼저 구조를 이해하는 데 도움이 돼요.
4. OpenAI Codex는 어떤 도구인가요?
OpenAI Codex는 ChatGPT 계정과 연결해 사용할 수 있는 코딩 에이전트예요.
단순히 코드 예시를 만드는 것보다 코드를 작성하고, 검토하고, 수정하고, 배포 흐름까지 도와주는 도구에 가깝습니다.
Codex는 이런 작업에 잘 맞아요.
코드 작성
코드 리뷰
버그 수정
기존 코드 개선
여러 파일 수정
테스트 방법 안내
프로젝트 단위 작업
업무 자동화 코드 점검
업무 사용자 입장에서는 Codex를 이렇게 이해하면 쉬워요.
ChatGPT가 코드 질문에 답해주는 도구라면, Codex는 실제 코드 작업을 더 깊게 진행하는 도구예요.
예를 들어 엑셀 VBA나 구글시트 Apps Script를 다룰 때 이런 식으로 요청할 수 있어요.
복사해서 쓰는 프롬프트-------------------------------------------------------------------------------------
아래 업무 자동화 코드를 수정하고 싶어.
현재 문제:
구글시트에서 J열 값에 따라 같은 이름의 시트로 행을 복사해야 하는데, 같은 행이 대상 시트에 두 번 들가.
원하는 결과:
전체 시트에 새 행을 입력하면 J열 값과 같은 이름의 시트에 해당 행이 한 번만 반영되게 하고 싶어.
조건:
기존 열 순서는 유지할 것
대상 시트가 없으면 자동으로 만들 것
같은 행이 중복 복사되지 않게 할 것
수정 전 원인을 먼저 설명할 것
수정한 부분에 주석을 달 것
테스트 방법도 단계별로 알려줄 것
----------------------------------------------------------------------------------------------------------------
이런 요청은 단순 코드 생성보다 기존 코드 수정에 가까워요.
그래서 Codex 같은 코딩 에이전트가 더 잘 맞을 수 있습니다.
5. Gemini CLI는 어떤 도구인가요?
Gemini CLI는 Google이 공개한 터미널 기반 AI 에이전트예요.
CLI는 Command Line Interface의 줄임말이에요.
쉽게 말하면 마우스로 클릭하는 화면이 아니라, 명령어를 입력하는 터미널에서 사용하는 도구예요.
Gemini CLI는 이런 작업에 사용할 수 있어요.
터미널에서 코드 질문하기
프로젝트 파일 살펴보기
코드 수정 도움받기
간단한 앱 초안 만들기
개발 환경에서 바로 AI에게 요청하기
반복 작업 자동화하기
다만 일반 직장인 입장에서는 CLI라는 말 자체가 조금 낯설 수 있어요.
터미널, 명령어, npm 설치 같은 흐름이 익숙하지 않다면 처음 진입 장벽이 있습니다.
그래서 Gemini CLI는 아래 사용자에게 더 잘 맞아요.
터미널 사용이 익숙한 사람
개발 환경을 직접 세팅할 수 있는 사람
Google 생태계와 Gemini를 함께 쓰고 싶은 사람
오픈소스 도구를 직접 설치해서 써보고 싶은 사람
클라우드나 개발 도구 연결까지 실험해보고 싶은 사람
또 한 가지 주의할 점이 있어요.
Google은 2026년에 Gemini CLI를 더 에이전트 중심의 Antigravity CLI로 전환한다고 안내했어요.
그래서 지금 새로 배우는 사람이라면 Gemini CLI만 단독으로 보기보다, Gemini CLI에서 Antigravity CLI로 이어지는 흐름도 함께 확인하는 게 좋아요.
6. Claude Code·Codex·Gemini CLI 차이 한눈에 보기
세 도구를 아주 쉽게 나누면 이렇게 볼 수 있어요.
Claude Code: 코드 구조 이해와 긴 맥락 설명에 강한 코딩 도우미
Codex: ChatGPT 계정과 연결해 실제 코드 작성·수정·검토에 쓰기 좋은 코딩 에이전트
Gemini CLI: 터미널에서 Gemini를 직접 활용하는 오픈소스형 코딩 에이전트 흐름
업무 사용자 기준으로 보면 이렇게 정리할 수 있어요.
7. 직장인 업무 자동화에는 무엇이 좋을까?
일반 직장인이 가장 많이 하는 코딩 관련 작업은 전문 개발보다 업무 자동화에 가까워요.
예를 들면 이런 작업이에요.
엑셀 VBA 매크로 만들기
구글시트 Apps Script 수정하기
CSV 파일 자동 정리
폴더 안 파일명 일괄 변경
간단한 HTML 계산기 만들기
업무용 대시보드 초안 만들기
반복 보고서 양식 자동화
데이터 정리용 Python 스크립트 만들기
이 경우 처음부터 복잡한 코딩 에이전트를 쓸 필요는 없어요.
추천 순서는 이렇게 보면 됩니다.
ChatGPT로 먼저 코드 초안 만들기
오류가 생기면 오류 메시지와 현재 코드를 함께 질문하기
코드가 길어지거나 파일이 여러 개가 되면 Codex나 Claude Code 검토
터미널 기반 작업이 필요하면 Gemini CLI 또는 후속 도구 흐름 확인
실제 파일에 적용하기 전 복사본에서 테스트하기
업무 자동화 초보자라면 특히 Codex와 Claude Code 쪽이 더 현실적일 수 있어요.
Gemini CLI는 강력하지만, 터미널 사용이 익숙하지 않으면 시작 단계에서 막힐 가능성이 있습니다.
8. 도구별 추천 사용 상황
Claude Code를 먼저 써볼 상황
Claude Code는 코드 구조를 깊게 이해해야 할 때 좋습니다.
예를 들어 이런 경우예요.
기존 프로젝트 구조가 헷갈릴 때
여러 파일이 연결되어 있을 때
코드를 바로 수정하기 전에 설명이 필요할 때
버그 원인을 차분히 추적하고 싶을 때
리팩터링 방향을 먼저 검토하고 싶을 때
이럴 때는 Claude Code에 바로 “수정해줘”라고 하기보다 먼저 이렇게 요청하는 게 좋아요.
이 코드 구조를 먼저 설명해줘. 아직 수정하지 말고, 어떤 파일이 어떤 역할을 하는지 정리해줘.
Codex를 먼저 써볼 상황
Codex는 실제 코드 작업을 진행할 때 좋아요.
예를 들어 이런 경우예요.
코드를 작성해야 할 때
기존 코드를 수정해야 할 때
버그를 고쳐야 할 때
테스트 방법까지 받고 싶을 때
ChatGPT 계정 안에서 코딩 작업을 확장하고 싶을 때
업무 자동화 코드를 점검하고 싶을 때
Codex를 쓸 때는 “고쳐줘”보다 아래처럼 요청하는 게 좋아요.
원인을 먼저 설명하고, 기존 기능을 유지하면서 수정한 뒤, 테스트 방법까지 알려줘.
Gemini CLI를 써볼 상황
Gemini CLI는 터미널 기반 작업에 익숙한 사람에게 잘 맞습니다.
예를 들어 이런 경우예요.
명령어 기반 개발 환경을 자주 쓴다
로컬 프로젝트에서 바로 AI에게 요청하고 싶다
Google Gemini를 개발 작업에 연결해보고 싶다
오픈소스 도구를 직접 설치하고 실험하는 게 익숙하다
클라우드, CLI, 에이전트 흐름까지 확장해보고 싶다
하지만 터미널이 낯설다면 처음부터 Gemini CLI로 시작하기보다 ChatGPT나 Codex, Claude Code식 작업에 먼저 익숙해지는 게 좋아요.
9. 초보자는 어떤 순서로 접근하면 좋을까?
코딩을 전문적으로 하지 않는 사람이라면 아래 순서가 가장 안전해요.
특히 엑셀, 구글시트, 파일 정리 자동화는 원본 데이터가 바뀔 수 있어요.
10. AI 코딩 에이전트에 요청할 때 좋은 프롬프트
AI 코딩 에이전트에게 요청할 때는 “코드 만들어줘”보다 구체적으로 설명해야 해요.
아래 구조를 그대로 쓰면 좋아요.
복사해서 쓰는 프롬프트
아래 코딩 작업을 도와줘.
작업 목적:
여기에 만들고 싶은 기능을 입력
현재 상황:
현재 사용 중인 도구와 파일 구조를 설명
현재 문제:
오류 메시지 또는 원하는 대로 작동하지 않는 부분 입력
원하는 결과:
최종적으로 어떻게 작동해야 하는지 입력
사용 환경:
예: Excel VBA / Google Sheets Apps Script / HTML·CSS·JavaScript / Python / 터미널 CLI
조건:
기존 기능은 최대한 유지할 것
수정 전 원인을 먼저 설명할 것
수정한 부분을 주석으로 표시할 것
전체 코드 또는 변경 위치를 명확히 알려줄 것
테스트 방법을 단계별로 알려줄 것
데이터 삭제나 덮어쓰기 위험이 있으면 먼저 경고할 것
초보자도 이해할 수 있게 설명할 것
확인용 예시:
예시 데이터나 테스트 상황을 입력
이 프롬프트의 핵심은 현재 상황과 원하는 결과를 분리해서 적는 것이에요.
AI가 가장 헷갈리는 부분이 바로 이 지점입니다.
사용자는 “이거 고쳐줘”라고 말하지만, AI 입장에서는 어떤 결과가 정상인지 모르면 정확히 고치기 어려워요.
11. AI 코딩 에이전트를 쓸 때 꼭 조심할 점
AI 코딩 에이전트는 강력하지만, 실무에서는 반드시 조심해야 해요.
특히 아래 작업은 더 주의가 필요합니다.
원본 데이터 수정
파일 삭제
대량 파일명 변경
이메일 자동 발송
고객 정보 처리
회계·계약·인사 데이터 자동화
외부 API 연결
서버 배포
권한이 필요한 작업
이런 작업은 테스트 없이 바로 실행하면 위험해요.
AI가 문법적으로 맞는 코드를 만들어도, 실제 업무 환경에서는 예상과 다르게 작동할 수 있습니다.
그래서 최종 기준은 이거예요.
AI가 코드를 만들어도 실행 책임은 사용자에게 있다.
업무 자동화에서는 이 문장을 꼭 기억해야 합니다.
12. 선택 기준을 한 줄로 정리하면
도구 선택을 너무 어렵게 생각하지 않아도 돼요.
아래 기준으로 보면 됩니다.
짧은 코드 질문: ChatGPT
코드 구조 설명: Claude Code
실제 코드 작성·수정: Codex
터미널 기반 개발 작업: Gemini CLI 또는 후속 CLI 흐름
업무 자동화 초보자: ChatGPT → Codex 순서
기존 프로젝트 분석: Claude Code 또는 Codex
오픈소스·CLI 실험: Gemini CLI 계열
이렇게 나누면 훨씬 덜 헷갈려요.
13. 마무리: AI 코딩 에이전트는 코딩을 대신 책임지는 도구가 아닙니다
AI 코딩 에이전트는 코딩 작업을 훨씬 빠르게 도와줄 수 있어요.
Claude Code는 코드 구조를 이해하고 수정 방향을 잡는 데 유용하고, Codex는 ChatGPT 기반 코딩 작업을 더 깊게 진행하는 데 좋고, Gemini CLI는 터미널 기반 개발 흐름에 잘 맞습니다.
하지만 어떤 도구를 쓰든 핵심은 같아요.
AI가 코드를 대신 책임져주는 것은 아닙니다.
업무 자동화에서는 반드시 아래 순서를 지켜야 해요.
원하는 기능을 구체적으로 설명하기
현재 문제와 오류 메시지 정리하기
기존 코드가 있으면 함께 제공하기
수정 전 원인을 먼저 설명받기
기존 기능이 유지되는지 확인하기
복사본에서 먼저 테스트하기
데이터 삭제나 덮어쓰기 위험 확인하기
최종 결과를 직접 검산하기
AI 코딩 에이전트는 코딩을 대신해주는 마법 도구가 아니라,
코드를 더 빠르고 안전하게 작성·수정하도록 도와주는 협업 도구예요.★
이 기준으로 접근하면 Claude Code, Codex, Gemini CLI 같은 도구를 훨씬 현실적으로 활용할 수 있습니다.
◆ 같이 보면 좋은 글
