Claude Code 사용방법
터미널에 앉은 AI 개발 파트너,
이렇게 씁니다

안녕하세요, 멘토 김부장입니다. 저는 코딩을 마흔 넘어 늦게 시작한 사람이라, 새 도구 이름만 들어도 처음엔 늘 손이 얼어붙곤 했어요. 특히 '터미널'이라는 까만 화면은 저에게 오랫동안 공포의 대상이었습니다. 뭘 잘못 치면 컴퓨터가 폭발이라도 할 것 같았거든요. 그런데 오늘 소개할 Claude Code는, 바로 그 까만 화면을 오히려 '가장 든든한 동료가 앉아 있는 자리'로 바꿔 준 도구입니다.

지난 몇 년간 우리가 AI에게 코딩을 시키던 방식은 대체로 '물어보고 복붙하기'였습니다. 챗봇 창을 열고 "이 코드 왜 에러 나요?"라고 묻고, 답을 복사해서 내 프로젝트에 붙여넣고, 안 되면 또 묻고, 또 붙여넣고… 이 과정을 수십 번 반복했죠. 문제는, 챗봇은 내 프로젝트를 실제로 본 적이 없다는 것입니다. 내 파일이 어디 있는지, 내가 어떤 규칙으로 코드를 짜는지 모른 채, 일반론만 이야기해요. 그래서 붙여넣으면 자꾸 어긋납니다.

Claude Code는 방식이 완전히 다릅니다. 이 친구는 내 프로젝트 폴더 안으로 직접 들어옵니다. 내 파일을 전부 읽고, 필요하면 파일을 직접 고치고, 명령을 실행하고, git까지 다뤄요. 내가 복붙 셔틀이 될 필요가 없습니다. "이렇게 고쳐 줘"라고 말하면, 실제로 손을 대서 끝을 봅니다.

처음 이걸 겪었을 때 저는 좀 얼떨떨했어요. 그동안 AI는 늘 '창 너머의 조언자'였거든요. 아무리 똑똑한 답을 줘도, 그 답을 내 프로젝트에 실제로 적용하는 건 언제나 제 몫이었습니다. 그런데 Claude Code는 그 마지막 '적용'의 단계까지 함께 넘어와 줍니다. 조언자가 아니라 같이 일하는 동료가 된 거죠. 오늘은 이 도구를 어떻게 설치하고, 어떻게 첫 대화를 시작하고, 어떻게 첫 코드 변경까지 해 보는지를, 겁먹지 않게 하나씩 풀어 드릴게요. 코딩을 몰라도, 터미널이 무서워도 괜찮습니다. 저도 그 자리에서 시작했으니까요.

Claude Code는 한마디로 "내 프로젝트 폴더에 같이 앉은, 코드를 직접 만질 수 있는 AI 동료"입니다. 챗봇에게 물어보고 답을 복사해 붙여넣던 시절과 달리, 이 친구는 '직접 손을 대서' 일을 끝냅니다. 내가 할 일은 무엇을 원하는지 말하고, 결과를 검토하고 승인하는 것뿐이에요.

Claude Code가 대체 뭔가요

회사에 아주 유능한 동료가 한 명, 내 옆자리로 왔다고 생각해 봅시다. 이 동료는 내 프로젝트 폴더를 통째로 넘겨받아 "아, 이건 이런 걸 만드는 프로그램이군요" 하고 스스로 파악합니다. 그리고 내가 "여기 이 버튼이 안 눌려요, 좀 봐 주세요"라고 말하면, 자기가 알아서 관련 파일들을 열어 보고, 원인을 찾고, 여러 파일을 넘나들며 고치고, 잘 되는지 확인까지 합니다. 챗봇처럼 '설명글'만 주는 게 아니라, 실제 변경까지 만들어 놓는 거죠.

정식으로 말하면, Claude Code는 Anthropic이 만든 '에이전트형 코딩 도구(agentic coding tool)'입니다. '에이전트'라는 말이 핵심이에요. 기존 AI가 내 옆에서 한 줄씩 거들어 주는 조수였다면, 에이전트는 목표를 주면 스스로 여러 단계를 밟아 일을 끝내는 대리인입니다. Claude Code는 내 코드베이스(프로젝트 전체)를 읽고, 파일을 직접 수정하고, 명령을 실행하고, git과 각종 개발 도구에 연동됩니다. 에이전트라는 개념 자체가 낯선 분은 AI 에이전트가 뭔가요 글을 가볍게 먼저 읽고 오셔도 좋습니다.

여기서 많은 분들이 헷갈려 하십니다. "그거 편집기에서 코드 자동완성해 주는 거랑 같은 거 아니에요?" 아닙니다. 자동완성은 내가 타이핑하는 그 순간, 다음에 칠 코드 몇 줄을 슬쩍 제안해 주는 겁니다. 어디까지나 한 파일 안, 커서 옆의 일이에요. 반면 Claude Code는 여러 파일을 넘나들며 일합니다. 파일 세 개를 동시에 고쳐야 하는 작업, 명령어를 실행해 봐야 아는 작업, git으로 커밋까지 해야 하는 작업 — 이렇게 '한 파일 안에 갇히지 않는 일'을 통째로 끝내는 게 자동완성과의 결정적 차이입니다.

