비개발자가 오늘 클로드 코드를 깔고, 검증된 세팅을 통째로 도입하기까지 — 이 문서 하나로 끝냅니다.
이 자료는 @junyoung.ai 가 제공하는 무료 가이드입니다. 저는 AI 자동화로 1인 사업을 운영하면서 클로드 코드를 핵심 도구로 씁니다.
클로드 코드(Claude Code)는 AI에게 한국말로 일을 시키는 도구입니다. 그런데 막상 깔고 나면 "그래서 뭘 어떻게 세팅하지?"에서 다들 멈춥니다. 이 가이드는 거기서 막히지 않게, 이미 전 세계가 검증한 세팅을 GitHub에서 그대로 가져와 도입하는 데까지 손잡고 데려갑니다.
오늘 끝낼 것은 세 가지입니다.
1. 클로드 코드 설치하고 첫 화면 띄우기 (터미널 안 만집니다)
2. 잘 쓰는 사람들의 세팅(모범사례 스킬·에이전트 묶음)을 통째로 도입하기
3. 나만의 AI 지식창고(LLM Wiki) 만들기
마지막에는 이 모든 걸 클로드가 알아서 해주는 "자동 세팅 명령서"도 드립니다. 복잡하면 그 명령서만 클로드에 넘기세요.
한 줄로 말하면, 검은 화면에 한국말로 시키면 컴퓨터 일을 대신 해주는 AI입니다.
겁나는 건 딱 하나, "검은 화면에 흰 글씨"입니다. 그 화면까지만 띄우면 나머지는 다 한국말이라 어렵지 않습니다.
가장 쉬운 길로 갑니다. 앱 하나만 깔면 됩니다.
1. 브라우저에서 claude.com/download 에 접속합니다.
2. 본인 컴퓨터에 맞는 버튼(Mac 또는 Windows)을 눌러 받습니다.
3. 받은 파일을 더블클릭해서 설치하고, 유료 결제한 계정으로 로그인합니다.
윈도우는 처음 켤 때 'Git for Windows'를 설치하라는 안내가 한 번 뜹니다. 안내대로 설치하고 앱을 다시 켜면 됩니다. 무서운 게 아니라, 클로드 코드가 돌아가려면 필요한 부품 하나를 까는 것뿐입니다. (맥은 해당 없습니다.)
앱을 켜면 위쪽에 Chat · Cowork · Code 세 개의 탭이 있습니다. 그중 Code 탭을 누르세요. 이게 클로드 코드입니다. (앱 버전에 따라 화면이 조금 다를 수 있어요. Code가 안 보이면 메뉴에서 'Claude Code'를 찾아보세요.)
처음 들어가면 작업할 폴더를 고르라고 합니다. 바탕화면에 새 폴더를 하나 만들어서 그걸 고르면 됩니다. (예: 내작업 이라는 폴더)
여기까지 오면 끝입니다. 터미널 한 번도 안 만졌습니다. 이제 화면에 한국말로 시키면 됩니다.
클로드 코드를 막 깔면 텅 빈 상태입니다. 여기에 이미 전 세계 5천 명 넘게 별(star)을 준 모범사례 묶음을 통째로 얹습니다.
claude-code-ultimate-guide (GitHub 별 5,000+)
https://github.com/FlorianBruniaux/claude-code-ultimate-guide클로드 코드 화면에 아래를 그대로 붙여넣으세요. 클로드가 알아서 받아와 깔아줍니다.
아래 GitHub 저장소를 받아서 내 클로드 코드에 도입해줘.
https://github.com/FlorianBruniaux/claude-code-ultimate-guide
1) 이 저장소를 git clone 해줘.
2) 그 안 examples/skills 폴더의 스킬들을 ~/.claude/skills 로 복사해줘. 기존에 있던 파일은 덮어쓰지 말고 없는 것만 추가해줘.
3) examples/agents 폴더의 에이전트들을 ~/.claude/agents 로 같은 방식으로(기존 건 그대로 두고 없는 것만) 복사해줘.
4) 복사하기 전에 어떤 게 들어오는지 한국어로 목록을 보여주고, 내가 원하지 않는 건 빼줘.
5) 다 되면 클로드 코드를 다시 켜라고 알려줘.스킬·에이전트는~/.claude/skills,~/.claude/agents폴더에 파일로 들어가고, 앱을 다시 켜면 활성화됩니다. 64개가 다 필요하진 않으니, 클로드가 목록을 보여주면 마음에 드는 것만 남기라고 하세요.
이 저장소는 "직접 가르쳐주는" 기능도 있습니다. 아래를 붙여넣으면, 클로드가 당신 수준에 맞춰 질문하고 학습 경로를 짜줍니다.
아래 주소의 온보딩 안내를 받아서 그대로 따라 해줘. 나는 개발자가 아니니 쉽게 설명해줘.
https://raw.githubusercontent.com/FlorianBruniaux/claude-code-ultimate-guide/main/tools/onboarding-prompt.mdCLAUDE.md는 클로드가 매번 먼저 읽는 "나에 대한 설명서"입니다. 이걸 잘 써두면 클로드가 훨씬 똑똑하게 굽니다. 비개발자에게 꼭 필요한 모범사례만 추려서, 클로드가 직접 만들게 합니다.
클로드 코드에 아래를 붙여넣으세요.
~/.claude/CLAUDE.md 파일을 만들어줘(이미 있으면 지우지 말고 끝에만 추가). 내용은 이렇게:
- 나는 (내 직업)이고 개발자가 아니다. 전문용어는 풀어서 쉽게 설명한다.
- 항상 한국어로 답한다.
- 너는 초안과 제안을 하고, 최종 결정은 내가 한다. 실행 전에 무엇을 할지 먼저 알린다.
- 파일 삭제(rm)·관리자 권한(sudo) 같은 위험한 명령은 실행 전에 반드시 허락받는다.
- 대화가 길어져 헷갈리면, 지금까지 한 일을 요약하고 다시 정리한다.
(내 직업) 자리에는 나한테 직업을 물어봐서 채워줘. 그리고 그 직업이 자주 하는 일 2~3가지도 더 넣어줘.이 설명서는 한 번 쓰고 끝이 아닙니다. 쓰다가 불편하면 언제든 "이 부분 고쳐줘" 하면 됩니다. 완벽한 규칙이 아니라 나와 클로드의 약속이라고 생각하세요.
자료를 던지면 클로드가 읽고·정리하고·연결해서 평생 쌓이는 나만의 지식 위키를 만들어주는 시스템입니다. 전 세계 7천 명 가까이 별을 준 방식입니다.
claude-obsidian (GitHub 별 6,900+)
https://github.com/AgriciDaniel/claude-obsidian이 시스템은 Obsidian이라는 무료 앱 위에서 돕니다. 없으면 작동하지 않으니 먼저 깝니다.
1. 브라우저에서 obsidian.md 접속 → 본인 컴퓨터용으로 받아 설치. (무료입니다.)
클로드 코드에 아래를 붙여넣으세요.
아래 GitHub 저장소를 받아서 내 지식창고로 세팅해줘.
https://github.com/AgriciDaniel/claude-obsidian
1) 이 저장소를 git clone 해줘.
2) 안내된 setup 스크립트(bin/setup-vault.sh)를 실행해줘. 위험한 명령이면 먼저 물어봐.
3) 다 되면, 이 폴더를 Obsidian에서 어떻게 여는지 한국어로 알려줘.
4) 그다음 내가 뭘 하면 되는지(자료 넣는 법, "정리해줘" 하는 법) 쉽게 설명해줘.설치가 끝나면 Obsidian에서 그 폴더를 열고(Open folder as vault), 클로드 코드 입력창에 /wiki 라고 치면(앞에 슬래시 / 포함) 시작됩니다.
1. .raw 폴더에 자료(PDF·기사·메모)를 넣습니다. (점으로 시작하는 숨김 폴더라 탐색기/파인더에서 안 보일 수 있어요. 안 보이면 클로드에게 "자료 어디에 넣어?"라고 물어보면 됩니다.)
2. 클로드에게 "정리해줘"라고 합니다.
3. 클로드가 읽어서 핵심을 뽑고, wiki 폴더에 정리하고, 서로 연결합니다.
4. 나중에 "요즘 배운 거 중에 그거 뭐였지?" 하면, 찾아서 출처까지 보여줍니다.
자료가 쌓일수록 나만의 지식창고가 점점 두꺼워지고, 더 잘 찾아줍니다.
같은 클로드 코드라도 직업에 따라 시키는 일이 다릅니다. CLAUDE.md에 직업을 적어두면 클로드가 알아서 맞춰줍니다.
쇼핑몰 운영
raw에 넣고 "특징 정리해줘"학원·강사
디자이너·프리랜서
마케터
핵심은 똑같습니다. 한국말로, 평소 하던 일을 그대로 시키면 됩니다.
"claude를 찾을 수 없음" 같은 메시지가 떠요
→ 앱(또는 클로드 코드)을 껐다 켜고 다시 해보세요. 그래도면 컴퓨터를 한 번 재시작합니다.
설치 중 빨간 글씨 에러(403 같은 숫자)가 나요
→ VPN이 켜져 있으면 끄고, 와이파이를 바꿔서 다시 해보세요(폰 핫스팟도 됩니다). 회사 네트워크면 막혀 있을 수 있습니다.
"결제하라"고 막혀요
→ Claude 유료 플랜(월 20달러 이상)이 살아있는지 확인하세요. 무료로는 클로드 코드가 안 됩니다.
스킬을 깔았는데 안 보여요
→ 스킬·에이전트는 앱을 다시 켜야 활성화됩니다. 한 번 껐다 켜세요.
위험한 명령을 실행할까 봐 무서워요
→ CLAUDE.md에 "위험한 명령은 실행 전에 허락받는다"를 넣었다면, 클로드가 먼저 물어봅니다. 모르겠으면 "아니"라고 하면 됩니다. 되돌릴 수 없는 일은 클로드도 함부로 안 합니다.
오늘은 여기까지면 충분합니다. 첫 화면을 띄우고, 검증된 세팅을 도입하고, 지식창고를 만든 것만으로 대부분의 사람보다 앞서 있습니다.
위 과정을 하나씩 하기 번거로우면, 아래 전체를 클로드 코드에 통째로 붙여넣으세요. 클로드가 순서대로 알아서 합니다.
나는 한국인 비개발자야. 내 클로드 코드를 처음 세팅하려고 해. 아래를 순서대로 해줘.
각 단계 전에 무엇을 할지 한국어로 알려주고, 파일을 지우거나 위험한 명령(rm·sudo)을 쓰기 전에는 꼭 먼저 물어봐. 새 프로젝트를 마음대로 만들지는 마.
1. 먼저 나한테 "어떤 일을 하세요?"라고 물어봐.
2. ~/.claude/CLAUDE.md 를 만들어줘(있으면 지우지 말고 끝에만 추가):
- 나는 (내 직업)이고 개발자가 아니다. 전문용어는 쉽게 설명한다.
- 항상 한국어로 답한다.
- 너는 초안·제안만 하고 최종 결정은 내가 한다. 실행 전 무엇을 할지 먼저 알린다.
- 파일 삭제(rm)·관리자 권한(sudo) 같은 위험한 명령은 실행 전 반드시 허락받는다.
- 대화가 길어지면 지금까지 한 일을 요약하고 다시 정리한다.
3. 아래 저장소를 git clone 하고, examples/skills 와 examples/agents 안의 것들을
~/.claude/skills, ~/.claude/agents 로 복사해줘. 기존에 있던 파일은 덮어쓰지 말고 없는 것만 추가해. 복사 전 목록을 보여주고 내가 뺄 걸 물어봐.
https://github.com/FlorianBruniaux/claude-code-ultimate-guide
4. 마지막으로, 나만의 지식창고를 원하면 아래 저장소도 git clone 해줘.
(이건 Obsidian 앱이 필요하다는 걸 먼저 알려줘.)
https://github.com/AgriciDaniel/claude-obsidian
다 되면 한 일을 한국어로 요약해주고, 앱을 다시 켜라고 알려줘.이 자료는 @junyoung.ai 가 제공하는 무료 가이드입니다. 막히는 부분이 있으면 댓글로 알려주세요.