2026년 최신 클로드 코드 기초 10분 마스터 강의 | 클로드 코드 처음 쓰시는 분들 이것보고 지금 당장 시작해보세요

요즘 어딜 가나 클로드 코드 얘기가 끊이질 않습니다. 워낙 유명해서 다들 쓰고 계신 줄 알았는데, 제 영상 댓글을 보다 보니 아직 한 번도 안 써보신 분들이 꽤 계시더라고요. 마음은 먹었는데 복잡해 보여서 미뤄두신 경우가 대부분이었습니다.

그래서 이 글은 쓰기로 이미 마음먹은 분을 상대로 씁니다. 왜 써야 하는지는 설득하지 않고, 다른 도구와 비교하지도 않습니다. 설치하고, 첫 세션 열고, 꼭 알아야 하는 조작을 익히고, 사고 안 나게 안전장치를 걸고, 제가 매일 쓰는 습관까지 갑니다.

목표는 딱 하나예요. 클로드 옆에 붙어 앉아서, 하나하나 확인해가면서 일을 시킬 수 있는 상태. 거기까지입니다.

무료 계정으로는 안 됩니다

바로 설치부터 하고 싶으실 텐데, 이거 하나만 먼저 보고 가셔야 합니다.

클로드 코드는 무료 요금제로는 안 됩니다. 프로나 맥스 구독이 있어야 해요. 이거 모르고 설치를 다 하신 다음에 로그인에서 막히는 분들이 꽤 계십니다. 공식 문서에도 무료 플랜에는 클로드 코드 액세스가 포함되지 않는다고 적혀 있습니다.

시작하실 땐 프로면 충분합니다. 저는 하루 종일 돌려서 맥스를 쓰는데, 처음부터 이러실 필요는 전혀 없어요.

금액은 여기 적지 않겠습니다. 공식 가격 페이지에 원화가 없어서 카드사 환율이 붙고, 숫자 자체도 바뀝니다. 결제 직전 화면에 뜨는 걸 보시는 게 정확합니다.

설치는 앱 하나 받는 걸로 끝납니다

클로드 코드는 터미널로 쓰는 방법도 있습니다. 그런 방법이 있다는 것만 알아두시고, 처음 쓰신다면 데스크탑 앱으로 가세요. 익숙하지 않은 창에서 시작하면 거기서 한 번 막힙니다.

공식 사이트에서 맥이면 맥, 윈도우면 윈도우 설치 파일을 받습니다. 받아서 실행하고 로그인 한 번 하면 끝이에요. 따로 세팅할 게 없습니다.

앱을 켜면 위에 탭이 있는데, 그중 코드 탭이 클로드 코드입니다. 나머지 탭은 오늘 안 씁니다.

처음 켜면 세 군데만 보시면 됩니다

처음 켜면 뭘 봐야 할지 막막하실 텐데, 세 군데면 됩니다.

가운데 큰 게 입력창입니다. 여기에 슬래시를 치면 쓸 수 있는 명령어가 전부 뜹니다. 공식 문서 표현으로는 기본 명령과 스킬, 플러그인이 다 나옵니다. 외울 필요가 없다는 뜻이에요.

왼쪽 아래는 지금 권한 모드입니다. 이게 뭔지는 아래에서 다시 나옵니다.

오른쪽 아래는 지금 쓰는 모델과 얼마나 깊게 생각할지를 정하는 자리입니다. 처음에는 안 건드리셔도 됩니다.

그리고 뭔가 잘못된 것 같다 싶으면 /doctor 를 한번 쳐보세요. 설치와 설정을 알아서 점검해줍니다. 이 명령어는 뒤에서 한 번 더 나옵니다.

클로드는 여러분이 고른 폴더만 봅니다

입문자분들이 제일 많이 헷갈리는 게 이겁니다.

클로드가 컴퓨터의 아무 파일이나 다 보는 게 아닙니다. 여러분이 고른 폴더만 봐요. 그래서 세션을 시작할 때 작업할 폴더를 먼저 골라야 합니다. 공식 문서도 세션 시작 시 정하는 것을 프로젝트 폴더, 모델, 권한 모드 이렇게 잡아놨습니다.

고르고 나면 화면에 폴더 이름이 뜹니다. 그 안에 있는 파일만 읽고 고칠 수 있고, 바깥은 못 봅니다. 연습용으로 하실 거면 빈 폴더 하나 만들어서 그걸 고르셔도 됩니다.

이게 앱으로 시작하실 때 얻는 것 중에 제일 큰 겁니다. 작업 범위가 눈에 보여요.

고치는 것부터 시키지 마세요

켜자마자 뭘 시켜야 할지 막막하시죠. 코드를 쓰는 것부터 시키지 마시고 먼저 물어보세요.

나는 이런 걸 만들고 싶은데, 이 프로젝트에서 어디부터 보면 될까?

보시면 클로드가 알아서 파일을 하나씩 읽어 내려갑니다. 공식 문서 표현으로는 필요에 따라 프로젝트 파일을 읽으므로 수동으로 컨텍스트를 추가할 필요가 없습니다. 챗지피티에 코드 복붙하시던 거, 이제 안 하셔도 됩니다.

