🖼️ 인포그래픽

🖼️ 4컷 인포그래픽

💡 한 줄 결론

Claude Code 사용방법의 핵심은 최신 버전, 작업 디렉토리, CLAUDE.md, 컨텍스트, 세션 관리를 함께 통제해 에이전틱 AI가 파일과 명령을 안전하게 다루게 하는 것이다.

📌 핵심 요점

1. Claude Code는 웹 채팅형 AI와 달리 파일 생성·수정, 명령 실행까지 수행하는 agentic AI이므로, 어느 폴더에서 실행하는지와 어떤 범위에 접근하게 하는지가 중요하다.
2. 작업 폴더는 공백 없는 이름으로 별도 생성하고, 해당 폴더에서 claude를 실행해 프로젝트 단위로 파일·세션·지침이 섞이지 않게 관리하는 흐름이 기본이다.
3. CLAUDE.md, memory.md, status line, context window는 Claude Code가 무엇을 참고하고 얼마나 많은 문맥을 쓰고 있는지 확인하는 핵심 운영 장치다.
4. --continue, --resume, 세션 이름 변경, /compact, /rewind 같은 기능은 장시간 작업에서 대화 흐름을 이어가고, 정리하고, 잘못된 결과를 되돌리는 데 필요하다.
5. 모델과 effort 설정은 작업 난도에 맞춰 선택해야 하며, 단순 구현에는 낮은 설정도 가능하지만 설계·디버깅·오류 수정처럼 정확도가 중요한 단계에서는 더 강한 모델과 높은 effort가 유리하다고 설명된다.

🧩 배경과 문제 정의

• Claude Code는 웹 채팅형 AI와 달리 파일 시스템과 명령 실행에 직접 관여하는 agentic AI이기 때문에, 실행 위치와 작업 범위가 결과에 큰 영향을 준다.
• 실습의 핵심은 최신 Claude Code와 Opus 4.8 환경을 갖춘 뒤, 작업 폴더를 기준으로 실행·버전 확인·업데이트 흐름을 익히는 것이다.
• CLAUDE.md, MEMORY.md, context window, status line, 작업 모드는 AI가 무엇을 읽고 쓸지 통제하기 위한 기본 운영 요소다.

🕒 시간순 섹션별 상세정리

1. Claude Code의 agentic AI 성격과 버전 기준

• Claude Code의 공식 성격은 agentic AI이며, 기존 웹 채팅형 AI처럼 답변만 제공하는 방식이 아니라 AI가 행위 주체가 되어 PC에 직접 영향을 줄 수 있다 [00:29]
• 대표적인 영향은 파일 시스템 변경이다. 기존 파일을 수정하거나 새 파일을 만들 수 있으므로, 실행 환경과 접근 범위를 명확히 이해하는 것이 중요하다 [00:47]

2. 작업 폴더 생성과 명령 프롬프트 실행

• 작업 모드는 기본적으로 auto accept를 켜고 사용하는 흐름이다. 반복 승인 없이 파일 읽기·쓰기와 명령 실행을 처리하는 방식이 Claude Code의 기본 사용법에 가깝다 [02:24]
• Windows 탐색기에서 작업 폴더를 먼저 만들고, 폴더명에는 공백을 넣지 않는 것이 좋다. 이렇게 하면 경로 처리와 명령 실행에서 불필요한 오류를 줄일 수 있다 [03:20]

3. Claude.md, memory.md, context window 확인

• 실행 화면에는 현재 사용 중인 모델과 상태 정보가 표시되며, 로그인이 되어 있지 않다면 먼저 계정 인증을 진행해야 한다 [05:39]
• Claude.md와 memory.md는 Claude Code 운용에서 중요한 파일이다. AI의 작동 방식을 이해하면 이 파일들이 왜 필요한지도 자연스럽게 연결된다 [06:09]

4. 모드 전환과 실제 파일 작업 방식

• Shift+Tab으로 모드를 전환할 수 있으며, plan mode는 곧바로 코드 생성이나 파일 변경을 하기보다 먼저 작업 계획을 세우는 모드다 [08:35]
• auto mode는 파일 읽기·쓰기와 명령 실행을 자동으로 진행하는 방식이고, normal mode는 작업마다 사용자 승인 여부를 확인하는 방식이다 [09:05]

5. Windows 환경에서 Bash 계열 명령이 동작하는 이유

• mkdir은 Ubuntu/Linux 계열에서 익숙한 명령이지만, Windows에서도 md나 mkdir 형태로 디렉터리 생성 명령을 사용할 수 있다 [11:04]
• 테스트 폴더를 md와 mkdir 계열 명령으로 만든 뒤 dir/ls로 확인하면 새 폴더가 목록에 표시된다. 이처럼 Windows 명령과 Bash 계열 명령이 함께 쓰일 수 있다 [11:23]

