Claude Code 입문

무엇이 다를까?

먼저, 이 도구가 어떤 역할을 하는지만 가볍게 이해해 봅시다.

Claude Code는 작업을 도와주는 도구입니다. 글만 만들어 주는 상대가 아닙니다. 지금 열려 있는 작업의 내용을 보면서, 어디를 고치면 좋을지 찾고, 변경안을 제안하고, 실제 작업까지 진행할 수 있습니다.

다만 편리하다고 해서, 처음부터 모든 것을 맡기는 도구는 아닙니다. 새로 들어온 사람에게 일을 부탁할 때도, 갑자기 "전부 부탁해요"라고 하지는 않습니다. 먼저 자료를 읽어 보게 하고, 작은 일부터 맡깁니다. Claude Code도 그런 느낌으로 쓰는 것이 안전합니다.

쓰는 장소가 다르다

Claude Code

지금 작업하고 있는 곳에서 그대로 사용할 수 있다

• 터미널은 글자로 조작하는 화면입니다. Claude Code는 그곳에서 실행됩니다.
• 편집 도구를 바꾸지 않고도 이어서 작업하기 쉬워서, 지금의 작업 흐름을 크게 바꾸지 않고 시작할 수 있습니다.

여기가 처음에 많이 헷갈리는 부분입니다. 평소에 화면을 클릭하면서 일하던 사람에게는, 글자만 있는 화면이 조금 무섭게 느껴질 수 있습니다. 하지만 처음에 외워야 할 것은 많지 않습니다. 중요한 것은 작업 폴더 안에서 열기와 화면에 나온 확인 내용을 읽고 진행하기입니다.

쓰는 장소가 다르다고 하면, 특별한 지식이 필요할 것처럼 느껴질 수 있습니다. 하지만 처음에는 "이 작업 안에서, 작업을 상의하기 시작하는 곳" 정도로 이해해도 충분합니다.

부탁하는 기본 방법

중요한 전제

Claude Code에 부탁할 때는, 한꺼번에 전부 맡기기보다 작은 단위로 나누어 부탁하는 편이 더 잘됩니다. 이유는 단순합니다. 중간중간 확인하기 쉽기 때문입니다. 스스로 되돌릴 수 있는 상태를 유지하며 진행하면, 실수가 커질 가능성이 줄어듭니다.

• 전부 맡기기보다, 작게 부탁하기. 예를 들어 "이 작업의 개요를 알려줘", "이 화면을 어떻게 고치면 좋을지 생각해 줘"부터 시작합니다.
• 한 번에 고치기보다, 움직임을 보면서 진행하기. 어디가 바뀌었는지 보고 다음으로 넘어갑니다.
• 나중에 곤란해지기보다, 내가 직접 되돌릴 수 있는 방법을 고르기. 별도 브랜치나 확인 화면을 쓰는 것은 그 때문입니다.

자주 있는 실패는 "적당히 좋게 고쳐 줘"처럼 너무 넓게 부탁하는 것입니다. 이렇게 하면, 본인은 도움을 받은 것 같아도 무엇이 바뀌었는지 알 수 없게 됩니다. 모르는 채로 진행하면, 나중에 다시 고치기 어려워집니다.

도입 순서

이 부분만 알면, 우선 시작할 수 있습니다.

처음에는 설치 순서를 지키는 것이 중요합니다. 순서를 건너뛰면, "쓸 수 없다", "작동하지 않는다"고 느끼기 쉬워집니다. 특히 가입과 안내에 따른 설치는 먼저 끝내야 합니다.

설정이 익숙하지 않아도 괜찮습니다. 처음부터 세세한 조정을 하려고 하지 말고, 화면에 나오는 안내대로 진행해 주세요. 모르는 말이 나와도, 지금은 뜻을 전부 외울 필요는 없습니다.

처음에 할 3가지

준비

• 가입하고 유료 플랜을 고르기. Claude Code는 Pro 또는 Max에서 사용합니다. 무료로는 사용할 수 없습니다. 먼저 이 조건이 맞지 않으면, 다음으로 진행할 수 없습니다.
• 홈페이지 안내대로 설치하기. 화면에 나온 순서대로 하면 되고, Windows도 바로 진행할 수 있습니다. 자기 방식으로 다른 설치 방법을 찾는 것보다 안전합니다.
• 터미널을 열고 준비하기. 글자로 조작하는 화면에서 시작한다고 기억해 두세요. 처음에는 익숙하지 않아도 문제없습니다.