왜 이런 도구가 필요할까요

코딩을 조금이라도 해 본 분, 아니 안 해 보신 분이라도 '복붙의 지옥'은 상상이 가실 거예요. 저는 초창기에 이렇게 일했습니다. 챗봇에 코드를 붙여넣고 → 답을 받고 → 내 편집기로 돌아와 붙여넣고 → 실행해 보고 → 에러가 나면 그 에러를 다시 복사해서 챗봇에 붙여넣고 → 또 답을 받고… 이 왕복을 하루에도 수백 번 했어요. 그런데 챗봇은 내 프로젝트의 다른 파일들을 못 보니까, 자기가 준 코드가 내 프로젝트의 다른 부분과 충돌하는지도 모릅니다. 그래서 고치면 다른 데가 터지고, 또 고치면 또 터지고요.

Claude Code는 이 왕복 자체를 없앱니다. 도구가 내 폴더 안에 들어와 있으니, 복사할 필요도 붙여넣을 필요도 없어요. "실행해 봐"라고 하면 실제로 실행해서 에러를 스스로 읽고, 그 에러를 자기가 알아서 고칩니다. 저는 그저 "잘 됐네" 또는 "여기는 이렇게 해 줘"라고 말하기만 하면 됩니다. 마치 컴퓨터를 잘 아는 조카가 우리 집에 놀러 와서, 내 노트북을 직접 만지며 "이모, 이거 이렇게 하면 돼요" 하고 문제를 해결해 주는 것과 비슷해요. 옆에서 말로 설명만 듣는 것과, 직접 만져 주는 것은 하늘과 땅 차이잖아요.

비개발자에게는 이 고통이 더 큽니다. 만들고 싶은 게 머릿속엔 또렷한데, 그걸 코드로 옮기는 '손'이 없으니까요. 그래서 많은 분들이 아이디어 단계에서 좌절합니다. Claude Code는 바로 그 '손'이 되어 줍니다. 물론 여러분이 방향을 정하고 결과를 판단해야 하지만, 적어도 "코드를 못 짜서 아무것도 시작조차 못 한다"는 벽은 확실히 낮아졌어요. 저는 이게 늦게 시작한 사람들에게 열린 가장 큰 문이라고 생각합니다.

그리고 하나 더. 복붙 방식의 진짜 문제는 '느림'이 아니라 '맥락 단절'이었습니다. 챗봇 창은 내 프로젝트 파일 A를 붙여넣으면 A만 보고, B의 존재를 모릅니다. 그래서 A를 고치라고 하면 B와의 연결이 끊기는 코드를 태연히 내놓아요. 반면 Claude Code는 A를 고치기 전에 B, C까지 스스로 열어 보고 "이걸 바꾸면 저기도 같이 손봐야겠네요" 하고 판단합니다. 사람 동료가 일하는 방식과 똑같죠. '내 프로젝트 전체를 이해한 상태에서 일한다'는 것, 이게 복붙 시대와 결별하는 핵심입니다.

전체 그림 — 내가 하는 일은 딱 세 가지

기술 이야기로 들어가기 전에, 큰 그림을 한 장으로 보여 드릴게요. 여러분이 실제로 하게 될 일은 놀랄 만큼 단순합니다.

보이시죠? 어려운 명령어를 외울 필요가 없습니다. 그냥 말을 걸고, 결과를 보고, 좋으면 승인하면 됩니다. 이 리듬만 익히면 나머지는 자연스럽게 따라옵니다. 그럼 이제 하나씩 실제로 해 봅시다.

어디서 쓰나요 — 다섯 가지 '표면'

Claude Code는 한 군데서만 도는 게 아닙니다. 여러 '표면(surface)'에서 동작해요. '표면'이라는 말이 좀 낯선데, 쉽게 말해 같은 사람을 만나는 여러 창구라고 생각하시면 됩니다. 같은 은행 직원을 창구에서도 만나고, 전화로도 만나고, 앱으로도 만나는 것처럼요. 중요한 건, 어느 창구로 만나든 같은 엔진이라는 점입니다.

여기서 초보자분들께 팁을 하나 드릴게요. 터미널이 아직 무섭다면, 처음엔 데스크톱 앱이나 웹(claude.ai/code)으로 시작하는 게 문턱이 훨씬 낮습니다. 저도 처음엔 웹으로 감을 잡고, 나중에 터미널로 넘어갔어요. 부끄러운 게 아니에요, 오히려 현명한 순서입니다.