6. 세션 이어가기와 파일 생성 기본 동작

• Claude Code를 종료한 뒤 이전 대화를 이어가려면 실행 시 --continue를 붙이면 되고, 짧게는 -c 옵션으로 같은 대화 세션을 다시 열 수 있다 [12:10]
• 파일 생성 요청은 현재 작업 디렉토리를 기준으로 실행된다. 예시에서는 test.txt가 프론트엔드 폴더 안에 만들어졌고, 내용이 없어 파일 크기는 0으로 남는다 [12:35]

7. 대화 기록 탐색과 저장된 세션 복구

• 입력 히스토리는 위쪽 화살표로 일부 확인할 수 있고, ESC를 두 번 누르면 남아 있는 기록의 특정 지점으로 돌아갈 수 있어 이전 대화 상태 복구에 유용하다 [13:36]
• Ctrl+C로 종료한 뒤 claude만 다시 실행하면 새 세션처럼 열려 이전 대화가 바로 보이지 않지만, 기존 기록이 삭제된 것은 아니다 [14:16]

8. 세션 이름 관리와 모델 선택

• 저장된 세션 목록은 마지막 입력 명령 위주로 표시되어 대화 내용을 구분하기 어렵기 때문에, rename으로 현재 세션에 이름을 붙여두는 것이 좋다 [15:42]
• 예시처럼 “수업용 대화 샘플”이라는 이름을 붙이면 resume 목록에서 해당 세션이 명확히 표시되어 작업 맥락을 다시 찾기 쉬워진다 [16:08]

9. 컨텍스트 정리와 Claude.md 초기화

• Haiku는 빠르지만 Opus보다 성능이 크게 낮아 단순 작업에 적합하고, Sonnet은 더 복잡한 작업에 쓸 수 있으나 기본 사용 습관은 Opus 4.8에 가깝다 [17:28]
• /clear는 현재 대화 이력을 초기화하는 명령이고, 실전에서는 대화 내용을 정리해 핵심만 압축한 채 세션을 이어가는 /compact가 더 자주 쓰인다 [18:07]

10. 리와인드로 대화와 코드 되돌리기

• /rewind는 타임머신처럼 과거 상태로 되돌리는 기능이며, 명령을 직접 쓰거나 ESC를 두 번 빠르게 눌러 이전 지점을 선택할 수 있다 [19:20]
• 되돌리기 대상은 대화뿐 아니라 코드 변경까지 포함될 수 있고, 예를 들어 D 상태에서 B로 돌아가면 C와 D는 처음부터 없었던 것처럼 처리된다 [19:54]

11. 작업 디렉토리와 세션 혼합 위험

• CLAUDE.md와 세션은 작업 폴더 맥락에 연결되며, Claude Code를 사용하면 프로젝트 안에 .claude 디렉토리가 생겨 작업 상태와 관련 정보가 쌓인다 [21:42]
• 같은 작업 디렉토리의 진행 중인 세션을 다른 명령 프롬프트에서 다시 열어 입력하면, 서로 다른 창의 대화 기록이 섞이고 위쪽 히스토리에도 함께 나타난다 [22:24]

12. 디렉토리별 세션 분리와 상위 폴더의 역할

• CLAUDE.md 지침 파일은 작업 디렉토리마다 하나씩 두는 구조가 적절하며, 대화 세션은 특정 디렉토리 경로와 밀접하게 연결된다 [24:01]
• 상위 바이브 코딩 폴더 아래에 A, B, C, 프론트, 백엔드 같은 하위 폴더를 두면 각 위치에서 Claude Code 세션을 따로 실행할 수 있다 [24:40]

13. 경로 변경이 대화 맥락과 기록 관리에 주는 영향

• D드라이브/바이브코딩/A에서 작업하던 디렉토리를 D드라이브/A로 옮기면 경로가 달라져 기존 대화 세션에 입력했던 내용의 효력이 약해진다 [26:00]
• 디렉토리 구조는 한 번 정하면 되도록 유지하는 편이 안전하며, 변경할 경우 일부 대화 맥락과 기록을 잃을 가능성을 감수해야 한다 [26:30]

14. 좋은 모델과 초기 설계가 토큰 낭비를 줄이는 구조

• 하이쿠 모델보다 더 좋은 모델을 사용하고, 처음부터 오류가 적은 코드와 구조로 출발하는 전략이 선호된다 [27:04]
• 비싼 모델을 쓰더라도 초기 오류를 줄이면 이후 에러 수정 과정에서 발생하는 큰 토큰 소모를 피할 수 있다 [27:31]

