클로드 코드 초보 필수 명령어 꿀팁 모음.zip
Claude Code 초보가 반드시 읽어야 할 정보 모음집!
안녕하세요 비니예요! 요즘 저도 개발 공부를 슬슬 시작했는데요...
Claude Code라는 걸 쓰기 시작하면서 세상이 좀 달라졌어요ㅎㅎ
그래서 오늘은 제가 직접 써보면서 알게 된 것들을 공유해보려고 해요!
터미널에서 AI랑 같이 작업하는 게 이렇게 편할 줄 몰랐는데요!
너무너무 편한 클로드 코드이지만... 처음에 진짜 헷갈리는 게 있었어요.
슬래시(/)로 시작하는 명령어가 너무 많은데, 어떤 건 커맨드고 어떤 건 스킬이라고 하더라고요ㅠㅠ
저처럼 헷갈리는 분들 분명 계실 것 같아서! 저도 복습 기록 겸 공유해드리려고 해요~
Claude Code가 일반 AI와 다른 점은?
Claude Code는 브라우저에서 채팅하는 것과는 많이 다른데요!
터미널에서 직접 파일을 읽고, 수정하고, 작업을 나눠서 처리할 수 있거든요.
그래서 한 번 좋은 프롬프트를 쓰는 것보다,
반복해서 같은 방식으로 작업이 돌아가게 만드는 게 더 중요해요.
저도 처음엔 그냥 코드 추천해주는 도구인 줄 알았는데,
써보니까 작업 흐름 자체를 관리하는 느낌이 더 강한 것 같더라고요!
클로드 코드 커맨드와 스킬, 뭐가 다른 거예요?
커맨드는 버튼 같은 고정 기능
커맨드는 /clear, /compact, /help 이런 것들이에요.
누르면 딱 정해진 동작이 바로 실행돼요! /clear를 치면 대화가 초기화되고,
/compact를 치면 대화 내용이 압축되는 식이에요.
Claude가 뭔가 판단할 필요 없이, 고정된 로직이 바로 돌아가는 것들을 "커맨드"라고 해요!
스킬은 작업 방식을 정해주는 플레이북
스킬은 /batch, /simplify, /loop 같은 것들인데요. 이건 좀 달라요!
SKILL.md라는 파일에 적힌 절차를 Claude가 읽고 따라서 실행하는 구조예요.
그래서 같은 /simplify를 써도 상황에 따라 결과가 조금씩 달라질 수 있어요.
정리하면 커맨드는 기능이고, 스킬은 방식이에요.
이 차이를 알고 나니까 전체 구조가 훨씬 잘 보이더라고요!
클로드 코드 초보가 꼭 알아야 할 명령어 TOP 4
제가 직접 써보면서 제일 자주 쓰게 된 것들 골라봤어요!
/compact - 대화 정리의 핵심
대화가 길어지면 Claude 응답이 산만해질 수 있어요.
이때 /compact를 쓰면 컨텍스트를 압축해줘요!
저는 작업 주제가 바뀔 때마다 꼭 한 번씩 써요ㅎㅎ
/clear - 새 출발
작업 방향이 완전히 달라졌을 때는 /clear로 대화를 싹 비우는 게 좋아요.
이전 맥락이 남아 있으면 엉뚱한 방향으로 갈 수 있거든요ㅠ
/init - 프로젝트 시작할 때 필수
프로젝트를 Claude Code로 제대로 관리하려면 /init으로 CLAUDE.md를 먼저 만들어두는 게 좋아요.
프로젝트의 기본 설정 같은 거라고 생각하면 돼요~
/simplify - 코드 품질 마지막 점검
작업이 끝난 뒤에 /simplify를 돌리면 코드 재사용성이나 효율성 문제를 잡아줘요!
실제로 커뮤니티에서도 거의 모든 작업의 마지막에 이걸 돌린다는 분들이 꽤 있더라고요.
나만의 커스텀 스킬 만드는 법
이게 진짜 꿀팁이에요!! 반복되는 작업이 있으면 SKILL.md 파일을 만들어서 저장해둘 수 있어요.
SKILL.md 파일 구조
~/.claude/skills/ 폴더 안에 디렉터리를 하나 만들고, 그 안에 SKILL.md를 넣으면 돼요.
파일 안에는 name, description, 그리고 instructions를 적어요.
여기서 description이 중요한데요,
Claude가 이 설명을 보고 언제 이 스킬을 자동으로 꺼낼지 판단하거든요!
description 잘 쓰는 팁
너무 넓게 쓰면 자동 호출이 잘 안 돼요. 예를 들어 그냥 문서 도우미라고 쓰면 너무 막연하잖아요? PDF에서 텍스트와 표를 추출해야 할 때 사용 이런 식으로 구체적으로 적어야 해요~
클로드 코드 스킬 실사용 후기!
저도 공식 문서를 따라서 explain-code라는 스킬을 만들어봤는데요.
코드를 설명할 때 ASCII 다이어그램을 넣고 단계별로 풀어주는 방식을 고정한 거예요.
결과는 나름대로 꽤 괜찮았어요!
근데 솔직히 Claude는 원래 코드 설명을 잘하거든요ㅎㅎ
그래서 처음엔 이게 뭐가 다른 건지 싶었는데...
핵심은 매번 같은 형식으로 결과가 나온다는 거였어요.
프롬프트를 매번 새로 쓰면 결과 형식이 들쭉날쭉한데,
스킬로 만들어두니까 일정한 퀄리티가 유지되더라고요!
클로드 코드 활용 시 주의할 점
세션이 무거워질 때 대처법
대화가 길어지면 토큰이 많이 쌓여요.
/compact를 적절히 쓰고, 큰 작업 사이에는 세션을 정리하는 습관이 중요해요~
YAML 문법 체크는 필수
스킬이 발동하지 않는다면 SKILL.md의 YAML 부분부터 확인해보세요!
들여쓰기가 틀리거나 --- 태그가 안 닫혀 있으면 로드 자체가 안 될 수 있어요ㅠㅠ
권한 설정도 챙기기
/permissions로 Claude에게 어디까지 자동 권한을 줄지 정해두는 게 좋아요.
매번 승인 버튼 누르는 것도 은근 번거롭거든요...
AI 코딩 관련 정보 더 알고 싶다면
참고로 저는 요즘 AI나 코딩 관련 최신 정보를 찾을 때 AI 서대표라는 채널을 자주 보고 있어요~
외주개발사 똑똑한개발자의 대표이신 서장원님이 운영하시는 채널인데요.
Claude Code 같은 AI 코딩 도구 활용 꿀팁이나 개발 트렌드 관련 콘텐츠가 꽤 알차더라고요!
저처럼 비개발자인데 개발 공부 시작한 분들한테도 도움이 많이 되는 내용이라 추천드려요ㅎㅎ
Ai 서대표 유튜브 링크:
Ai 전문 개발사 똑똑한개발자 링크:
마무리
오늘은 Claude Code의 커맨드와 스킬 차이, 자주 쓰는 명령어, 커스텀 스킬 만드는 법까지 정리해봤어요~
저도 아직 배우는 중이라 부족한 부분이 있을 수 있는데,
같이 공부하는 마음으로 봐주시면 좋겠어요ㅎㅎ
핵심은 명령어를 많이 외우는 게 아니라,
반복되는 작업을 어떻게 재사용 가능하게 만드느냐인 것 같아요!
여러분도 한번 직접 스킬 만들어보세요~ 생각보다 재밌답니당 ㅎㅎ
그럼 다음에 또 유용한 꿀팁 들고 올게요, 안녕~!