제가 권하는 성장 경로는 이렇습니다. 웹으로 '말 걸고 결과 보는' 리듬을 익히고 → 익숙한 편집기가 있으면 IDE 확장으로 옮겨 실제 작업에 붙여 보고 → 마지막에 터미널로 넘어가 파이프·스크립트 같은 진짜 힘을 쓰는 순서예요. 물론 처음부터 터미널로 시작해도 전혀 문제없습니다. 중요한 건, 앞서 말했듯 어느 표면에서 시작하든 설정과 습관이 그대로 이어진다는 점이에요. 그러니 "어디서 시작할까"로 너무 고민하지 마세요. 가장 덜 무서운 곳에서 첫걸음을 떼는 게 정답입니다. 이 글의 나머지 설명은 가장 기본이자 강력한 터미널을 기준으로 하지만, 웹이나 데스크톱 앱에서도 '말을 거는' 본질은 똑같습니다.

시작하기 전에 — 무엇이 필요한가요

Claude Code를 쓰려면 계정이 하나 필요합니다. 헬스장 회원권처럼요. 구체적으로는 Claude 구독(Pro / Max / Team / Enterprise) 또는 Claude Console(API) 계정 같은 것이 있어야 합니다. 어떤 요금제가 나에게 맞는지, 그리고 구체적인 금액은 계속 바뀔 수 있으니 공식 문서와 요금 페이지에서 직접 확인하시는 게 가장 정확합니다. 여기서 제가 특정 금액을 적어 드리면 그게 오히려 여러분을 헷갈리게 할 수 있어요.

"돈 내야 하는구나…" 하고 실망하실 수 있는데, 생각해 보면 유능한 동료 한 명을 곁에 두는 값입니다. 저는 이 도구로 아낀 시간과 스트레스를 생각하면 전혀 아깝지 않았어요. 다만 시작하기 전에 '공짜는 아니다'라는 점은 정확히 알고 계시는 게 좋습니다.

설치하기 — 한 줄씩, 겁먹지 말고

자, 이제 터미널 설치입니다. 아래 명령어들이 암호처럼 보이겠지만, 걱정 마세요. 여러분이 할 일은 자기 운영체제에 맞는 줄을 딱 한 줄 복사해서, 터미널에 붙여넣고 엔터를 치는 것뿐입니다. 그게 전부예요.

혹시 "명령을 찾을 수 없습니다" 같은 메시지가 나와도 당황하지 마세요. 대개는 터미널 창을 한 번 완전히 닫았다가 다시 열면 해결됩니다. 컴퓨터가 새로 설치된 도구를 아직 '기억'하지 못해서 그런 거라, 껐다 켜면 인사를 다시 나누는 셈이거든요.

로그인하고 첫 세션 열기

설치가 됐으면 이제 실제로 만나 볼 차례입니다. 여기서 아주 중요한 습관 하나. Claude Code는 '내가 지금 있는 폴더'를 자기 작업장으로 삼습니다. 그러니 반드시 내가 작업하려는 프로젝트 폴더 안에서 실행해야 해요. 엉뚱한 폴더에서 켜면, 엉뚱한 방에 들어가 "여기서 뭘 하죠?" 하는 것과 같습니다.

참고로, 나중에 계정을 바꾸거나 다시 인증하고 싶으면 세션 안에서 /login이라고 치면 됩니다. 회사 계정과 개인 계정을 오가는 분들께 유용해요. 자, 이제 로그인까지 마쳤으니 진짜 재미있는 부분, '대화'로 넘어갑시다.

첫 대화 — 일단 '물어보기'부터

처음부터 코드를 고치라고 시키면 무섭죠. 그래서 저는 늘 초보자분들께 "먼저 이것저것 물어보기부터 하세요"라고 권합니다. Claude Code는 이미 내 프로젝트 전체를 읽을 수 있으니, 나보다 내 프로젝트를 더 잘 알 수도 있어요. 새 회사에 온 유능한 신입에게 "우리 팀이 뭐 하는 팀인지 좀 파악해 볼래요?"라고 시키는 것과 같습니다. 아래처럼 그냥 평소 말로 물어보세요.

• "이 프로젝트 뭐 하는 거야? 한 문단으로 설명해 줘."
• "메인 진입점(프로그램이 처음 시작되는 파일)이 어디야?"
• "이 프로젝트에서 가장 중요한 파일 다섯 개만 짚어 줘."
• "초보자인 내가 이 코드를 이해하려면 어디서부터 봐야 할까?"

이렇게 물어보면 Claude가 실제로 파일들을 열어 보고 요약해 줍니다. 여기서 감동 포인트. 챗봇에게 이런 걸 물으면 "일반적으로 프로젝트는…" 하고 뻔한 소리를 하지만, Claude Code는 진짜 내 파일을 보고 "이 프로젝트는 게시판 앱이고, app.js가 진입점이며…" 하고 구체적으로 답합니다. 이 차이를 한 번 느껴 보시면, 왜 이 도구가 다른지 몸으로 이해가 되실 거예요. 부담이 하나도 없습니다. 물어보는 걸로는 아무것도 안 망가지니까요.

