기본 콘텐츠로 건너뛰기

4월 5, 2026의 게시물 표시

클로드 코드 왕초보 가이드 11편 — Git으로 작업 안전하게 저장하기 2026

Photo by carmen dominguez on Unsplash 클로드 코드 왕초보 가이드 — 11편 전체 목차 보기 Claude Code로 파일을 수정하다가 "아, 아까 그 버전이 더 나았는데" 싶은 적 있으신가요? Ctrl+Z를 연타해도 돌아가지 않는 그 순간. Git을 쓰면 무한 Ctrl+Z가 됩니다. 비개발자도 세 마디면 끝납니다. AI한테 파일을 고치라고 시키면, 파일이 순식간에 바뀝니다. 한 번이면 괜찮은데 두세 번 고치다 보면 "처음 버전이 나았다"는 생각이 듭니다. 문제는 그때 이미 처음 버전이 사라져 있다는 겁니다. 광고 자리 (AdSense 승인 후 교체) 왜 저장이 따로 필요한가 일반적인 문서 작업이라면 Ctrl+S 하나로 충분합니다. 하지만 Claude Code와 함께 작업하면 상황이 다릅니다. AI가 한 번에 여러 파일을 동시에 수정합니다 "이것도 고쳐줘"를 3번 반복하면 원본이 어땠는지 기억이 안 납니다 Ctrl+Z는 현재 열려 있는 파일 하나만 되돌립니다 "2시간 전 상태로 통째로 돌아가고 싶다"는 불가능합니다 Git은 이 문제를 해결합니다. 작업 폴더 전체를 특정 시점으로 되돌리는 타임머신입니다. Google Drive vs Git — 뭐가 다른가요 "Google Drive도 버전 기록이 있잖아요?"라고 생각하실 수 있습니다. 맞습니다. 하지만 성격이 다릅니다. 항목 Google Drive Git 저장 방식 자동 저장 (알아서 됨) 직접 저장 (내가 "저장해줘"라고 해야 됨) 저장 단위 ...

클로드 코드 왕초보 가이드 10편 — AI 비용 아끼는 7가지 습관 2026

Photo by SHASHANK K on Unsplash Claude Code를 신나게 쓰다가 월말에 청구서를 보고 놀란 적 있다면, 원인은 대부분 같습니다. "비싼 모델로 간단한 일을 시켰거나, 대화를 너무 길게 끌었거나." 오늘 정리하는 7가지 습관이면 같은 작업을 하면서도 비용을 절반 이하로 줄일 수 있습니다. "나는 구독제(Pro/Max)인데 비용이 왜 중요하지?" 이렇게 생각할 수 있습니다. 구독제도 사용량에 따라 속도 제한이 걸립니다. 한마디로, 돈이 아니라 "속도"를 아끼는 겁니다. 습관을 들이면 같은 구독료로 훨씬 많은 작업을 처리할 수 있습니다. 토큰 — AI 비용의 기본 단위 AI는 글자가 아니라 "토큰"이라는 단위로 텍스트를 처리합니다. 핸드폰 데이터에 비유하면 이해가 쉽습니다. 핸드폰 데이터 — 영상 보면 많이 쓰고, 텍스트 메시지는 거의 안 씀 AI 토큰 — 긴 파일 읽히면 많이 쓰고, 짧은 질문은 거의 안 씀 한국어 기준 대략 2~3글자가 1토큰입니다. 영어는 한 단어가 보통 1토큰. 즉 한국어가 영어보다 토큰을 더 많이 씁니다. "안녕하세요"는 약 3~4토큰, "Hello"는 1토큰입니다. 비용이 뛰는 3가지 상황 상황 왜 비용이 뛰나 체감 비유 큰 파일을 통째로 읽힐 때 수천 줄 파일 = 수천 토큰이 한 번에 소모 고화질 영상 스트리밍 대화를 너무 길게 끌 때 AI는 매번 전체 대화를 다시 읽음 같은 영상을 계속 다시 재생 ...

클로드 코드 왕초보 가이드 9편 — 이런 에러 나왔어요, 당황하지 마세요 2026

Photo by Solomon Dredzen on Unsplash 터미널에 빨간 글씨가 뜨면 심장이 한 번 쿵 합니다. "뭘 잘못한 거지?" 하는 생각이 먼저 듭니다. 다행히 Claude Code에서 만나는 에러 대부분은 패턴이 정해져 있습니다. 7가지만 알면 90%는 스스로 해결됩니다. 저도 처음 Claude Code를 깔았을 때 command not found 가 뜨고 멘붕이 왔습니다. 코딩을 전혀 몰랐으니 에러 메시지 자체가 외국어였습니다. 그런데 몇 번 겪다 보니 깨달았습니다. 에러는 "고장"이 아니라 "안내문"입니다. 뭘 고치면 되는지 알려주는 겁니다. 에러 1 — "command not found: claude" Claude Code를 설치하고 신나게 claude 를 입력했는데 이런 메시지가 뜹니다. bash: command not found: claude 컴퓨터가 "claude라는 프로그램을 못 찾겠다"고 말하는 겁니다. 설치가 안 된 건 아닙니다. 터미널이 설치된 위치를 아직 인식하지 못하는 상태입니다. 해결법 터미널을 완전히 닫고 새로 엽니다. 설치 직후에는 경로 정보가 갱신되지 않은 상태입니다. 새 터미널을 열면 대부분 해결됩니다. 그래도 안 되면 재설치 합니다. npm install -g @anthropic-ai/claude-code 설치 과정이 기억나지 않는다면 3편 설치 가이드 를 다시 확인해보세요. 에러 2~4 — 로그인, 속도, 지시 무시 문제 에러 2: 로그인이 안 됩니다 claude 를 실행하면 브라우저에서 인증하라는 메시지가 뜹니다. 그런데 브라우저가 자동으로 안 열리거나, 열려도 인증이 완료되지 않을 때가 있습니다. 1 인증 URL...

