직접 사장이 되고 싶다면, 30분만 시간을 내보세요.
오늘은 코딩 지식 하나 없이도 진정한 기능을 하는 AI 에이전트를 단 하루 오후에 만드는 방법을 알려드리겠습니다.
제가 지금부터 말씀드릴 내용을 챗봇과 혼동하지 마세요. 챗봇은 질문을 기다렸다가 답변을 주지만, 에이전트는 다르게 작동합니다. 목표를 주면 스스로 단계를 설정하고, 파일을 읽고, 명령을 실행하며, 작업이 끝날 때까지 스스로 진행합니다. 모든 움직임을 관리할 필요 없이, 그저 경로만 그려주면 됩니다.
이 차이는 중요합니다. 더 이상 프롬프트를 하나씩 작성할 필요가 없기 때문입니다. 여러분이 다른 작업을 살펴보는 동안에도 작업은 저절로 진행됩니다.
필요한 것은?
설치 전에 필요한 모든 것은 다음과 같습니다:
- 유료 Claude 플랜 (Pro, 월 $20, Claude Code 포함)
- Mac (macOS), Windows, 또는 Linux
- 인터넷
- 30-45분의 자유 시간
코딩 지식은 필요하지 않습니다. 모든 명령어는 완전히 작성되어 있으며, 여러분은 복사해서 붙여넣고 Enter 키만 누르면 됩니다.
추가 비용은 없습니다. 구독료 외에는 한 푼도 들지 않습니다.
설치: 데스크톱 애플리케이션, 터미널 불필요
초보자에게 가장 쉬운 방법은 데스크톱 애플리케이션입니다. 터미널을 배울 필요 없이 Claude Code의 모든 강력한 기능을 손쉽게 사용할 수 있습니다.
운영 체제에 맞는 데스크톱 애플리케이션을 claude.ai에서 다운로드하세요. Mac에서는 .dmg 파일을 열고 Claude를 애플리케이션 폴더로 드래그하고, Windows에서는 설치 프로그램을 실행하세요. 애플리케이션을 열고 계정으로 로그인한 다음, 상단 중앙의 Code 탭을 클릭하세요.
Code 탭에서 플랜 업그레이드를 요구하면 현재 플랜이 Claude Code를 지원하지 않는다는 의미입니다. 온라인 로그인을 요구하면 로그인을 완료하고 애플리케이션을 다시 시작하세요. 어느 경우든 결국 빈 작업 공간에 도달하게 됩니다.
여기서 성공했다는 것은: 빈 프롬프트 상자, 활성화된 Code 탭, 그리고 오류 메시지가 없다는 뜻입니다. 지금부터 구축하는 모든 것은 이 영역에서 이루어집니다.
무엇을 만들 것인가?
하나의 간단하고 명확한 에이전트를 만들 것입니다. 기사 끝까지 동일한 에이전트로 진행할 것입니다.
에이전트의 임무는 다음과 같습니다: 폴더 안의 텍스트 파일을 읽고, 제목이 누락된 파일을 찾아서, 수정이 필요한 파일 목록을 missing-titles.txt라는 이름의 보고서로 작성하는 것입니다.
작지만 실제적인 작업입니다. 에이전트가 해야 할 세 가지 기본 작업, 즉 파일 읽기, 결정 내리기, 출력 쓰기를 포함합니다. 그리고 제대로 작동하는지 직접 확인할 수 있을 정도로 간단합니다.
1단계: 작업 폴더 설정
바탕화면에 my-agent라는 폴더를 만드세요. 에이전트는 여기서 작업하며, 이 폴더 안쪽만 보고 건드릴 수 있으므로 모든 것이 안전하게 유지됩니다.
my-agent 안에 articles라는 두 번째 폴더를 만드세요. 에이전트는 여기서 확인할 파일을 찾습니다.
articles 안에 post-one.txt, post-two.txt, post-three.txt, post-four.txt라는 일반 텍스트 파일 4개를 만드세요. 그중 두 개를 열고 맨 위에 다음을 작성하세요:
Title: My Article
나머지 두 개는 완전히 비워두세요. 에이전트의 임무는 바로 이 빈 파일들을 찾는 것입니다.
폴더 구조는 my-agent/articles/ 이어야 하며, 4개의 .txt 파일이 있고, 그중 2개는 제목이 있고 2개는 제목이 없어야 합니다.
2단계: CLAUDE.md 명령 파일 작성
CLAUDE.md는 Claude Code가 모든 세션 시작 시 읽는 일반 텍스트 파일입니다. 에이전트의 고정된 지침, 즉 절대 잊지 않는 직무 설명서라고 생각하면 됩니다.
my-agent 폴더 안에 (articles 안이 아닙니다) CLAUDE.md라는 새 파일을 만드세요. 텍스트 편집기(Windows는 메모장, Mac은 TextEdit)로 열고 다음을 정확히 붙여넣으세요:
# 내 파일 확인 에이전트 ## 당신의 임무 /articles 폴더 안의 모든 .txt 파일을 확인하세요.
## 확인할 사항 유효한 파일은 다음 줄로 시작합니다: Title: 첫 번째 줄이 "Title:"로 시작하지 않으면 파일의 제목이 누락된 것입니다.
## 수행할 작업 1. /articles 안의 모든 .txt 파일을 하나씩 읽으세요. 2. 제목이 누락된 파일을 기록하세요. 3. 메인 폴더에 missing-titles.txt 파일을 만드세요. 4. 검사에 실패한 각 파일 이름을 이 파일에 한 줄에 하나씩 작성하세요. 5. 모든 파일이 유효하면 "All files have titles."를 missing-titles.txt에 작성하세요.
## 하지 말아야 할 것 어떤 기사 파일도 편집하지 마세요. 읽기만 하세요. missing-titles.txt 파일에만 쓰세요.
저장하세요. 이것이 에이전트의 전체 두뇌입니다. Claude Code는 다른 모든 것보다 먼저 이 파일을 읽습니다.
my-agent/CLAUDE.md 파일이 생성되었고 위의 지침이 포함되어 있습니다. 이것으로 끝입니다.
3단계: Claude Code를 폴더로 연결
Claude Code 데스크톱 애플리케이션을 열고, 폴더 아이콘 또는 "Open folder" 옵션을 클릭한 다음 my-agent 폴더로 이동하세요. 선택하고 확인하세요.
Claude Code는 자동으로 CLAUDE.md 파일을 읽습니다. 확인 메시지는 표시되지 않습니다. 이는 폴더를 열 때마다 백그라운드에서 자동으로 발생합니다.
터미널을 사용하는 경우, 터미널을 열고 다음을 실행하세요:
cd ~/Desktop/my-agent claude
cd 명령어는 "디렉토리 변경"을 의미하며, my-agent 폴더 안으로 이동합니다. claude를 입력하면 해당 폴더에서 세션이 시작됩니다.
4단계: 에이전트 실행
Claude Code 인터페이스 하단의 프롬프트 상자에 다음을 정확히 입력하세요:
articles 폴더 안의 모든 .txt 파일을 읽으세요. 상단에 Title 줄이 누락된 파일을 찾으세요. CLAUDE.md의 지침에 따라 결과를 missing-titles.txt에 작성하세요.
Enter 키를 누르세요. 그리고 지켜보세요.
Claude Code는 작업하는 동안 모든 것을 보여줍니다: 어떤 파일을 읽는지, 각 파일에서 무엇을 찾는지, 무엇을 쓰는지. 이러한 투명성은 의도적인 것입니다. 모든 작업이 실행되기 전에 확인하고 이상한 점이 있으면 중단할 수 있습니다.
Claude는 4개의 파일을 읽고, 제목이 없는 2개를 감지한 다음, my-agent 폴더에 missing-titles.txt 파일을 만듭니다. 파일을 열면 두 개의 파일 이름이 한 줄씩 적혀 있는 것을 볼 수 있습니다.
가장 흔한 오류: 에이전트가 "완료"라고 말했지만 파일이 비어 있음
이는 일반적으로 에이전트가 missing-titles.txt 파일을 만들었지만 안에 아무것도 쓰지 않을 때 발생합니다. 그 이유는 거의 항상 CLAUDE.md의 지침이 너무 모호하기 때문입니다.
해결책: CLAUDE.md를 열고 출력 지침을 더 구체적으로 만드세요. "파일을 나열하세요" 대신 "각 파일 이름을 자체 줄에 쓰세요, 예: post-two.txt"라고 작성하세요. 지침에 구체적인 예를 넣으면 매번 구체적인 출력이 생성됩니다.
에이전트가 잘못된 파일 이름을 쓰거나 하나를 건너뛰는 경우, 기사 파일의 확장자가 .txt인지, .txt.txt가 아닌지 확인하세요. 이는 Windows에서 파일 확장자가 숨겨져 있을 때 자주 발생합니다. 파일 탐색기 설정에서 "파일 확장명 표시"를 켜고 확인하세요.
5단계: 확인 및 확장
missing-titles.txt 파일을 열고 비워두었던 두 파일이 나열되어 있는지 확인하세요. 맞다면 에이전트가 처음부터 끝까지 올바르게 작동한 것입니다.
이제 작동하는 에이전트가 생겼습니다. 이 에이전트는 my-agent에 있으며, CLAUDE.md에서 지침을 받고, articles 폴더에 새 파일을 넣으면 동일한 프롬프트로 다시 실행할 수 있습니다.
다음 명확한 단계: CLAUDE.md를 업데이트하여 각 파일이 5줄보다 긴지도 확인하도록 하세요. "확인할 사항" 제목 아래에 다음을 추가하세요:
**유효한 파일은 또한 5줄보다 긴 내용을 포함해야 합니다. 파일이 5줄 이하이면 제목 확인 옆에 "너무 짧음"으로 표시하세요.**
동일한 프롬프트로 에이전트를 다시 실행하세요. 이제 하나 대신 두 가지를 확인합니다. 프롬프트는 전혀 변경하지 않았고, 명령 파일만 변경했습니다.
당신은 무엇을 했고, 왜 중요한가?
파일을 읽고, 결정을 내리고, 출력을 작성하며, 모든 단계를 감독하지 않아도 되는 에이전트를 구축했습니다. 이것은 지금부터 구축할 모든 고급 에이전트의 기본 패턴입니다.
확장 가능한 부분은 CLAUDE.md입니다. 거기에 추가하는 모든 새로운 규칙, 새로운 확인, 새로운 출력 형식은 실행 방식을 변경하지 않고도 에이전트의 작업을 변경합니다. 프롬프트는 동일하게 유지되고, 지침은 진화합니다.
여기서 자연스러운 다음 단계: 더 많은 파일 형식 확인, CSV와 같은 다른 형식으로 보고서 작성, 또는 특정 간격으로 확인이 자동으로 반복되도록 설정하는 것입니다.
축하합니다. 첫 걸음을 내디뎠습니다. 나머지는 여러분의 손에 달려 있으며, 상상력에 비례합니다.
격차가 벌어지기 전에 행동에 옮기세요.
저장하고 공유하는 것을 잊지 마시고, 댓글로 응원해 주세요.