제가 초보자분들께 특히 권하는 첫 질문은 "내가 이 프로젝트에서 X 기능을 고치려면, 어느 파일들을 봐야 해?"입니다. 예를 들어 "로그인 화면 문구를 바꾸고 싶은데 어디를 손대야 해?"라고 물으면, Claude가 관련 파일 위치를 콕 짚어 줍니다. 예전 같으면 폴더를 헤매며 반나절을 태울 일을, 이 한 번의 질문이 해결해 줘요. '고치기' 전에 '어디를 고칠지 파악하기'가 사실 초보자에게 가장 힘든 단계인데, 그 단계를 통째로 넘겨 줄 수 있는 겁니다.

첫 코드 변경 — 그리고 권한 모드

물어보기에 익숙해졌으면, 이제 손을 대 볼 차례입니다. 프로그래밍의 세계에는 오랜 전통이 하나 있어요. 새 도구나 언어를 배울 때 가장 먼저 '화면에 hello world라고 띄우기'를 해 보는 겁니다. 일종의 통과의례이자, "이 도구가 실제로 내 손끝에서 움직인다"를 확인하는 첫 악수 같은 거예요. 우리도 그 전통을 따라 봅시다. 이렇게 말해 보세요.

"main 파일에 화면에 'hello world'라고 출력하는 함수를 하나 추가해 줘."

그러면 Claude는 (1) 어느 파일을 고쳐야 할지 스스로 찾고, (2) 어떻게 바꿀 것인지 변경안을 화면에 보여 주고, (3) 여러분에게 "이렇게 바꿔도 될까요?"라고 승인을 요청합니다. 여기가 정말 중요합니다. 기본 설정에서 Claude Code는 파일을 실제로 바꾸기 전에 항상 여러분에게 물어봅니다. 여러분이 "응, 좋아"라고 승인해야만 실제로 손을 대요. 마치 목수가 "이 벽 여기 뚫을게요, 괜찮죠?" 하고 확인받는 것과 같습니다.

변경안을 보여 줄 때, Claude는 보통 '어느 줄이 어떻게 바뀌는지'를 알아보기 쉽게 표시해 줍니다. 없어질 줄과 새로 생길 줄을 나란히 보여 주는 식이죠. 처음엔 이 화면이 낯설겠지만, 겁먹지 말고 딱 한 가지만 확인하세요. "내가 부탁한 것만 바뀌고 있나?" 오타 하나 고쳐 달라고 했는데 엉뚱한 곳까지 손대려 하면, 승인하지 말고 "거긴 두고 이것만"이라고 말하면 됩니다. 이 감각, 즉 결과를 눈으로 확인하고 내가 결정한다는 감각이 초보 시절에 붙여야 할 가장 중요한 근육이에요.

이 '승인 요청' 방식이 바로 권한 모드(permission mode)입니다. 그리고 이 모드는 Shift+Tab 키를 눌러 순환하며 바꿀 수 있어요. 상황에 맞게 고르시면 됩니다.

여기에 더해, 정말 위험한 작업(예: 파일을 대량으로 지우는 명령 등)은 자동으로 막아 주는 안전장치도 마련돼 있습니다. 그래도 저는 초보자분들께 한 가지만은 꼭 당부드려요.

plan 모드는 특히 초보자에게 보물 같은 기능입니다. 큰 작업을 앞두고 겁이 날 때, "이거 어떻게 할 건지 먼저 계획만 세워서 보여 줘"라고 하면, Claude가 실제로는 아무것도 안 건드린 채 '이런 순서로, 이 파일들을, 이렇게 바꾸겠다'는 계획서를 내놓습니다. 그걸 읽어 보고 "좋아, 그대로 진행해"라고 하거나 "2번은 빼고 하자"라고 조정할 수 있어요. 집을 리모델링하기 전에 도면을 먼저 보는 것과 같죠. 도면을 보고 나면 훨씬 마음이 놓입니다. 저는 지금도 조금 규모가 있는 작업은 무조건 plan부터 부릅니다.

실전 워크플로 — git, 버그, 리팩터, 테스트, 문서

이제 진짜 일상 업무입니다. Claude Code의 진가는 여기서 나와요. 놀라운 건, 이 모든 걸 평소 쓰는 말로 시킬 수 있다는 겁니다. 명령어를 외울 필요가 없어요. 개발자들이 하루에도 수십 번 반복하는 이 다섯 가지 — git 관리, 버그 수정, 리팩터, 테스트, 문서 작성 — 은 사실 초보자가 넘기 가장 힘들어하는 벽이기도 합니다. 하나씩 어떻게 말로 시키는지 보여 드릴게요.

git 다루기 — 저장과 이력 관리

git은 코드의 '저장·되돌리기·이력 관리' 도구인데, 초보자에게 가장 무서운 관문 중 하나죠. 그런데 Claude Code에게는 그냥 말로 시키면 됩니다.

• "지금까지 뭐가 바뀌었어? 요약해 줘."
• "이 변경들을 설명적인 메시지로 커밋해 줘." (커밋 = 지금 상태를 하나의 저장점으로 기록)
• "feature/quickstart라는 새 브랜치를 만들어 줘." (브랜치 = 원본을 건드리지 않는 작업용 사본)

