Feb 13, 2026

마지막 업데이트 Jun 30, 2026

Claude Code와 Cursor 실무 비교: 터미널 에이전트 도입기와 세팅 팁

요즘 개발할 때 AI 도구 하나쯤은 다들 쓰고 계실 겁니다. 저 역시 Cursor를 오랫동안 메인 에디터로 쓰다가, 최근 Anthropic에서 내놓은 Claude Code를 개발 워크플로우에 붙여보면서 작업 방식에 꽤 큰 변화를 겪었습니다.

단순히 “이 코드가 무슨 뜻이야?”라고 묻거나 인라인으로 자동 완성을 추천받는 수준을 넘어, 터미널에서 스스로 파일을 뒤적이고 빌드 에러를 읽어서 직접 테스트까지 통과시키는 **‘자율 코딩 에이전트(Autonomous Agent)‘**의 맛을 제대로 보게 되었기 때문인데요.

이번 글에서는 Claude Code를 직접 사용하면서 겪은 필수 설정 팁, 실수하기 쉬운 쉘 권한 보안 문제, 그리고 Cursor나 예전 Codex와 비교했을 때 어떤 작업에서 가장 빛을 발하는지 실무 경험을 바탕으로 공유해 봅니다.

1. Claude Code 설치와 초기 세팅 (`claude doctor`)

Claude Code는 Anthropic이 만든 터미널 CLI 기반의 에이전트입니다. Node.js 환경에서 글로벌 npm 패키지로 설치해 사용합니다.

시스템 요구 사항

Node.js: v18 이상
지원 OS: macOS, Linux, Windows (Windows는 WSL 환경에서 돌리는 것이 훨씬 매끄럽습니다)
Git: 활성화된 git 저장소 안에서 작업할 때 에이전트가 브랜치와 변경점을 훨씬 정확하게 추적합니다.

설치 및 계정 연동

터미널을 열고 아래 명령을 실행합니다.

# 1. 글로벌 패키지 설치 (권한 꼬임을 방지하기 위해 가급적 sudo 없이 실행 권한을 잡는 편이 좋습니다)
npm install -g @anthropic-ai/claude-code

# 2. 설치 확인
claude --version

# 3. 로컬 런타임 환경 진단 (설치 후 제일 먼저 돌려봐야 하는 명령입니다)
claude doctor

여기서 claude doctor는 꼭 한번 돌려보시길 권합니다. Git 설정, 네트워크 통신, 인증 토큰 유효성 등을 한 번에 훑어주기 때문에, 초반에 “왜 연결이 안 되지?” 하고 삽질하는 시간의 90%를 줄여줍니다.

진단이 깔끔하게 끝나면 터미널에 claude를 입력합니다. 브라우저가 열리면서 Anthropic 콘솔 계정 인증 창이 뜨고, 승인하면 바로 대화형 세션이 열립니다.

2. 쉘 실행 권한과 보안: 자동 승인은 주의하세요

Claude Code가 기존 챗봇들과 가장 다른 점은 개발자 대신 로컬에서 직접 쉘 명령을 제안하고 실행할 수 있다는 점입니다.

npm run test를 돌려서 깨진 테스트를 확인하고, 파일을 수정하고, git commit까지 알아서 해줍니다. 편하긴 정말 편한데, 그만큼 보안과 안정성에 신경을 써야 합니다.

[Claude Code의 쉘 실행 흐름]
개발자 요청 ➔ 에이전트가 실행할 쉘 명령 제안 ➔ 개발자가 눈으로 확인 후 승인(Y/N) ➔ 쉘 실행 및 결과 피드백

💡 실무 팁: 자동 실행(-y) 옵션은 되도록 아끼세요

Claude Code에는 명령을 물어보지 않고 바로 실행해 주는 -y나 --approve 같은 플래그가 있습니다.

단순한 개인 토이 프로젝트라면 편할 수 있지만, 프로덕션 저장소에서는 절대 권장하지 않습니다. 에이전트가 빌드 캐시를 지운다며 엉뚱한 폴더를 rm -rf로 날려버리거나, 예기치 않게 브랜치를 강제 푸시하는 대형 사고가 날 수 있거든요. 터미널에 뜨는 쉘 명령어는 꼭 눈으로 한 번 훑고 y를 누르는 습관을 들이는 것이 좋습니다.