15. effort 설정과 울트라 코드 사용 범위

• 같은 모델이라도 effort 설정에 따라 응답 속도, 사고 깊이, 토큰 사용량이 달라지며, Claude Code 옵션에서는 기본값이 하이로 잡혀 있다 [28:52]
• X-high는 더 깊게 생각하는 대신 속도가 느려지고 토큰을 더 쓰지만, 오류를 줄이고 복잡한 문제를 다룰 때 유리하다 [29:16]

16. 작업 유형별 모델·effort 선택 기준

• effort를 높이면 AI의 응답 속도는 느려지지만 사고 깊이가 늘어나고, 그만큼 실수 가능성은 줄어든다 [30:25]
• 복잡한 문제일수록 정확도 차이가 커지며, 특히 디버깅과 문제 해결 단계에서 effort 설정의 영향이 크게 드러난다 [31:14]

17. init 명령과 CLAUDE.md 지침 파일의 기능

• /init 명령은 현재 작업 디렉토리와 대화 세션에 연결되는 CLAUDE.md 파일을 만들고, 이후 코드 생성의 기준 지침으로 사용된다 [32:11]
• CLAUDE.md에는 프로젝트 구조, 아키텍처, 기술 스택, 코딩 컨벤션, 응답 언어, 저장소 URL, 작업 디렉토리 제한, 자주 쓰는 명령과 주의사항을 정리할 수 있다 [33:15]

18. 대화 세션은 매번 새 입력과 누적 컨텍스트의 결합으로 작동한다

• A, B, C처럼 이어지는 질문도 LLM 입장에서는 매번 새로운 입력이며, 뒤쪽 질문은 기존 대화에서 쌓인 컨텍스트와 현재 질문이 결합된 형태로 처리된다 [36:08]
• 대화 세션이 사라지는 상황을 과도하게 걱정하기보다, 클로드 코드가 매번 새롭게 작동한다는 구조를 이해하고 컨텍스트를 관리하는 것이 더 중요하다 [36:37]

19. 코드 분석 품질은 검색어와 파일·폴더 구조에 크게 좌우된다

• 코드 분석에서 가장 많이 쓰이는 행동은 검색이므로, 프롬프트 안에 검색 도구가 활용할 만한 검색어를 명확히 넣어야 원하는 패턴을 찾기 쉽다 [37:34]
• 클로드 코드는 파일 내용뿐 아니라 디렉토리 구조와 파일 목록도 확인하며, 파일명을 바탕으로 관련 위치를 추정한 뒤 내부 패턴을 찾아간다 [38:10]

20. 메모리 시스템은 규칙과 사용자 정보를 세션마다 다시 불러온다

• 클로드 코드에는 메모리 시스템이 있으며, 대화 중 필요하다고 판단한 주의사항을 문서로 남겨 이후 작업에서 다시 활용한다 [39:31]
• MEMORY.md는 모든 상세 내용을 담는 파일이 아니라 인덱스에 가깝고, 실제 내용은 보안처럼 주제별로 분리된 별도 MD 파일에 저장된다 [39:59]

21. 스킬과 플러그인은 반복 지시를 표준화하지만 출처 검증이 필요하다

• 반복 입력해야 하는 프롬프트나 작업 지시는 스킬로 묶을 수 있으며, 매크로처럼 같은 말을 반복하지 않아도 AI 행동에 강제성과 일관성을 줄 수 있다 [41:54]
• 스킬은 재사용 가능한 지시 사항에 가깝고, 여러 스킬을 모아 만든 것이 플러그인이며, 같은 내용을 반복 투입해야 결과의 일관성을 높이기 쉽다 [42:41]

22. 대규모 병렬 기능은 토큰 비용이 커서 실습·리뷰 중심으로 제한하는 편이 낫다

• 플러그인은 명령으로 실행해 공식 마켓의 항목을 사용할 수 있으며, 필요한 기능만 골라 쓰는 방식이 적절하다 [44:15]
• Dynamic Workflow나 Ultra Code 같은 대규모 병렬 기능은 리뷰를 빠르게 처리할 때 유용하지만, Pro Max 버전에서도 한 시간 정도면 사용량 한도에 걸릴 만큼 토큰 소모가 크므로 필요한 장면에 제한해 쓰는 편이 현실적이다 [44:38]

🧾 결론