git이 초보자에게 무서운 이유는 명령어가 암호 같아서예요. git add, git commit -m, git branch… 이걸 외우고 순서까지 지켜야 하니 진입 장벽이 높았죠. 그런데 Claude Code는 그 명령어들을 대신 쳐 줍니다. 저는 그냥 "저장해 줘", "되돌려 줘", "새 작업 공간(브랜치) 하나 파 줘"라고 말할 뿐이에요. 덕분에 저는 명령어를 외우는 대신 '커밋이란 무엇이고 왜 하는가' 같은 개념에만 집중할 수 있었습니다. 도구가 손을 대신해 주니, 머리는 더 중요한 걸 생각하게 되더라고요.

브랜치라는 개념이 아직 낯설다면 브랜치 전략 이야기를 참고하세요. 그리고 변경을 팀에 정식으로 제안하는 절차인 PR과 코드 리뷰는 PR·코드리뷰 이야기에, 그렇게 올린 코드를 자동으로 검사·배포하는 자동화는 GitHub Actions 이야기에 자세히 풀어 뒀습니다. Claude Code는 이 과정들의 '손발'을 대신해 주지만, 개념 자체는 알아 두시면 훨씬 든든해요.

버그 수정 · 리팩터 · 테스트 · 문서

일상적으로 이렇게 부탁하게 됩니다. 하나같이 예전 같으면 몇 시간씩 끙끙댔을 일들이에요.

• 버그 수정: "삭제 버튼이 가끔 안 눌려. 원인 찾아서 고쳐 줘."
• 리팩터(정리): "이 함수가 너무 길고 복잡해. 읽기 쉽게 정리해 줘. 단, 동작은 그대로 유지해 줘."
• 테스트: "이 함수가 잘 동작하는지 확인하는 테스트 코드를 작성해 줘."
• 문서: "이 프로젝트를 처음 보는 사람을 위한 설명서(README)를 작성해 줘."

포인트는, 이걸 연달아 대화하듯 이어 갈 수 있다는 겁니다. "고쳐 줘" → (결과 확인) → "좋아, 그럼 테스트도 추가해 줘" → "이제 설명적인 메시지로 커밋해 줘." 이렇게 한 세션 안에서 대화의 흐름을 타고 일이 굴러갑니다. 옆자리 동료와 일하는 것과 정말 똑같아요.

여기서 리팩터 요청에 제가 늘 붙이는 한마디가 있습니다. "단, 동작은 그대로 유지해 줘." 리팩터는 '겉모습만 정리하고 하는 일은 똑같이'가 원칙이거든요. 이 한마디를 붙이면 Claude가 기능을 바꾸지 않도록 더 신경 씁니다. 이처럼 '이건 지켜 줘'라는 제약을 함께 말하는 습관이 결과의 질을 크게 좌우해요. "테스트도 함께 통과하는지 확인해 줘", "기존 스타일을 따라 줘" 같은 조건을 곁들이면, 막연히 "고쳐 줘"라고만 할 때보다 훨씬 안심하고 맡길 수 있습니다. 좋은 지시는 좋은 결과를 낳고, 이건 사람 동료에게도 똑같이 적용되는 진리죠.

한 편의 짧은 실전 — 오타 수정부터 커밋까지

말로만 들으면 감이 안 오시죠. 제가 실제로 자주 하는, 아주 작은 작업 하나를 처음부터 끝까지 따라가 보겠습니다. "홈 화면에 오타가 하나 있어서 고치고 저장(커밋)까지 하고 싶다"는 상황이에요. 예전 같으면 파일 찾고, 수정하고, git 명령 외우느라 30분은 걸렸을 일입니다.

보셨죠? 제가 외운 명령어는 cd와 claude 두 개뿐이고, 나머지는 전부 '말'이었습니다. 이 작은 성공 경험 하나가 정말 중요해요. "어, 나도 되네?" 하는 그 순간부터, 조금씩 더 큰 일을 맡길 용기가 생기거든요. 처음부터 거창한 걸 노리지 마시고, 이런 소소한 승리를 여러 번 쌓으세요. 그게 가장 빠른 길입니다.

더 똑똑하게 쓰기 — 커스터마이즈

여기까지만 해도 충분히 강력한데, Claude Code는 '내 방식에 맞게' 길들일 수 있습니다. 이게 진짜 고수의 영역인데, 개념만 가볍게 소개할게요. 지금 다 이해 못 하셔도 괜찮습니다. "이런 게 있구나" 정도만 알아 두세요. 이 네 가지는 초보 단계에서 당장 필요하진 않지만, 같은 프로젝트를 오래 붙들수록 위력을 발휘합니다.

이 중에서 초보자가 가장 먼저, 그리고 가장 큰 효과를 보는 건 단연 CLAUDE.md입니다. 프로젝트 폴더 맨 위에 이 파일을 하나 만들고 "우리 프로젝트는 이런 규칙으로 코드를 짠다, 이런 건 하지 마라, 커밋 메시지는 이렇게 써라" 같은 걸 적어 두면, Claude가 매번 세션을 시작할 때 이걸 읽고 그 규칙을 지킵니다. 신입에게 매번 같은 잔소리를 반복하는 대신, 규칙집 한 장을 건네주는 셈이에요. 이거 하나만 잘 써 둬도 결과물의 질이 확 올라갑니다.