3. 손에 익혀두면 작업 속도 2배 되는 슬래시 명령어

대화형 쉘에 들어가면 일반 대화 외에도 작업 컨텍스트를 제어하는 슬래시(/) 명령어들을 쓸 수 있습니다.

매일 쓰는 필수 슬래시 명령어

/init: 저장소 루트를 분석해서 Claude Code가 참고할 수 있는 기본 가이드 문서를 만듭니다.
/clear: 대화 스택과 컨텍스트를 싹 비워줍니다. (토큰 비용 아끼는 일등 공신)
/search <query>: 프로젝트 내 관련 코드를 빠르게 키워드로 탐색합니다.
/exit: 세션을 종료하고 일반 터미널로 돌아옵니다.

💡 한 줄 명령(One-shot)으로 뚝딱 처리하기

대화 세션에 굳이 들어가지 않고도, 평소 쓰던 bash/zsh 터미널에서 한 줄로 지시를 던질 수 있습니다. CI 스크립트나 간단한 리팩토링 때 매우 유용합니다.

# 예시: 안 쓰는 import 정리하고 빌드 확인하기
claude "src/pages/에 있는 미사용 import 정리하고 npm run build 돌려서 깨지는 거 없는지 확인해줘"

4. Claude Code vs Cursor vs Codex: 무엇을 언제 써야 할까?

어떤 도구가 절대적으로 우월하다기보다는, 작업 성격에 따라 잘 맞는 툴이 다릅니다.

도구	특화된 영역	가장 잘 맞는 상황
Claude Code	터미널 기반의 복합 작업 위임	테스트 돌리고 에러 고치는 자율 디버깅, 인프라/빌드 작업
Cursor	에디터 중심의 빠른 인터랙션	타이핑 중 인라인 탭 완성, 파일 내 코드 수정, UI 작업
OpenAI Codex	API 기반 원형 모델 (히스토리)	초기 주석-코드 변환 및 SDK 기반 툴 제작

Cursor가 딱 맞는 경우

코드를 직접 치면서 실시간 탭(Tab) 자동 완성을 원할 때
현재 열려 있는 파일이나 함수 단위의 코드 변경에 집중하고 싶을 때
GUI 에디터 환경이 주는 편리함이 가장 우선일 때

Claude Code가 빛을 발하는 경우

“테스트 전부 돌려서 깨지는 부분 원인 찾고 고쳐줘”처럼 여러 단계의 쉘 실행이 필요할 때
터미널 환경에 익숙한 백엔드, 풀스택, 데브옵스 엔지니어
저장소 전체를 훑으면서 프로젝트 단위의 마이그레이션이나 리팩토링을 해야 할 때

OpenAI Codex는 지금 어떤 의미일까?

Codex는 GitHub Copilot의 시초가 된 기념비적인 모델입니다. 당시에는 4k 토큰 남짓한 작은 컨텍스트 창에 쉘 실행 능력도 없었지만, “자연어 주석을 코드로 바꾼다”는 혁신을 처음 증명했죠. 현대의 Claude Code나 Cursor 같은 도구들은 모두 이 Codex의 발자취 위에서 진화한 결과물입니다.

# 과거 Codex API를 호출하던 전형적인 예시 (code-davinci-002 시절)
import openai

