Claude Code 맛보기: 개발자와 비개발자를 위한 확장 사용법
브라우저 속 Claude와, 작업 현장의 Claude는 다르다
지금까지 우리가 써 온 Claude는 주로 웹이나 앱에서 질문하고 답을 받는 형태였습니다. 아이디어를 정리하고, 글을 고치고, 문서를 요약하고, 계획을 세우는 데 아주 강하죠. 그런데 Claude Code는 여기서 한 발 더 나갑니다. 말로만 설명하는 도우미가 아니라, 실제 작업 폴더 안으로 들어가 파일을 읽고, 고치고, 명령을 실행하며, 여러 단계를 이어서 처리하는 쪽에 가깝습니다.1
아주 짧게 말하면 이렇습니다.
일반 Claude가 "어떻게 하면 좋을지 같이 생각해 주는 파트너"라면, Claude Code는 "생각한 내용을 실제 파일과 명령으로 옮기는 작업형 파트너"입니다.1
이 차이는 초보자에게도 중요합니다. 왜냐하면 Claude를 잘 쓴다는 것은 단지 답변을 잘 받는 데서 끝나지 않기 때문입니다. 앞으로는 "좋은 지시를 내려서 실제 결과물을 만드는 능력"이 점점 더 중요해집니다. Claude Code는 바로 그 확장 방향을 보여 주는 도구입니다.
Claude Code는 정확히 무엇일까
Claude Code는 터미널에서 실행하는 Claude 기반 작업 도구입니다. 여기서 터미널은 마우스로 버튼을 누르는 대신, 글자로 명령을 입력하는 창이라고 생각하면 됩니다. 처음 보면 조금 낯설지만, 원리는 단순합니다. 프로젝트 폴더에서 claude라고 입력하면 Claude Code가 그 폴더의 파일 구조를 읽고, 대화하면서 필요한 작업을 진행합니다.1
중요한 점은, 이 도구가 단순히 코드를 "추천"만 하는 수준이 아니라는 것입니다. 상황에 따라 프로젝트 구조를 파악하고, 관련 파일을 찾고, 수정안을 보여 주고, 허락을 받은 뒤 파일을 바꾸고, 테스트나 Git 명령까지 도와줄 수 있습니다.1
그래서 이름에 Code가 들어가긴 하지만, 꼭 현업 개발자만 의미를 느끼는 도구는 아닙니다. 비개발자라도 작은 웹페이지를 만들거나, 반복되는 기술 작업을 자동화하거나, 개발팀과 대화할 때 어떤 식으로 AI가 실제 작업에 들어오는지 이해하는 데 큰 도움이 됩니다.
어떤 사람에게 특히 유용할까
Claude Code는 다음 같은 사람에게 특히 잘 맞습니다.
개발을 배우는 입문자: 코드 한 줄 한 줄보다 "프로젝트 전체가 어떻게 움직이는지"를 배우는 데 도움이 됩니다.
현업 개발자: 여러 파일에 걸친 수정, 버그 수정, 테스트 실행, Git 작업처럼 손이 많이 가는 일을 빠르게 진행할 수 있습니다.
비개발자이지만 결과물을 직접 만들고 싶은 사람: 간단한 소개 페이지, 내부 도구, 프로토타입, 자동화 스크립트를 말로 지시하며 만드는 경험을 해 볼 수 있습니다.
특히 마지막 경우가 재미있습니다. "나는 개발자가 아니니까 Claude Code는 아직 이르다"라고 생각하기 쉽지만, 오히려 반대일 때도 많습니다. 지금 당장은 설치하지 않더라도, Claude가 나중에 어디까지 확장될 수 있는지를 미리 보면 지금 배우는 프롬프트 작성법이 왜 중요한지 훨씬 선명하게 보입니다.
일반 Claude와 무엇이 가장 다를까
가장 큰 차이는 세 가지입니다.1
첫째, 작업 위치가 다릅니다. 일반 Claude는 보통 브라우저나 앱 안에서 대화하지만, Claude Code는 내가 열어 둔 프로젝트 폴더에서 작동합니다. 즉, 대화가 추상적인 설명에 머무르지 않고 실제 파일과 연결됩니다.
둘째, 행동 범위가 다릅니다. 일반 Claude는 내용을 설명하거나 예시 코드를 만들어 주는 데 강합니다. Claude Code는 거기서 멈추지 않고 파일을 편집하고 명령을 실행하는 쪽으로 이어집니다. 물론 아무거나 마음대로 하는 것은 아니고, 기본적으로는 변경 전에 승인 절차를 거칩니다.1
셋째, 학습 효과가 다릅니다. 웹에서 코드를 복사해 붙여 넣을 때는 결과만 보게 되기 쉽습니다. 하지만 Claude Code에서는 "어떤 파일을 찾았는지", "왜 이 파일을 바꾸는지", "무슨 명령을 실행하려는지"를 흐름째 보게 됩니다. 그래서 초보자에게는 자동화 도구이면서 동시에 살아 있는 실습 교재가 되기도 합니다.
시작 전에 꼭 알아둘 점
먼저 현실적인 조건부터 보겠습니다. Claude Code를 쓰려면 공식 문서 기준으로 Claude Pro, Max, Team, Enterprise, 또는 Claude Console 계정, 혹은 지원되는 클라우드 제공자 접근 권한이 필요합니다.1
설치 방식도 예전 글과 지금이 조금 다릅니다. 인터넷에는 npm install -g @anthropic-ai/claude-code 방식이 많이 남아 있지만, 공식 문서에서는 지금 네이티브 설치를 권장합니다.1 초보자라면 괜히 오래된 글을 따라가기보다 공식 설치 명령을 쓰는 편이 훨씬 덜 헷갈립니다.
운영체제도 확인해야 합니다. 공식 문서 기준으로 macOS, Linux, WSL, Windows에서 사용할 수 있고, Windows에서는 Git for Windows가 필요합니다.1 특히 Windows에서 PowerShell과 CMD 명령이 서로 다르니, 지금 내가 어떤 터미널을 열었는지부터 확인하는 습관이 중요합니다.
그리고 마지막으로 아주 중요한 안전 규칙이 있습니다. Claude Code는 실제 파일을 바꾸고 명령을 실행할 수 있으므로, 처음에는 작은 연습용 폴더에서 시작하는 것이 좋습니다. 처음부터 회사의 중요한 저장소를 열고 "알아서 다 해줘"라고 말하는 건, 운전면허 첫날 바로 고속도로에 진입하는 것과 비슷합니다.
설치는 생각보다 간단하다
공식 문서에서 권장하는 네이티브 설치 명령은 다음과 같습니다.1
macOS, Linux, WSL에서는 이렇게 설치합니다.
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell에서는 이렇게 설치합니다.
irm https://claude.ai/install.ps1 | iexWindows CMD에서는 이렇게 설치합니다.
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd설치가 끝나면 버전을 확인해 볼 수 있습니다.
claude --version공식 문서에는 Homebrew와 WinGet 방식도 소개되어 있습니다. 다만 처음 시작하는 초보자라면 자동 업데이트가 되는 네이티브 설치가 가장 편합니다.1
터미널이 부담스럽다면 VS Code부터 시작해도 된다
Claude Code를 꼭 검은 화면 속 명령줄로만 써야 하는 것은 아닙니다. 공식 VS Code 확장 프로그램을 쓰면 IDE 안에서 계획을 보고 승인하고, 파일 변경 내용을 diff로 확인하고, 여러 대화를 탭으로 나눠 관리할 수 있습니다.2
이건 초보자에게 꽤 큰 장점입니다. 터미널 자체가 두려운 사람도, VS Code 안에서 "파일이 어디서 어떻게 바뀌는지"를 눈으로 보며 익숙해질 수 있기 때문입니다. 즉, Claude Code를 배운다는 것이 반드시 터미널 고수가 된다는 뜻은 아닙니다. 오히려 처음에는 그래픽 인터페이스를 다리처럼 활용하고, 점차 터미널 쪽으로 넓혀 가는 편이 자연스럽습니다.2
첫 실행: 가장 쉬운 3분 체험
처음에는 빈 연습 폴더 하나를 만드는 것이 좋습니다. 예를 들어 claude-playground 같은 폴더를 만든 뒤 그 안에서 시작해 보세요.
mkdir claude-playground
cd claude-playground
claude처음 실행하면 로그인 절차가 나옵니다. 브라우저에서 로그인하고 돌아오면 대화가 가능해집니다.1
이제 첫 질문은 어렵게 할 필요가 없습니다. 아주 쉬운 것부터 시작하면 됩니다.
이 폴더에서 간단한 자기소개 웹페이지를 만들어줘.
index.html, style.css, script.js로 나누고,
밝은 파란색 분위기로 디자인해줘.그러면 Claude Code는 필요한 파일을 만들고, 어떤 내용을 넣을지 제안하고, 수정 내용을 보여 준 뒤 승인을 요청합니다. 승인하면 실제 파일이 생깁니다. 여기서 끝내지 말고 한 번 더 이어 가보세요.
좋아. 이제 모바일 화면에서도 보기 좋게 다듬고,
맨 아래에 연락처 카드도 추가해줘.바로 이 흐름이 Claude Code의 핵심입니다. 한 번에 완벽한 결과를 요구하기보다, 만들어 보고, 고쳐 보고, 다시 다듬는 방식이 훨씬 잘 맞습니다. 익숙하지 않은 사람에게도 이 방식이 좋은 이유는, 내가 무슨 말을 해야 결과가 좋아지는지 몸으로 배우게 되기 때문입니다.
실전 예시 1: 개발자를 위한 첫 사용법
이제 진짜 개발 상황을 하나 상상해 보죠. 로그인 폼이 있는데, 빈 값을 넣어도 제출되는 버그가 있다고 해보겠습니다. 초보 개발자라면 어디를 봐야 할지 막막할 수 있습니다.
이럴 때는 이렇게 말하면 됩니다.
signup form에서 빈 값도 제출되는 버그가 있어.
관련 파일을 찾아서 원인을 설명하고,
수정한 다음 테스트도 실행해줘.
초보자도 이해할 수 있게 설명해줘.좋은 점은 이 프롬프트가 너무 기술적이지 않아도 된다는 것입니다. 파일 경로를 정확히 몰라도 됩니다. Claude Code가 프로젝트를 살펴보며 관련 파일을 찾고, 왜 그 파일을 수정하는지 설명해 줄 수 있습니다.1
작업이 진행되면 보통 이런 흐름으로 움직입니다. 관련 파일을 읽고, 수정 계획을 세우고, 변경안을 보여 주고, 승인을 받은 뒤 수정하고, 테스트를 돌립니다.1 초보자는 여기서 코드를 "그냥 받는 것"보다 "왜 이 수정이 필요한지"를 꼭 다시 물어보는 것이 좋습니다.
예를 들면 이렇게 이어서 물을 수 있습니다.
방금 수정한 내용을 아주 쉽게 설명해줘.
원래 코드의 문제점과, 지금 고친 방식의 차이를 비교해줘.이 한 문장 덕분에 Claude Code는 단순한 자동 수정기가 아니라, 꽤 참을성 좋은 과외 선생님처럼 변합니다.
실전 예시 2: 비개발자를 위한 첫 사용법
비개발자에게 가장 추천하는 첫 과제는 "작은 결과물을 직접 만들어 보는 것"입니다. 예를 들어 개인 포트폴리오의 아주 간단한 첫 화면을 만든다고 해보겠습니다.
프로젝트 폴더에서 이렇게 말할 수 있습니다.
처음 보는 사람도 이해할 수 있는 아주 간단한 개인 소개 페이지를 만들어줘.
이름, 한 줄 소개, 내가 잘하는 일 3개, 연락 방법이 들어가면 좋겠어.
코드를 최대한 단순하게 유지해줘.여기서 중요한 것은 내가 코드를 몰라도 된다는 점입니다. 대신 원하는 결과를 구체적으로 말해야 합니다. 예를 들어 다음처럼 수정 요청을 이어 가면 결과가 금방 좋아집니다.
글씨가 조금 딱딱해 보여.
좀 더 친근한 느낌으로 바꿔줘.
그리고 버튼 색은 초록 계열로 해줘.좋아. 이제 파일 구조를 초보자도 이해할 수 있게 설명해줘.
어떤 파일이 무슨 역할을 하는지 한 줄씩 정리해줘.이 과정은 단순히 페이지를 만드는 것 이상입니다. 비개발자도 "원하는 결과를 말로 구조화하는 법"을 배우게 됩니다. 사실 이것은 앞으로 어떤 AI 도구를 쓰더라도 계속 중요해질 능력입니다.
자주 쓰는 기본 명령 몇 가지만 알아 두자
처음부터 많은 명령을 외울 필요는 없습니다. 아래 정도만 알아도 시작에는 충분합니다.1
claude: 현재 폴더에서 대화형 세션 시작claude "task": 한 번성 작업 실행claude -p "query": 한 번 질문하고 종료claude -c: 최근 대화 이어가기claude -r: 이전 대화 다시 열기/help: 사용 가능한 명령 확인/clear: 대화 맥락 초기화
여기서 초보자가 특히 기억할 것은 /clear입니다. 작업 주제가 바뀌었는데 같은 대화를 계속 끌고 가면 맥락이 섞여서 결과가 흐려질 수 있습니다. "회원가입 버그 수정"을 끝냈으면, 다음 "README 정리"는 새로 시작하는 편이 대체로 낫습니다.
초보자가 특히 조심하면 좋은 점
Claude Code는 편리하지만, 손에 망치를 쥐었다고 모든 것이 못은 아닙니다. 처음에는 아래 감각을 꼭 익히는 편이 좋습니다.
첫째, 승인 없이 넘기지 맙시다. Claude Code는 파일 편집과 명령 실행 전에 보통 허락을 요청합니다. 초반에는 귀찮아 보여도 이 과정이 안전벨트입니다.1
둘째, 작은 범위에서 시작합시다. 처음에는 연습 폴더나 개인 프로젝트에서 써 보고, 익숙해진 뒤 실제 업무 저장소로 가는 편이 좋습니다.
셋째, Git을 안전망으로 쓰는 습관을 들이면 좋습니다. 중요한 작업 전에는 커밋 하나를 남겨 두면 마음이 훨씬 편합니다. 잘못되면 돌아갈 수 있기 때문입니다.
넷째, 한 번에 거대한 부탁을 하지 맙시다. "서비스 전체를 최신 구조로 바꿔줘"보다 "로그인 모듈 구조를 먼저 설명해줘. 그다음 유효성 검사만 추가해줘"가 훨씬 안정적입니다.
다섯째, 설명도 같이 요구합시다. Claude Code의 진짜 가치는 단순 자동화뿐 아니라 학습 속도를 높인다는 데 있습니다. "왜 이렇게 바꿨는지 설명해줘"를 습관처럼 붙이면 이해도가 빨리 올라갑니다.
지금 당장 개발을 하지 않아도, 왜 이걸 알아둘 가치가 있을까
이 장의 핵심은 "당장 모두가 Claude Code를 설치해야 한다"가 아닙니다. 더 중요한 메시지는 따로 있습니다.
Claude를 배우는 방향은 점점 분명해지고 있습니다. 단순히 질문을 잘하는 수준을 넘어, 목표를 구조화하고, 맥락을 주고, 결과를 검토하고, 다시 수정 요청을 하는 쪽으로 가고 있습니다. 이전 장에서 배운 프롬프트 작성, 대화형 수정, 문서 다루기, 작업환경 만들기 같은 습관이 바로 여기서 다시 살아납니다.
즉, 지금 웹에서 Claude를 잘 쓰는 사람은 나중에 Claude Code 같은 도구로 훨씬 자연스럽게 넘어갈 수 있습니다. 반대로 이 확장 가능성을 한 번 보고 나면, 지금 내가 왜 더 구체적으로 요청해야 하는지, 왜 작업 단위를 잘게 나눠야 하는지, 왜 검토가 중요한지가 훨씬 또렷해집니다.
Claude Code는 결국 "Claude와 대화한다"를 "Claude와 함께 실제로 만든다"로 바꿔 주는 도구입니다. 그리고 그 변화는 개발자에게만 중요한 게 아닙니다. 앞으로 AI를 잘 쓰는 사람은 답변을 많이 받는 사람이 아니라, 원하는 결과가 나오도록 작업을 설계하는 사람이 될 가능성이 큽니다.
다음 장에서는 바로 그 지점, 즉 Claude가 틀릴 때, 멈출 때, 애매할 때 무엇을 조심하고 어떻게 대응해야 하는지를 본격적으로 다룹니다. Claude Code를 아직 설치하지 않았더라도 괜찮습니다. 이제 우리는 Claude가 어디까지 도와줄 수 있는지, 그리고 그렇기 때문에 어디서부터 더 신중해야 하는지를 볼 준비가 되었습니다.
참고
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.