특정 파일 하나만 콕 집어서 보라고 하고 싶을 때가 있습니다. 그럴 땐 @ 를 치세요. 파일 이름 몇 글자만 누르면 자동완성이 뜨고, 골라서 질문하면 그 파일을 놓고 답합니다.

처음에 뭘 물어보면 좋을지도 앤트로픽이 정해둔 게 있습니다. 공식 문서의 프롬프트 라이브러리에 처음 던져볼 다섯 개가 번호까지 매겨져 있어요. 이 프로젝트 구조 훑어줘, 이 기능은 어디서 처리해, 이 테스트가 실패하는데 왜인지 찾아서 고쳐줘. 그대로 따라 하셔도 됩니다.

고치기 전에 물어보게 만듭니다

이제 진짜 일을 시켜볼 차례인데, 아까 왼쪽 아래를 보라고 했던 그 자리를 먼저 봅니다. 거기가 권한 모드입니다. 매뉴얼이면 파일을 고치기 전에 하나하나 물어보고, 오토면 알아서 합니다.

지금 뭘로 되어 있든, 처음에는 매뉴얼로 맞춰놓고 시작하시는 걸 권합니다. 클로드가 뭘 하는지 눈으로 익히는 게 먼저거든요. 모드는 세션 중에 언제든 바꿀 수 있습니다.

맞춰놓고 시켜봅니다. 메인 파일에 헬로 월드 함수 추가해줘. 그러면 바로 고치는 게 아니라 승인 창이 뜹니다. 공식 문서의 매뉴얼 모드 설명이 그대로예요. 고치거나 실행하기 전에 물어보고, 변경 내용을 보여주고, 하나하나 수락하거나 거절하게 합니다.

여기서 볼 건 딱 두 가지입니다. 어떤 파일을 건드리는지, 그리고 무엇을 쓰는지. 삼 초면 봅니다. 예스를 누르면 그때 고쳐요.

뭘 바꿨는지 궁금하면 그냥 물어보시면 됩니다. 어떤 파일 바꿨어. 이렇게요.

명령어는 다섯 개면 됩니다

공식 명령어가 백 개 넘게 있는데 다 외우실 필요 없습니다. 처음에는 이 다섯이면 거의 다 됩니다.

/context 는 입문자 중에 쓰는 분을 거의 못 봤는데, 이건 꼭 아셔야 합니다. 지금 얼마나 찼는지를 색깔 그리드로 보여줍니다. 대화가 길어지면 여기가 꽉 차고, 꽉 차면 아까 한 얘기를 까먹기 시작합니다.

그럴 때 쓰는 게 나머지 둘입니다. 한 줄로 외우세요. 작업이 바뀌면 /clear, 같은 작업인데 길어지면 /compact. 공식 문서도 대화를 이어가면서 컨텍스트를 확보하려면 /compact 를 쓰라고 직접 적어놨습니다.

/clear 는 습관을 들이시는 게 좋습니다. 공식 문서의 비용 문서에 이유가 적혀 있어요. 클로드 코드는 매 요청마다 대화 전체를 다시 보냅니다. 안 지운 긴 대화를 끌고 가면 그만큼 사용량이 빨리 오르고, 세션 한도에 금방 닿습니다. 같은 문서가 /clear 자체는 비용이 들지 않는다고 적어놨습니다.

승인 창이 안 뜨는 날이 옵니다

쓰다 보면 이런 날이 옵니다. 분명히 어제는 물어봤는데, 오늘은 안 물어보고 그냥 고쳐놨어요.

고장 난 거 아닙니다. 모드가 달라진 겁니다. 화면에서 아까 그 자리, 왼쪽 아래만 보시면 지금 어떤 상태인지 바로 나옵니다. 물어보게 하고 싶으면 매뉴얼로 바꾸시면 됩니다.

저는 이 상황에서 처음에 제가 뭘 잘못 눌렀나부터 생각했어요. 그게 아니라 그냥 상태를 한 번 보면 되는 일이었습니다.

되감기로 안 돌아오는 것도 있습니다

아까 그 /rewind, 이것도 한계가 있습니다. 클로드가 고친 파일은 되돌아가는데, 파일을 옮기거나 지운 건 안 돌아옵니다. 공식 문서도 체크포인트가 깃 같은 버전 관리를 대체하는 게 아니라고 못 박아놨습니다.

그럼 그건 어떡하냐. 그 깃이라는 걸 쓰시면 되는데, 깃이 뭔지 모르셔도 됩니다. 클로드한테 말로 시키면 되거든요. 공식 문서의 퀵스타트도 이걸 전부 말로 시키는 예시로 적어놨습니다.

처음 한 번만 이렇게 시킵니다.

이거 깃으로 관리되게 해줘.

그다음부터는 뭔가 제대로 됐다 싶을 때마다 이렇게요.

지금까지 한 거 저장해줘.