AI가 까먹을 때 대처법 — 세션 관리 완전 가이드 (왕초보 가이드 8편 완결)

Photo by Alexey Demidov on Unsplash AI가 10분 전에 알려준 내용을 갑자기 까먹는 건 고장이 아닙니다. "책상"이 꽉 찬 겁니다. 컨텍스트 윈도우 개념부터 /compact, --continue까지 — 대화를 끊지 않고 이어가는 방법을 정리했습니다. Claude Code를 쓰다 보면 분명히 아까 설명한 내용인데 AI가 처음 듣는 것처럼 반응할 때가 있습니다. 당황스럽지만 이건 AI가 멍청해진 게 아닙니다. 원인을 알면 간단히 해결됩니다. 컨텍스트 윈도우 — AI의 책상 크기 AI는 대화할 때 모든 내용을 책상 위에 펼쳐놓고 일합니다. 이 책상의 크기를 "컨텍스트 윈도우"라고 부릅니다. 한마디로, AI가 동시에 기억할 수 있는 정보의 총량입니다. 문제는 책상 크기가 무한하지 않다는 점입니다. 대화가 길어질수록 서류가 쌓이고, 공간이 부족해지면 오래된 내용부터 바닥에 떨어집니다. 떨어진 서류는 AI가 더 이상 볼 수 없습니다. 책상이 꽉 차면 나타나는 증상 앞에서 내렸던 지시를 무시하고 엉뚱하게 작업 같은 실수를 반복하면서 고치지 못함 답변 품질이 눈에 띄게 떨어지기 시작 분명히 알려준 파일 경로나 규칙을 "모른다"고 답변 핵심 포인트: AI가 갑자기 이상해지면 먼저 "대화가 너무 길어진 건 아닌가?"부터 의심하세요. 대부분 여기서 원인이 해결됩니다. /compact — 책상 정리 명령어 /compact는 지금까지 쌓인 대화 내용을 한 장짜리 요약본으로 압축하는 명령어입니다. 책상 위에 어지럽게 쌓인 서류를 한 장짜리 메모로 바꾼다고 생각하면 됩니다. 공간이 확보되면서 AI가 다시 정상적으로 작업할 수 있게 됩니다. 기본 사용법 /compact ...

AI한테 업무 매뉴얼 만들어주기 — CLAUDE.md 완전 가이드 (왕초보 가이드 7편)

Photo by Óscar Gutiérrez on Unsplash 클로드 코드 왕초보 가이드 — 7/18편 전체 목차 보기 "한국어로 써줘." "보고서 형식은 이렇게 해줘." 매번 새 대화를 시작할 때마다 같은 말을 반복하고 있었습니다. CLAUDE.md 파일 하나 만들어놓으면 이 반복이 사라집니다. 3줄이면 충분합니다. 새 직원이 들어오면 업무 매뉴얼을 줍니다. "우리 팀은 보고서를 이 형식으로 쓰고, 고객 이름은 절대 외부에 공개하지 않는다." Claude Code도 마찬가지입니다. 매뉴얼을 써놓으면 매번 말할 필요가 없습니다. CLAUDE.md가 뭔가요 프로젝트 폴더에 넣어두는 텍스트 파일입니다. Claude Code가 시작될 때 이 파일을 자동으로 읽고, 그 안에 적힌 규칙을 따릅니다. 비유하자면 이렇습니다. 회사 Claude Code 부서 업무 매뉴얼 CLAUDE.md 파일 매뉴얼을 읽고 일하는 직원 Claude Code "항상 존댓말로 써", "약어 쓰지 마" CLAUDE.md에 적은 규칙 매번 "한국어로 써줘"라고 말하는 대신, CLAUDE.md에 한 번만 적어두면 됩니다. Claude Code가 알아서 읽고 지킵니다. 어디에 만들고, 어떻게 만드나요 위치 작업 폴더 최상위에 CLAUDE.md 라는 이름으로 만듭니다. 위치 파일명 적용 범위 작업 폴더 ./CLAUDE.md 이 프로젝트에서만 적용 ...

클로드 코드 필수 명령어 5개 — 이것만 알면 됩니다 (왕초보 가이드 6편)

Photo by olivia kim on Unsplash Claude Code 명령어는 5개만 알면 됩니다. /help, /cost, /compact, /clear, Esc — 매일 쓰는 건 이게 전부입니다. 수십 가지 명령어가 있다고 하니 겁부터 납니다. 처음 터미널을 켰을 때 저도 그랬습니다. 그런데 실제로 한 달 넘게 쓰면서 매일 손이 가는 건 딱 5개뿐이었습니다. 명령어 5개, 한눈에 보기 먼저 전체 그림부터 잡겠습니다. 아래 표 하나면 됩니다. 명령어 한 줄 설명 일상 비유 /help 명령어 목록 보기 회사 내선번호 목록표 /cost 사용 비용 확인 핸드폰 데이터 사용량 확인 /compact 대화 압축 정리 책상 위 서류 핵심만 남기고 정리 /clear 대화 전부 초기화 책상을 싹 치우고 새 일 시작 Esc 멈추기 / 되감기 급브레이크 나머지 명령어는 "이런 게 있구나" 정도만 알아두면 됩니다. 필요할 때 /help로 찾아보면 되니까요. 하나씩 살펴봅니다 1 /help — 모르겠으면 물어보기 일상 비유: 회사에서 내선번호 목록표를 펼치는 것과 같습니다. "이 부서 번호가 몇 번이지?" 할 때 목록표를 보듯이, "이 명령어가 뭐였지?" 할 때 /help를 입력합니다. /h...