이 블로그 읽는 법
솔직히 말하면
CLAUDE.md, Skills, Subagents, Johnny Decimal. 처음 보는 사람한테는 외계어입니다.
설명을 읽었는데 뭘 해야 하는지 모르겠고, 따라 하려는데 내 상황이랑 다르고, 중간에 모르는 용어가 나오면 거기서 멈춥니다.
설명서를 읽는 것과 실제로 만져보는 건 다릅니다.
그래서 방법이 하나 있습니다. 이 블로그를 Claude Code와 같이 읽는 겁니다.
읽으면서, 시켜보세요
이 블로그는 제가 Claude Code로 일을 하며 만든 환경을 설명합니다. 왜 그렇게 나눴는지, 무엇을 맡겼는지, 결과가 마음에 들지 않아 어디를 고쳤는지요.
제 폴더와 스킬을 그대로 갖추는 것이 목표는 아닙니다. 자기 일에서 비슷한 불편을 찾고, 필요한 자료와 판단 기준을 설명해 자기 방식을 만들어가면 됩니다.
처음에는 1편, Claude Code 설치하고 시작하기를 직접 보면서 설치하고 첫 대화를 해보세요. 제가 현재 쓰는 Orca에서 작업 폴더를 열고 대화하는 과정도 설명했습니다.
그다음부터는 읽을 글의 URL을 Claude Code에 줄 수 있습니다. 예를 들면 이렇게 말하는 겁니다.
나는 아직 Claude Code를 잘 모르는 사람이야.
이 글을 읽고 다운로드 폴더 정리를 함께 해보고 싶어.
https://claude-code.imiwork.com/file-system-as-memory-5/
글에서 한 일과 지금 내 컴퓨터에서 할 일을 구분해서 설명해줘.
내가 원하는 분류 기준이 필요하면 질문하고,
먼저 정리 계획을 보여줘.
계획을 같이 맞춘 뒤 실행하고 결과를 확인하자.
모르는 용어는 그때 설명해줘.
Claude Code는 글을 읽고, 내 폴더를 살펴보고, 어떻게 진행할지 제안할 수 있습니다. 페이지를 읽지 못했다면 읽었다고 넘어가지 말고, 필요한 본문을 함께 보면서 이어가면 됩니다.
글의 URL을 주는 것과 제 환경이 설치되는 것은 다릅니다. 메일을 읽는 예시라면 자기 계정 연결과 권한이 필요하고, 제 업무 기준이 나온다면 자기 일에 맞는 기준을 이야기해야 합니다.
AI에게 자료 탐색과 구성을 맡깁니다. 저는 무엇을 원하는지 설명하고, 제안이 제 일에 맞는지, 실제 결과가 요청과 맞는지 봅니다. 모르는 게 나오면 물어보면 됩니다. “이게 무슨 뜻이야?” 하면 설명해줍니다.
전부 이해하고 시작하는 게 아닙니다. 해보면서 이해하는 겁니다.
처음이라면 이 흐름으로
글 제목의 번호는 예전에 발행한 순서입니다. 도구가 바뀌면서 지금 권하는 학습 순서는 달라졌습니다. URL과 발행일은 유지했기 때문에 사이트 아래의 자동 ‘이전 글·다음 글’도 이 순서와 다를 수 있습니다.
아래에서는 사용 이유→첫 작업→내 자료와 기준→외부 연결→스킬→역할 분리와 확인으로 이어집니다. 글 번호를 외울 필요는 없습니다. 링크를 따라가다가 자기 일에 써보고 싶은 지점에서 멈춰도 됩니다.
왜 쓰는지 보고, 실제 일을 맡깁니다
- 왜 나는 CLI 워크스페이스를 만들게 되었나: 파일과 판단이 흩어지고, 같은 설명을 다시 하던 불편에서 시작한 이유입니다. 어떤 환경을 만들려는지 먼저 볼 수 있습니다.
- 1. Claude Code 설치하고 시작하기: 프로그램을 설치하고 작업할 폴더를 열어, 한국어로 첫 대화를 합니다.
- 2. AI에게 다운로드 폴더 정리를 맡겨보기: 방법을 답하는 LLM과 도구로 실제 일을 하는 에이전트의 차이를 봅니다. 계획을 받고, 내 기준을 더하고, 실행 결과를 확인합니다.
여기까지 해보면 ‘AI에게 설명을 듣는다’에서 ‘AI와 실제 일을 한다’로 무엇이 달라지는지 볼 수 있습니다.
자료와 기준을 다음 일에 씁니다
- 4. 일이 이어지는 나의 워크스페이스: 제가 폴더를 나눈 이유와, 자료·판단·결과를 다음 일에 쓰는 관계를 봅니다. 같은 폴더를 전부 만드는 과정은 아닙니다.
- 3. CLAUDE.md로 나와 내 일을 알려주는 법: 매번 반복하던 설명 중 무엇을 안내로 남길지 봅니다. 지침, 자동 기억, 업무 자료가 어떻게 다른지도 구분합니다.
폴더 구조부터 보고 CLAUDE.md로 넘어가는 이유는, 어디에 어떤 자료가 있는지와 그 자료로 어떻게 일할지를 이어서 보기 위해서입니다.
컴퓨터 밖의 자료를 연결합니다
- 15. 메일과 일정이 내 업무 자료와 연결되면: 메일과 일정 하나를 읽는 기능보다, 그 자료를 내가 하던 일과 연결했을 때의 효용을 먼저 봅니다.
- 18. Google을 연결하고 실제 자료로 확인하기: 프로그램 설치와 계정 연결이 다른 일임을 구분하고, 필요한 권한으로 실제 자료를 읽을 수 있는지 확인합니다.
먼저 무엇에 쓸지 보고, 필요한 연결을 갖추는 순서입니다. 당장 Google 자료를 쓰지 않는다면 효용을 살펴본 뒤 자기 자료로 일을 계속해도 됩니다. 계정 자료를 실제로 쓰려 할 때 연결 과정을 거치면 됩니다.
마음에 든 방식을 남기고, 일을 나눠 확인합니다
- 12. 반복하는 업무 기준을 스킬로 남기기: 도구를 연결하는 것과 일하는 절차·판단을 재사용하는 것의 차이를 봅니다.
- 13. 마음에 든 작업을 나만의 스킬로 만들기: 먼저 실제 결과를 맞춘 뒤, 다음에도 쓸 방법을 AI와 구성하고 써보며 고칩니다.
- 8. 서브에이전트에게 일을 나눠 맡기는 법: 별도 역할에 어떤 자료와 원칙을 주고, 어떤 결과를 받아 함께 판단할지 봅니다.
- 9. 내 일에 필요한 서브에이전트 만들기: 원하는 역할을 설명해 AI가 구성하게 하고, 실제로 맡긴 결과를 보며 수정합니다.
- 11. 완료했다는 말과 실제 결과를 대조하기: 별도 검토자가 원래 요청과 자료, 결과를 직접 대조하게 합니다. 완료 표시만으로 끝내지 않는 방법입니다.
처음부터 모든 일을 스킬과 서브에이전트로 만들 필요는 없습니다. 같은 기준을 자꾸 설명하게 되거나, 따로 맡겨 비교할 역할이 생겼을 때 돌아와도 됩니다.
내 일과 가까운 것부터 고르세요
기본 원리를 알았다면 응용을 전부 순서대로 할 필요는 없습니다.
- 하던 생각을 자주 놓친다면 7. 하던 일의 맥락을 이어가는 나의 하루. 글을 쓰다 떠오른 할 일을 남기고 돌아오는 장면, 지난 자료를 다음 준비에 쓰는 흐름을 봅니다.
- 녹음에서 옮긴 글을 다시 쓰고 싶다면 19. 전사 텍스트를 다시 쓸 수 있는 자료로 정리하기. 음성을 자동 전사하는 과정이 아니라, 이미 전사된 텍스트를 읽고 오인식과 추정을 구분해 정리하는 이야기입니다.
- 엑셀을 정리한 뒤 분석해야 한다면 20. 엑셀의 구조와 내용 정리를 나눈 이유. 파일을 읽을 수 있는 형태로 바꾸는 일과 값의 의미를 정리하는 일이 왜 다른지 봅니다.
- 답장을 쓸 때 같은 수정을 반복한다면 21. 문의 메일에 답장을 쓰다 — 회신을 구조화한 이야기. 상대의 질문, 근거 자료, 첨부와 초안을 어떻게 연결했는지 봅니다. 초안을 만드는 것과 실제 발송은 구별합니다.
- 혼자 생각하면 중요한 관점을 빠뜨린다면 22. 큰 일을 쪼개고 실행하고 합치는 법. 원하는 결과에서 필요한 입력을 거꾸로 찾고, 나눈 결과의 전제를 맞춰 통합하는 방법입니다.
제 사례와 똑같은 일을 찾을 필요는 없습니다. 자꾸 다시 찾는 자료, 매번 되풀이하는 설명, 결과에서 꼭 고치게 되는 부분을 자기 일에서 찾아보면 됩니다.
예전에 만든 방식도 기록으로 남겼습니다
지금의 기본 과정과, 그 방법을 찾아오던 기록은 나눠 읽으면 좋겠습니다.
- 16. Google 도구를 AI와 만들며 고친 것들과 17. 일정과 할 일을 연결하며 정한 기준은 도구를 만들며 출력과 날짜, 원본 상태의 기준을 고친 제작 회고입니다. 지금 Google을 연결하기 위해 당시의 자체 도구를 모두 다시 만들 필요는 없습니다.
- 5. 어제 한 일이 오늘 할 일로 이어질 때와 6. 긴 설명을 반복할 방법으로 바꾸며 배운 것은 처음 루틴과 재사용 방법을 발견한 기록입니다. 옛 커맨드 제작법을 먼저 익히는 과정은 아닙니다. 지금 만드는 방법은 12·13편에 있습니다.
- 10. 콘텐츠를 여러 결과로 잇던 OSMU 구성의 기록은 종료한 구성의 회고입니다. 원자료에서 자기 경험을 묻고, 글과 이미지, 발행 준비로 이어갈 때 어떤 입력과 판단이 필요했는지 볼 수 있습니다.
- 14. 웹페이지의 본문과 이미지 속 글자를 함께 수집하기는 당시 수집 경험과 지금 달라진 구조를 함께 설명합니다. 자료가 저장됐다는 것과 필요한 내용을 정확히 읽었다는 것이 왜 다른지 보는 응용입니다.
돌아왔습니다. 좀 달라져서.와 2026년 2월, 다시 살펴본 Claude Code의 변화는 2026년 2월 당시의 재개 공지와 변화 기록입니다. 지금의 최신 기능 목록으로 읽기보다, 그때 무엇이 제 일하는 방식을 바꿨는지 보는 글입니다.
왜 이런 환경에서 일을 계속하는지 궁금하다면 나는 왜 Claude Code로 거의 모든 일을 하는가를 읽어보세요. 새 기능을 배우는 글이 아니라, 성과를 향해 일한 결과가 남고 다음 일의 출발점이 되는 것에 관한 생각입니다.
이상한 일이 하나 있습니다
이 블로그가 가르치는 도구로, 이 블로그를 읽는 겁니다.
도구한테 설명서를 읽히고, 모르는 것을 물어보고, 자기 일에 맞게 바꿔봅니다. AI가 만든 결과를 보면서 설명을 더하고, 맞지 않는 부분을 고칩니다.
전부 이해하고 시작하는 게 아닙니다. 일단 도구를 켜고, 도구한테 물어보면서 하나씩 해보는 겁니다. 모르는 건 그때그때 물어보고, 해보면서 이해합니다.
어려우면, 같이 읽고 하나씩 시켜보세요.