그러면 뭘 바꿨는지 설명까지 알아서 붙여서 저장합니다. 이게 쌓이다가 나중에 크게 잘못됐을 때, 아까 저장한 데로 돌려줘. 이러면 그 지점으로 통째로 돌아갑니다.

여기까지는 내 컴퓨터 안에만 있는 겁니다. 깃허브에 올려줘 하시면 인터넷에도 백업이 됩니다. 컴퓨터가 고장 나도 남아 있고, 다른 데서 이어서 할 수도 있어요. 계정은 미리 만들어두셔야 하고 뭘 하나 더 깔라고 할 수도 있는데, 그 과정도 클로드한테 물어보면서 하시면 됩니다.

반대로 안심하셔도 되는 것도 하나 있습니다. 앱을 꺼도 대화는 안 날아갑니다. 왼쪽에 지금까지 한 세션이 남아 있어요. 어제 하다 만 걸 오늘 눌러서 그대로 이어가시면 됩니다.

제가 매일 쓰는 다섯 가지

여기까지 하시면 쓰는 건 다 되신 겁니다. 여기서부터는 결과가 달라지는 것들이에요.

프롬프트는 세 줄로 생각합니다. 뭘 할지, 어느 파일에서 할지, 뭘 하지 말지. 버그 고쳐줘가 아니라 「로그인할 때 비밀번호를 틀리면 빈 화면이 뜨는데 그거 고쳐줘」입니다.

같은 걸 두 번 고쳐달라고 했는데도 안 되면, 세 번째는 하지 않습니다. /clear 하고 새로 시작하는 게 낫습니다. 이건 제가 만든 요령이 아니라 공식 모범 사례 문서에 적혀 있는 겁니다. 실패한 시도가 쌓인 긴 대화보다, 깨끗한 대화에 잘 쓴 요청 하나가 거의 항상 낫다고요. 저도 처음엔 이걸 모르고 한참을 계속 설득하고 있었습니다.

큰 작업은 플랜 모드로 먼저 바꾸고 시킵니다. 파일을 안 건드리고 계획만 짜옵니다. 방향이 틀렸을 때 여기서 잡는 게 훨씬 쌉니다. 공식 문서도 처음 방향이 틀렸을 때 생기는 비싼 재작업을 막는 용도라고 적어놨어요.

뭔가 이상하게 나왔을 때 말로 다시 설명하지 않습니다. 그 화면 그대로 캡처해서 입력창에 끌어다 놓으면 됩니다. 에러 메시지도 똑같아요. 앤트로픽 자료 표현으로는 원래 요청을 다시 바꿔 쓰는 것보다 에러 메시지나 실패한 테스트를 그대로 붙여넣는 게 훨씬 효과적입니다.

딴 데로 가고 있어도 꼭 멈출 필요는 없습니다. 그냥 하고 싶은 말을 치고 엔터를 누르세요. 지금 하던 것까지만 하고 그다음부터 방향을 바꿉니다. 공식 문서에도 정지 버튼으로 즉시 끊는 방법과, 안 멈추고 교정을 보내는 방법이 나란히 적혀 있습니다.

내가 옆에 없을 때를 위한 파일

여기까지가 옆에 붙어서 하는 것들이었습니다. 그런데 매번 모든 걸 반복해서 설명할 수는 없잖아요. 마지막 하나는 그래서 성격이 좀 다릅니다.

/init 을 치면 클로드가 프로젝트를 훑어보고 CLAUDE.md 라는 파일을 만들어줍니다. 이게 매번 세션을 시작할 때 클로드가 알아서 읽는 파일입니다. 내가 옆에 없어도 우리 프로젝트가 뭐고 규칙이 뭔지 알고 시작하게 만드는 거예요. 앤트로픽 온보딩 자료도 첫 주 습관으로 /init 을 일찍 돌리라는 걸 듭니다.

뭘 적어야 하나 싶으실 텐데 거창한 거 안 적으셔도 됩니다. 매번 똑같이 말해주게 되는 것들이면 됩니다. 저는 이 프로젝트에서 뭘 쓰는지, 그리고 뭘 하지 말아야 하는지를 적어둡니다.

만들고 나서 /context 를 다시 쳐보면 제대로 들어갔는지 눈으로 확인할 수 있습니다. 그리고 앞에서 나온 /doctor, 이 파일이 길어지면 줄일 만한 곳도 찾아줍니다.

이 폴더에 있는 것부터 파악해줘. 아직 아무것도 고치지 마.

1. 이 프로젝트가 뭘 하는 건지 한 문단으로 설명해줘.
2. 파일이 어떻게 나뉘어 있는지, 뭐가 어디에 있는지 알려줘.
3. 내가 아래에 적은 걸 하려면 어느 파일을 봐야 하는지만 짚어줘.
4. 마지막에, 지금 이 프로젝트에서 조심해야 할 게 있으면 알려줘.

내가 하고 싶은 것: [예: 로그인 화면에 비밀번호 찾기 버튼 넣기]
지금 내 수준: [예: 코딩 처음 / 다른 언어는 좀 해봤음]