답답했던 내 클로드코드 스마트하게 만들기
AI 활용의 새로운 접근법을 소개합니다. 특히 비개발자들이 AI를 효과적으로 활용할 수 있는 방법에 대해 다룹니다.
SSOT 한 줄이 AI 결과물을 바꿨다
CLAUDE.md라는 규칙 문서를 직접 작성했더니, AI가 내 의도를 이해하고 기대 이상의 결과물을 만들어냈습니다.
이런 분들께 도움돼요
AI 도구를 쓰고는 있지만 기대 이하의 결과에 답답한 비개발자
Claude Code를 설치했는데 CLAUDE.md를 건드려본 적 없는 분
"개발자들은 AI를 어떻게 저렇게 잘 쓰는 거지?" 궁금한 분
문제 상황과 해결 과정
문제 상황 (Before)
AI 도구를 안 쓰는 건 아니었습니다. Claude Code도 깔아봤고, 이것저것 시도는 해봤습니다. 그런데 매번 같은 수준에서 맴돌았습니다. 스킬 문서를 만들어서 작업을 시켜봐도 기대 이하의 결과 물이 나왔고, 뭐가 문제인지도 모르겠었습니다.
사용한 도구
도구명: Claude Code
모델: Claude Opus 4.6
작업 과정
CLAUDE.md가 뭔지도 몰랐다 — 규칙 문서의 발견
1주차 스터디에서 SSOT(Single Source of Truth)라는 개념을 배웠습니다. 핵심은 단순했습니다. 하나의 정보는 한 곳에서만 관리하라. AI에게 규칙을 알려줄 때도 마찬가지입니다.
"뭘 써야 하지?" — AI가 구조를 잡아줬다
CLAUDE.md에 뭘 써야 할지 막막했습니다. 그런데 Claude가 프로젝트에 맞는 구조를 잡아줬습니다.
MD 파일 하나로 PPT 9장이 나왔다
규칙 문서를 세팅한 후, 바로 실전을 시도했습니다. 1주차 스터디 내용을 정리한 요약 문서를 PPT로 만들어보기로 했습니다.
한국어로 ai라는 단어가 있는 파란색 배경
결과와 배운 점
Before vs After
항목
Before
After
AI에게 규칙 전달
매번 채팅에서 반복
CLAUDE.md 한 번 작성으로 끝
PPT 만들기
직접 만들면 1-2시간
대화 몇 번으로 9장 완성
AI 결과물 품질
기대 이하로 답답
SSOT 규칙 덕에 의도에 맞는 결과
CLAUDE.md에 대한 인식
"AI가 알아서 만드는 파일"
"내가 직접 써서 AI를 제어하는 파일"
이 과정에서 배운 AI 활용 팁
효과적이었던 것
SSOT: 규칙을 한 곳에 모아두기 — AI에게 매번 같은 말 반복하는 대신, CLAUDE.md에 한 번 써두면 모든 대화에 자동 적용됩니다.
막막할 때 AI에게 구조를 잡아달라고 하기 — "뭘 써야 할지 모르겠어"가 아니라 "실습하려고 해"라고 말하면 AI가 방향을 잡아줍니다.
파일 형식 맞추기 — Google Docs를 Markdown으로 변환해서 넣으니 AI가 바로 처리할 수 있었습니다.
이렇게 하면 안 돼요
CLAUDE.md를 AI한테만 맡기지 마세요 — 자동 생성된 내용은 내 의도가 빠져있습니다. 직접 써야 AI가 내 맥락을 이해합니다.
규칙 없이 바로 작업 요청하지 마세요 — 규칙 문서 세팅 → 작업 요청 순서가 결과물 품질을 결정합니다.
다른 업무에 적용한다면?
회의록 → PPT 변환: 오늘 한 것처럼 회의록을 MD로 정리한 뒤 PPT로 자동 변환
반복 업무 규칙화: 매번 같은 지시를 하는 업무가 있다면 CLAUDE.md에 규칙으로 등록
팀 프로젝트 온보딩: 새 팀원이 와도 CLAUDE.md만 보면 AI가 같은 규칙으로 동작
앞으로의 계획
스터디에서 배우는 내용을 매주 실습하고 사례글로 기록할 예정
CLAUDE.md에 규칙을 하나씩 추가하면서 AI 결과물 품질 변화를 관찰할 계획
실무 업무에도 SSOT 방식을 적용해볼 예정