CLAUDE.md에 뭘 적어야 할지 막막하실 텐데, 처음엔 거창하게 쓸 필요 없어요. 저는 이렇게 시작했습니다. "이 프로젝트는 무엇을 하는 앱이다", "주요 폴더는 이런 구조다", "코드에 한글 주석을 달아 달라", "커밋 메시지는 한국어로 써 달라", "함부로 라이브러리를 새로 추가하지 말고 먼저 물어봐 달라" — 이 다섯 줄이면 충분했어요. 그리고 재미있는 건, CLAUDE.md 자체도 Claude에게 만들어 달라고 할 수 있다는 것입니다. "이 프로젝트를 분석해서 CLAUDE.md 초안을 만들어 줘"라고 하면 얼추 뼈대를 잡아 주고, 저는 거기에 제 취향만 몇 줄 얹으면 됩니다. 스킬·훅·MCP는 그다음, 정말 필요해질 때 하나씩 들여다보셔도 늦지 않아요.

더 나아가면, 서브에이전트(sub-agent)나 백그라운드 에이전트를 활용해 여러 작업을 동시에 병렬로 처리할 수도 있습니다. 큰일을 여러 조각으로 나눠, 조각마다 '작은 일꾼'을 붙여 동시에 돌리는 셈이에요. 또 터미널 도구라는 특성 덕분에, Claude Code는 다른 명령들과 파이프로 이어 붙이거나 스크립트·CI(자동 검사·배포 파이프라인)에 조합해 쓸 수도 있습니다. 이게 바로 '작은 도구들을 잘 만들어 서로 조합한다'는 오래된 유닉스 철학이에요. 예를 들어 로그 파일의 마지막 200줄을 Claude에게 흘려 보내 점검시키는 것도 딱 한 줄로 됩니다.

tail -200 app.log | claude -p "이상 있으면 알려 줘"
— 로그 마지막 200줄을 Claude에게 넘겨 이상 여부를 점검시키는 예시

이 한 줄이 뜻하는 바가 꽤 큽니다. 여기서 tail -200 app.log는 "로그 파일의 마지막 200줄을 꺼내라"는 뜻이고, 가운데 |(파이프)는 "그 결과를 다음 도구에 그대로 넘겨라"는 뜻이에요. 즉 앞 도구가 꺼낸 것을 Claude에게 손에서 손으로 건네주는 겁니다. 이렇게 Claude Code는 혼자 우뚝 선 프로그램이 아니라, 다른 도구들과 손잡고 일하는 하나의 부품이 될 수 있습니다. 지금 당장은 이런 걸 쓸 일이 없겠지만, "아, 나중엔 이렇게까지 자동화할 수 있구나" 정도만 기억해 두세요. 여러분이 성장하면 언젠가 이 유연함이 큰 무기가 됩니다.

Claude Code가 특히 빛나는 일, 조심할 일

어떤 도구든 만능은 아닙니다. Claude Code도 잘 맞는 일과, 맡기더라도 손을 더 봐야 하는 일이 나뉘어요. 이걸 미리 알아 두면 실망도 덜하고, 도구를 더 현명하게 쓸 수 있습니다. 제 경험을 기준으로 정리해 봤어요.

정리하면, Claude Code는 '명확하게 말할 수 있는 일'에 강하고, '내가 뭘 원하는지 나조차 모호한 일'에는 약합니다. 그러니 큰 일일수록 내가 먼저 머릿속을 정리하고, 작은 조각으로 나눠 하나씩 맡기는 게 핵심이에요. 이건 도구의 한계라기보다, 사실 좋은 협업의 기본이기도 합니다.

자주 쓰는 명령 정리

말로 다 되는데 명령을 왜 외우냐고요? 맞습니다, 안 외우셔도 돼요. 다만 아래 몇 개는 알아 두면 손에 척척 붙어서 편합니다. 딱 이만큼만요.

그리고 세션 안에서 쓰는 슬래시 명령들도 몇 개 있습니다. /help(도움말), /clear(대화 맥락 비우기 — 주제가 바뀔 때 유용), /model(모델 선택), /review(코드 리뷰 요청), /exit(세션 종료). 특히 /clear는 초보자가 놓치기 쉬운데, 완전히 다른 작업으로 넘어갈 때 이걸로 한 번 정리해 주면 Claude가 이전 이야기에 헷갈리지 않아 결과가 더 좋아집니다.

세션과 '기억' 다루기 — 초보가 놓치는 감각

이 부분은 명령 표만 봐서는 감이 안 오는, 하지만 실전에서 정말 중요한 이야기라 따로 떼어 설명할게요. Claude Code는 한 세션 안에서 나눈 대화를 '기억'하며 일합니다. 이게 장점이자, 초보자가 자주 넘어지는 지점이에요.