많이 막히는 부분은, "무료로 시험해 볼 수 있겠지"라고 생각하고 진행하는 것입니다. 이 부분은 처음에 분명히 확인해 주세요. 또 회사 컴퓨터에서 설치가 제한되어 있는 경우도 있습니다. 그럴 때는 무리해서 진행하지 말고, 관리하는 사람에게 상담하세요.

실행은 작업 폴더 안에서

시작

• 작업할 폴더를 열기. 폴더는 작업 파일이 모여 들어 있는 상자입니다. 그 작업 안에서 Claude Code를 시작합니다.
• 브라우저에서 로그인하기. 승인한 뒤 원래 화면으로 돌아오면 괜찮습니다. 돌아오는 것을 잊어서 멈춘 것처럼 보일 때가 있습니다.
• 주의사항을 그 자리에서 읽기. 나온 답변이나 만들어진 내용은 스스로도 확인합니다. 그대로 믿지 않는 것이 기본입니다.
• 폴더를 신뢰하기. 그 작업의 파일을 읽을 수 있게 하는 확인입니다. 지금부터 다룰 작업이라고 확실히 아는 곳에서만 진행합니다.

여기서 중요한 것은, 관계없는 곳에서 시작하지 않는 것입니다. 책상 위에 서류가 많이 놓인 상태에서, "이 일을 진행해 줘"라고 말하면 엉뚱한 자료를 읽을 수도 있습니다. Claude Code도 같습니다. 볼 위치를 맞춘 다음에 시작합니다.

또한 신뢰 확인은, 아무 폴더에서나 눌러도 되는 것이 아닙니다. 내 작업이라고 확실히 아는 곳에서만 진행하는 것이 안전합니다.

처음 건네는 한마디

헷갈리면 이것부터

먼저 묻기

"이 작업의 개요를 알려줘"라고 부탁합니다. 전체 모습을 빨리 파악할 수 있습니다. 어떤 목적의 작업인지, 어디가 중요해 보이는지, 어떤 파일이 중심인지 먼저 알 수 있으면, 그다음 작업이 쉬워집니다.

잘 맞는 상황

처음 만지는 작업이나, 다른 사람에게 넘겨받은 작업에서 특히 도움이 됩니다. 다른 사람에게 받은 일은 설명이 부족할 때가 있습니다. 그럴 때는 갑자기 고치기 시작하기보다, 먼저 내용을 읽고 정리해 달라고 하는 편이 안전합니다.

먼저 읽게 하기

갑자기 고치지 말고, 먼저 내용을 읽게 합니다. 그것이 오히려 빠른 길입니다. 예를 들어 겉보기만 신경 쓰이는 부분이 있어도, 뒤에서는 다른 부분과 연결되어 있을 수 있습니다. 배경을 보지 않고 고치면, 나중에 다른 문제가 생기기 쉬워집니다.

처음 질문은 잘 쓰려고 애쓰지 않아도 괜찮습니다. 짧아도 통합니다. 중요한 것은 처음부터 작업을 시키는 것이 아니라, 먼저 이해를 맞추는 것입니다.

보면서 고치기

작업하기 쉬움과 안전을 먼저 갖춥니다.

Claude Code는 보이지 않는 상태로 진행하기보다, 변화를 보면서 쓰는 편이 더 안심됩니다. 어디가 바뀌었는지 눈으로 따라갈 수 있으면, "내가 생각한 수정"과 "실제로 일어난 수정"의 차이를 알아차릴 수 있습니다.

특히 처음에는 조금씩 고치고, 그때마다 확인하는 흐름을 추천합니다. 누군가가 초안을 고쳐 줄 때도, 표시된 수정 내용을 보면서 확인하는 편이 더 안심되는 것과 같습니다.

VS Code에서 사용하기

VS Code는 편집하는 도구입니다.

• 안에서 터미널을 열면, 편집 중인 화면을 보면서 Claude Code를 실행할 수 있습니다. 이리저리 오가는 일이 줄어듭니다.
• 추가 기능이 설치될 때가 있어서, 바뀐 부분을 따라가기 쉬워지고 확인도 빨라집니다.
• 자동으로 들어가지 않으면 직접 찾아서 설치할 수도 있습니다. 추가 기능 목록에서 "Claude Code"를 검색합니다.