response = openai.Completion.create(
    model="code-davinci-002",
    prompt="# Python function to calculate Fibonacci series
def fib(",
    temperature=0,
    max_tokens=100
)

5. 실전 협업: AGENTS.md로 에이전트 길들이기

AI 에이전트를 실무에서 동료 개발자처럼 활용하려면, 우리 팀의 룰과 약속을 명확히 알려주어야 합니다.

`AGENTS.md` 파일 하나로 퀄리티 높이기

저장소 최상단 루트에 AGENTS.md 파일을 만들어 두고, 아래와 같은 프로젝트 규칙을 적어두세요.

프로젝트에서 사용하는 패키지 매니저 (npm vs pnpm)
컴포넌트 네이밍 규칙 (kebab-case 등)
절대 임의로 건드려서는 안 되는 설정 파일들
커밋 메시지 컨벤션

# AGENTS.md 예시
- 빌드 전 항상 `npm run lint`를 돌려서 린트 에러를 체크할 것
- 새로운 라이브러리를 임의로 `npm install`하지 말고, 기존 의존성 안에서 해결할 것
- 스타일링은 기존 프로젝트에서 쓰이는 전역 CSS 변수를 준수할 것

Claude Code에게 작업을 맡길 때 “루트의 AGENTS.md 컨벤션을 지켜서 작업해줘”라고 한마디만 덧붙이면, 엉뚱한 코드를 짜서 팀원들을 당황하게 만드는 일이 현저히 줄어듭니다.

커밋 전 1차 코드 리뷰 요청하기

내가 작성한 코드를 git commit하기 전에 터미널에서 에이전트에게 가볍게 리뷰를 부탁해 보세요.

claude "방금 수정한 git diff 보고 빠뜨린 예외 처리나 성능상 비효율이 있는지 짚어줘"

혼자 코딩하다 보면 놓치기 쉬운 null 체크나 리소스 해제 누락 같은 자잘한 실수들을 놀라울 정도로 잘 찾아줍니다.

6. 실패를 줄이는 단계별 협업 사이클

Claude Code를 쓸 때 가장 추천하는 작업 흐름은 **“작게 시작해서 검증하며 넓히기”**입니다.

graph TD
    A[작업 요청] --> B[저장소 구조 및 설정 파일 탐색]
    B --> C[소규모 코드 수정 수행]
    C --> D[로컬 검증: npm run build / test]
    D -- 에러 발생 시 --> E[에러 로그 읽고 스스로 디버깅]
    D -- 통과 시 --> F[Git Commit 및 마무리]

상황 파악부터 시키기: “이 프로젝트에서 인증 관련 로직이 어느 파일들에 분산되어 있는지 먼저 찾아줘.”
범위를 좁혀서 수정하기: “한 번에 다 고치지 말고, 우선 auth-helper.ts의 유효성 검사 함수만 수정해줘.”
항상 빌드 검증을 엮기: “수정 후에는 npm run build를 실행해서 컴파일 에러가 없는지 꼭 확인해줘.”

에이전트에게 너무 큰 작업을 한 번에 쥐여주면 코드가 꼬이거나 엉뚱한 환각(Hallucination)이 생기기 쉽습니다. 단계를 쪼개서 빌드 검증을 꼬박꼬박 챙기게 하는 것이 실무 성공의 핵심입니다.

자주 묻는 질문 (FAQ)

Q. Cursor와 Claude Code를 같이 써도 괜찮나요?

완전 추천합니다. 평소에는 Cursor 안에서 코드 자동 완성의 도움을 받으며 손맛 있게 코딩하고, 복잡한 빌드 에러 디버깅이나 패키지 마이그레이션처럼 터미널 작업이 길어질 때는 터미널의 Claude Code에게 맡기면 시너지가 아주 좋습니다.

Q. 쓰다 보면 토큰 비용이 너무 많이 나오지 않을까요?

Claude Code는 리포지토리의 파일들을 읽어 들이기 때문에 대화가 길어질수록 컨텍스트가 쌓여 토큰 소모가 커집니다. 따라서 한 가지 작업이 깔끔하게 끝났다면 망설이지 말고 /clear 명령을 쳐서 대화 메모리를 비워주세요. 이것만 습관화해도 토큰 비용을 절반 이상 아낄 수 있습니다.

함께 읽어보기

정적 웹사이트의 검색 노출과 성능을 잡고 싶다면 Astro 블로그와 SEO 최적화 가이드를 확인해 보세요.
외부 도구와 데이터를 AI에 안전하게 붙이는 표준이 궁금하다면 MCP(Model Context Protocol) 가이드도 추천합니다.

먼저 읽어볼 가이드

검색 유입이 많은 핵심 글부터 이어서 보세요.