예를 들어 오전에 "로그인 기능"을 붙들고 한참 대화했다고 합시다. 오후에 갑자기 "장바구니 화면 색깔 좀 바꿔 줘"라고 하면, Claude는 여전히 머릿속에 오전의 로그인 이야기를 담은 채 대답합니다. 그러다 보면 엉뚱하게 로그인 쪽을 참고하거나, 맥락이 뒤섞여 결과가 흐려질 수 있어요. 이럴 때 /clear로 칠판을 한 번 지우는 것입니다. "자, 새 주제 시작합니다" 하고 깨끗한 상태에서 다시 말을 거는 거죠. 저는 작업 주제가 바뀔 때마다 습관적으로 /clear를 칩니다.

반대로, 세션을 껐는데 아까 하던 걸 이어서 하고 싶을 때가 있죠. 그럴 땐 폴더에서 claude -c를 치면 가장 최근 대화를 그대로 이어서 시작합니다. 여러 세션 중 특정한 걸 골라 되살리고 싶으면 claude -r로 목록에서 고르면 되고요. 즉 주제가 바뀌면 /clear, 하던 걸 이어 하면 -c — 이 두 감각만 익혀 두면 Claude의 '기억'을 내 편으로 다룰 수 있습니다. 신입 동료에게 "그 얘긴 이제 됐고, 새 건으로 가자" 또는 "어제 하던 거 이어서 하자"라고 말하는 것과 똑같아요.

비개발자에게 이게 무슨 의미인가요

솔직히 말씀드릴게요. Claude Code 같은 도구가 나오면서, "코딩을 아예 모르면 아무것도 못 한다"는 벽이 확실히 낮아졌습니다. 이제는 '무엇을 만들고 싶은지'를 명확히 말할 수 있고, '결과가 맞는지 판단'할 수 있으면, 손으로 코드를 한 줄 한 줄 못 짜도 꽤 많은 걸 해낼 수 있어요. 저 같은 늦깎이에게는 정말 고마운 변화입니다.

제가 특히 좋아하는 건, 이 도구가 배움의 속도를 확 끌어올린다는 점입니다. 예전에는 모르는 코드를 만나면 검색창을 열고 몇 시간을 헤맸어요. 지금은 그 코드를 Claude에게 보여 주며 "이거 한 줄씩 초보에게 설명하듯 풀어 줘"라고 하면 됩니다. 즉 Claude Code는 '내 일을 대신 해 주는 도구'인 동시에 '옆에서 가르쳐 주는 과외 선생'이기도 해요. 저는 이 도구를 쓰면서 오히려 코딩을 더 많이, 더 빨리 이해하게 됐습니다. AI에게 맡기면 내 실력이 안 는다고 걱정하는 분들이 계신데, 결과를 이해하려 애쓰며 쓰면 정반대의 일이 벌어집니다.

하지만 — 그리고 이 '하지만'이 정말 중요합니다 — 도구가 대신 코드를 만져 준다는 건, 그만큼 검토의 책임이 나에게 온다는 뜻입니다. Claude Code는 놀랍도록 똑똑하지만, 완벽하지 않아요. 때로는 그럴듯하지만 틀린 코드를 자신 있게 내놓기도 합니다. 그래서 앞서 그토록 '승인 습관'을 강조한 거예요. AI가 만든 결과를 무비판적으로 받아들일 때 생기는 위험들은 AI를 쓸 때 조심할 점 글에 따로 정리해 뒀으니 꼭 함께 읽어 보세요.

참고로, 이 글에서 다룬 Claude Code가 '내 터미널에 앉은 동료'라면, 아예 GitHub 위에서 이슈만 맡기면 알아서 PR까지 만들어 오는 GitHub 코딩 에이전트도 있습니다. 결이 비슷하면서도 쓰임이 달라, 둘을 비교해 읽으면 'AI에게 코딩을 맡긴다'는 게 어떤 스펙트럼인지 감이 잡히실 거예요.

제가 이 검토의 책임을 유독 강조하는 데는 이유가 있습니다. 도구가 편해질수록 사람은 방심하기 마련이거든요. "어차피 잘하겠지" 하고 결과를 안 읽고 승인을 눌러 버리는 순간, 그건 더 이상 협업이 아니라 방치입니다. Claude Code를 잘 쓰는 사람과 못 쓰는 사람의 차이는 사실 '얼마나 어려운 걸 시키느냐'가 아니라 '얼마나 성실하게 결과를 검토하느냐'에 있어요. 편리함을 누리되, 최종 판단은 언제나 내가 한다 — 이 균형만 지키면 Claude Code는 비개발자에게도 더없이 든든한 무기가 됩니다.

초보가 흔히 하는 실수 & 해결

제가 직접 겪었거나, 주변에서 많이 본 실수들입니다. 미리 알면 안 넘어져요.

자주 묻는 질문(FAQ)