여기서의 목적은 멋지게 사용하는 것이 아닙니다. 변화를 놓치지 않는 것입니다. 계속 다른 화면으로 바꾸다 보면, 초보자일수록 더 헷갈리기 쉽습니다. 보면서 진행할 수 있는 환경을 먼저 만들면, 차분하게 확인할 수 있습니다.

만약 추가 기능이 보이지 않아도, 바로 실패라고 생각하지 않아도 괜찮습니다. 우선 VS Code 안에서 작업을 보면서 사용할 수 있는 상태가 되어 있다면, 첫걸음으로는 충분합니다.

먼저 눈에 보이게 하기

확인의 바탕

고치기 전에, 지금 화면을 먼저 띄운다

• 작업을 실행하고, 브라우저에서 볼 수 있는 상태로 만듭니다.
• 고친 뒤에, 좋아졌는지 바로 비교할 수 있게 합니다.

이것은 아주 중요합니다. 바꾸기 전 상태를 보지 않으면, 제대로 고쳐졌는지, 아니면 다른 곳이 흐트러졌는지 판단할 수 없습니다. 실제 일에서도 수정 전 자료를 남기지 않고 고치면, 무엇이 좋아졌는지 설명하기 어려워집니다.

눈에 보이게 하는 것은 안심을 위한 것이기도 합니다. 이상하다고 느낄 때 원래 상태와 비교할 수 있기 때문입니다. 비교할 대상이 있는 것만으로도 확인 부담은 크게 줄어듭니다.

본격 작업 전 3가지

별도 브랜치는 시험 작업용 가지입니다. 원래 작업과 분리해서, 안심하고 시험해 볼 수 있는 장소라고 생각하면 됩니다.

• 입력하기 쉬운 설정을 켜기. Shift + Enter로 줄바꿈할 수 있게 하면 대화하기 쉬워집니다. 긴 부탁을 나누어 쓰고 싶을 때 편리합니다.
• 별도 브랜치로 이동하기. 원래 작업을 어지럽히기 어렵게 하고, 실수해도 되돌리기 쉽게 합니다. 처음부터 본 작업 쪽에서 바로 만지지 않는 것이 안전합니다.
• 실행 전 확인에서 허용하기. 하려는 작업을 보고 나서 진행합니다. 읽지 않고 계속 누르지 않는 것이 중요합니다.

초보자일수록 이 부분을 건너뛰지 마세요. 특히 별도 브랜치는 보험과 비슷한 것입니다. 만약 회사에서 그 사용 방법이 정해져 있지 않다면, 잘 아는 사람에게 "시험 작업용 가지에서 진행하고 싶다"고 상담하면 안전합니다.

또 확인 화면이 나오면, 급하게 넘어가지 마세요. 무엇을 건드리려는지 보기만 해도 위험한 변경을 피하기 쉬워집니다. 잘 모르겠을 때는 그 자리에서 멈출 용기가 중요합니다.

처음에는 이것만

한꺼번에 맡기지 말고, 보면서 작게 진행합니다.

• 먼저 Pro 또는 Max를 선택해 설치합니다.
• 작업 안에서 시작하고, 신뢰 설정을 합니다.
• 처음 질문은 "개요를 알려줘"로 합니다.
• VS Code에서 변화를 보면서 진행합니다.
• 별도 브랜치에서 안전하게 시험합니다.

이 5가지만 알아도 시작하는 방법으로는 충분합니다. 반대로 말하면, 처음부터 어려운 사용법을 익히지 않아도 괜찮습니다. 안전하게 시작하는 흐름을 몸에 익히는 것이 더 중요합니다.

마지막으로

AI図書館

팔로우와 좋아요, 부탁드립니다

• AI를 일에 쓰는 이야기를, 쉬운 내용으로 하나씩 올리고 있습니다.
• 다음 글도 여기서 만나요.

새로운 도구는 처음 들어가는 방식에 따라 인상이 결정됩니다. 어려워 보여도, 순서대로 설치하고 작게 안전하게 사용하면 충분히 따라갈 수 있습니다.

정리

• 먼저 가입하고, Claude Code를 쓸 수 있는 플랜인지 확인한다.
• 작업할 프로젝트 폴더를 연 뒤에 시작한다.
• 처음에는 "이 작업의 개요를 알려줘"라고 묻는다.
• VS Code에서 화면을 보면서, 조금씩 고치고 확인한다.
• 별도 브랜치와 확인 화면을 사용해, 되돌릴 수 있는 형태로 진행한다.