• 이 강의는 Claude Code를 단순한 코드 생성 도구가 아니라, 파일 시스템과 명령 실행 권한을 가진 작업 에이전트로 이해해야 한다는 점을 강조한다.
• 좋은 사용법은 명령어를 많이 외우는 것보다 작업 디렉토리, 세션, 지침 파일, 컨텍스트 사용량을 안정적으로 관리하는 데서 출발한다.
• CLAUDE.md는 프로젝트 구조, 기술 스택, 코딩 규칙, 작업 제한, 자주 쓰는 명령 등을 담아 Claude Code의 행동을 고정하는 기준점 역할을 한다.
• 세션이 저장되더라도 경로가 바뀌거나 같은 디렉토리에서 여러 세션이 섞이면 작업 맥락이 흐려질 수 있으므로, 폴더 구조는 초기에 신중하게 잡는 편이 좋다.
• AI가 잘못된 결과를 냈을 때 계속 수정 지시를 쌓기보다 /rewind나 히스토리 복구를 활용해 문제 발생 전 상태로 돌아가는 방식이 더 깔끔한 대응이 될 수 있다.

📈 투자·시사 포인트

• Claude Code를 실무에 도입할 때는 모델 성능보다 먼저 작업 루트, 세션 분리, 지침 파일, 컨텍스트 관리 규칙을 정하는 운영 체계가 중요하다.
• 초기 설계와 폴더 구조를 잘 잡으면 이후 오류 수정, 토큰 소모, 세션 혼선이 줄어들 수 있어 장기 작업의 생산성에 직접 영향을 준다.
• 스킬과 플러그인은 반복 작업을 표준화하는 데 도움이 되지만, 출처가 불분명한 항목은 보안 위험이 있으므로 검증된 것만 제한적으로 사용하는 접근이 필요하다.
• 대규모 병렬 기능이나 Deep Research 계열 기능은 토큰 사용량이 크다고 설명되므로, 일반 개발 작업보다는 리뷰·리서치처럼 필요한 순간에 제한적으로 쓰는 전략이 적절하다.
• 검증 필요: 강의에서 언급된 Claude Code 2.1.154 이상, 예시 버전 2.1.168, Opus 4.8 관련 조건은 강의 시점 기준이므로 실제 설치·운영 전 현재 공식 버전과 지원 모델을 별도로 확인해야 한다.

⚠️ 불확실하거나 확인이 필요한 부분

• Opus 4.8 사용을 위해 Claude Code 2.1.154 이상이 필요하고 예시 버전이 2.1.168이라는 설명은 2026년 6월 8일 기준이므로, 현재 최신 버전과 모델 지원 조건은 별도 확인이 필요하다.
• 대화 히스토리가 C드라이브의 특정 경로에 저장되고 디스크가 허용하는 범위 안에서 계속 보존된다는 설명은 구체적인 저장 경로와 보존 제한이 명확하지 않아 환경별 확인이 필요하다.
• /clear와 /compact의 내부 차이가 크지 않을 수 있다는 설명은 실사용 관점의 해석에 가깝기 때문에, 정확한 차이는 공식 문서나 실제 테스트로 검증해야 한다.
• 자막 기반 정리: 타임스탬프가 있는 자막을 기준으로 정리했으며, 고유명사·수치·인용은 원문 확인 필요 시 별도 검증한다.
• 영상 속 주장: 발표자의 해석·전망·비교는 확인된 외부 사실이 아니라 영상 속 주장으로 분리해 읽는다.
• 검증 필요: 수치, 기업 실적, 정책·시장 전망은 발행 전 최신 자료로 별도 검증이 필요하다.

✅ 액션 아이템

• Claude Code를 실행할 프로젝트별 작업 루트를 만들고, 폴더명에는 공백을 넣지 않도록 정리한다.
• 작업 폴더에서 claude -v로 버전을 확인하고, 필요한 경우 업데이트 후 실습을 시작한다.
• status line에 작업 디렉토리, 모델명, 컨텍스트 사용량이 보이도록 설정한다.
• /init으로 프로젝트별 CLAUDE.md를 만들고, 기술 스택·코딩 규칙·금지사항·자주 쓰는 명령을 정리한다.

❓ 열린 질문

• 프로젝트별로 CLAUDE.md에 어디까지 상세한 규칙을 넣는 것이 hallucination을 줄이면서도 컨텍스트 낭비를 최소화할 수 있을까요?
• 한 작업 디렉토리 안에서 프론트엔드, 백엔드, 문서 작업을 나눌 때 어느 수준까지 하위 폴더별 세션을 분리하는 것이 안전할까요?
• Opus, Sonnet, Haiku와 effort 설정을 작업 유형별로 나누는 실전 기준은 팀이나 프로젝트 규모에 따라 어떻게 달라져야 할까요?