Q. 저는 코딩을 전혀 몰라요. 그래도 쓸 수 있나요?
A. 네, 시작은 충분히 가능합니다. 자연어로 물어보고 부탁하는 것부터 하시면 돼요. 다만 완전히 '몰라도 된다'는 아닙니다. 결과가 맞는지 판단하고, 무엇을 원하는지 명확히 전달하는 능력은 필요해요. 쓰다 보면 자연스럽게 감이 늘고, 오히려 Claude에게 물어보며 코딩을 배우게 되기도 합니다. 저도 딱 그렇게 늘었어요. 모르는 게 나오면 창피해하지 말고 "초보에게 설명하듯 풀어 줘"라고 부탁하세요. 그게 가장 빠른 성장법입니다.

Q. 무료인가요?
A. 아니요, 사용하려면 Claude 구독(Pro/Max/Team/Enterprise)이나 Claude Console(API) 계정 같은 것이 필요합니다. 어떤 요금제가 맞는지와 구체적인 금액은 계속 바뀔 수 있으니, 공식 요금 페이지에서 직접 확인하시는 게 정확합니다.

Q. 안전한가요? 제 코드를 막 바꿔 버리는 거 아니에요?
A. 기본 설정에서는 파일을 바꾸기 전에 항상 여러분의 승인을 받습니다. 여러분이 "응"이라고 해야만 실제로 손을 대요. 위험한 작업을 막는 안전장치도 있고요. 무엇보다, git으로 이력을 관리하면 언제든 이전 상태로 되돌릴 수 있으니, 승인 습관과 git만 챙기면 크게 걱정할 일은 없습니다. 처음 얼마간은 중요한 파일을 만지기 전에 plan 모드로 계획부터 받아 보는 것도 좋은 안전벨트예요.

Q. 터미널이 너무 무서워요. 꼭 까만 화면을 써야 하나요?
A. 아니요. 데스크톱 앱이나 웹(claude.ai/code)으로 시작하면 문턱이 훨씬 낮습니다. 같은 엔진이라 나중에 터미널로 넘어가도 설정이 그대로 이어지니, 편한 곳에서 먼저 감을 잡으세요. 저도 그렇게 시작했어요.

Q. 인터넷에서 본 명령어나 버전이 이 글과 다른데요?
A. 그럴 수 있습니다. 설치 방법·명령어·요금제는 시간이 지나며 바뀌거든요. 이 글은 2026년 8월 기준으로 정리했으니, 실제로 하실 때는 공식 문서(code.claude.com)를 함께 확인하시는 게 가장 안전합니다.

마무리 체크리스트

여기까지 오셨다면, 이제 여러분은 Claude Code를 '들어 본 사람'이 아니라 '쓸 줄 아는 사람'입니다. 사실 오늘 다룬 내용은 아주 많아 보이지만, 뼈대만 추리면 놀랄 만큼 단순해요. 폴더에서 claude를 켜고, 말로 부탁하고, 결과를 읽고 승인한다. 이 네 박자가 전부입니다. 나머지 CLAUDE.md니 스킬이니 하는 것들은 필요해질 때 하나씩 얹으면 되는 곁가지예요. 그러니 지금 다 외우려 하지 말고, 이 네 박자만 몸에 새기세요. 마지막으로 오늘 배운 걸 한 번 점검해 볼까요.

• ✅ Claude Code = 내 프로젝트 폴더에 같이 앉아 코드를 직접 만지는 AI 동료
• ✅ 터미널·IDE·데스크톱·웹·모바일 어디서든, 같은 엔진(설정 공유)
• ✅ 설치 후 claude --version으로 확인, 프로젝트 폴더에서 claude로 시작
• ✅ 먼저 '물어보기'로 감을 잡고, 그다음 작은 코드 변경부터
• ✅ 기본은 '승인 요청' 모드 — 변경안을 눈으로 읽고 승인하는 습관
• ✅ CLAUDE.md 한 장으로 내 규칙을 매 세션 자동 적용
• ✅ 큰 일은 쪼개서, 주제가 바뀌면 /clear
• ✅ AI가 만든 결과는 '반드시 검토' — 편리함과 책임은 함께 온다

겁먹지 마세요. 저처럼 까만 화면이 무서웠던 사람도 지금은 이 도구 없이 일하는 걸 상상하기 어려울 만큼 잘 쓰고 있습니다. 오늘은 딱 '물어보기' 하나만 해 보셔도 충분합니다. 첫걸음이 제일 큰 걸음이에요. 완벽하게 이해하고 시작하려 하지 마세요. 일단 claude를 치고, "안녕, 이 프로젝트 뭐 하는 거야?"라고 말을 걸어 보는 것. 그 사소한 한 번이 여러분과 이 도구의 관계를 시작합니다.

다음 글에서는 오늘 살짝 맛만 본 터미널 사용법을 한층 깊이 파 봅니다. 파이프로 명령들을 엮고, 스크립트에 Claude를 끼워 넣고, 세션을 자유자재로 넘나드는 Claude Code CLI 심화 편에서 이어 가겠습니다. 그때까지, 여러분의 터미널이 조금 덜 무서워지기를 바라며. 김부장이었습니다.

(2026년 8월 기준 작성 — 설치 방법·명령·플랜은 바뀔 수 있으니 공식 문서 code.claude.com 을 함께 확인하세요.)

← 기술 블로그 목록으로