TL;DR
지난달, 저는 제품 및 비즈니스 동료들에게 AI 코딩을 시작하는 방법을 공유했습니다. 최근 많은 학생들이 구독 장벽으로 인해 최고 수준의 AI 코딩 도구를 활용하지 못한다는 트윗을 보고, 방법과 습관은 먼저 무료로 배울 수 있다는 것을 깨달았습니다. 여기에 시작 가이드를 정리했습니다. 이해를 돕기 위해 개념을 더 직관적으로 설명하는 간단한 일러스트를 몇 개 포함했습니다.
많은 사람들이 Claude Code 사용의 첫 단계인 명령줄에서 막힙니다. 텍스트만 보이는 터미널을 보고 프로그래머만을 위한 것이라고 생각합니다. 실제로는 진입 장벽이 그렇게 높지 않습니다. Doubao 같은 채팅 AI를 사용할 수 있는 사람이라면 시간을 조금 투자하면 시작할 수 있습니다. 나머지는 실행을 AI에게 맡기는 것에 익숙해지는 과정일 뿐입니다.
익숙해지면, 마치 모든 작업을 처리하는 유능한 어시스턴트와 같다는 것을 알게 됩니다: 백엔드 데이터 실행, 문제 해결을 위한 작은 도구 작성, 지저분한 문서를 브리핑으로 정리, 프로토타입 제작, 영업 보고서 정리 등. 이전에 코드를 작성할 수 있었는지는 중요하지 않습니다. 프로젝트 컨텍스트를 CLAUDE.md에 의식적으로 작성하고, 요구 사항을 정확하게 만들고, 반복 작업을 패키징하는 "Skills"를 만드는 것을 고민하기 시작했다면, 사실상 입문한 것입니다. 이 글은 비기술적인 분들이 제가 가장 좋아하는 도구인 Claude Code를 사용할 수 있도록 안내하기 위한 것입니다.
첫 번째 장벽: 명령줄
비개발자들은 Doubao 같은 채팅 AI에 익숙합니다. 처음 Claude Code를 설치하면 다소 낯설게 느껴집니다. 이전에는 요구 사항을 설명하면 코드를 생성하고, 이를 복사하여 다른 곳에 붙여넣어 테스트하는 과정을 반복했습니다. 이제 Claude Code는 터미널에서 직접 실행되므로 수동으로 전송하는 단계가 필요 없습니다.
터미널을 사용해 본 적이 없다면, 제가 AI 코딩을 위해 특별히 만든 Kaku를 추천합니다. 색상이나 글꼴을 건드릴 필요 없이 바로 사용할 수 있습니다. 시스템의 라이트/다크 모드를 따르고, Cmd + D로 분할 화면, Cmd + Shift + Y로 파일 관리자를 사용합니다. 초보자에게 가장 중요한 점은 AI 지원이 내장되어 있다는 것입니다: 명령 오류에 대한 수정 제안을 제공하고, # 다음에 중국어를 입력하면 명령어를 생성할 수 있습니다.
Claude Code 설치는 단 하나의 명령어로 가능합니다 (공식 문서 참조). 그런 다음 프로젝트 폴더에서 claude를 입력하기만 하면 코딩을 시작할 수 있습니다.
curl -fsSL
| bash
강력 추천: 기술 지식 익히기
Claude Code를 제대로 사용하려면 요구 사항을 설명하는 것만으로는 충분하지 않습니다. 기본 개념을 이해하면 문제 해결이 훨씬 쉬워집니다.
일반적인 프레임워크의 역할 이해하기: React, Vue 또는 Next.js가 무엇을 해결하는지 이해하면 Claude Code의 출력을 볼 때 길을 잃지 않습니다.
소프트웨어 기초: 터미널 명령어, Git, VS Code 및 Chrome DevTools. 오류가 발생했을 때, 그냥 기다리기보다는 문제 위치를 파악하는 데 도움을 줄 수 있습니다.
핵심 프로그래밍 개념: 함수가 무엇인지, 변수와 상태가 무엇인지, 코드가 여러 파일로 나뉘는 이유를 알면 요구 사항을 더 정확하게 만들 수 있습니다.
코드와 오류 읽는 법 배우기: 코드를 직접 작성할 수 있기 전에도 유용합니다. 변경 사항을 보고 어떤 기능인지 파악하는 것이 설명을 요청하는 것보다 빠릅니다. 오류가 발생해도 당황하지 말고, 전체를 복사하여 "이게 무슨 뜻이고 어떻게 고치나요?"라고 물어보세요. 십중팔구 정확히 어떤 줄이 문제인지 알려줄 것입니다.
직접 코드를 작성할 수 있는 수준까지 갈 필요는 없습니다. 이런 것들이 어떻게 생겼는지 아는 것만으로 충분합니다. freeCodeCamp나 MDN의 입문 섹션에서 저녁 한두 번을 보내거나, Crash Course Computer Science 또는 Harvard CS50 같은 입문 강좌를 시청하세요. 협업 효율성이 크게 달라질 것입니다.
더 넓은 시각을 위해 다음 세 권의 책을 추천합니다: 제품 판단력을 위한 "Inspired", 엔지니어링 철학을 위한 "The Linux/Unix Design Philosophy", 그리고 전문 프로그래머의 비전을 위한 "Listening to the Wind".
준비: 계정 및 구독
계정: Gmail을 사용하여 claude.ai에 가입하세요. 안정적인 미국 IP를 사용하여 리스크 컨트롤이 트리거되는 것을 방지하세요. 새 계정에서 바로 Max 구독으로 넘어가지 마세요. 차단될 수 있습니다.
가장 쉬운 방법은 미국 App Store 또는 Google Play를 이용하는 것입니다. Claude App에서 잔액을 사용하여 Pro에 가입하세요. App Store에는 세금이 부과된다는 점에 유의하세요 (100 단위 구독이 125로 표시될 수 있음). 하지만 더 안전합니다. Pro로 시작하고 할당량이 부족하면 Max로 업그레이드하세요.
차단을 피하려면: 안정적인 네트워크를 사용하고, 계정을 공유하지 말고, 신뢰할 수 있는 결제 수단을 사용하고 (가상 카드 피하기), 오래된 Gmail 계정을 사용하세요.
Claude Code에 적합한 작업은?
Cursor, Windsurf, Codex를 사용해 봤지만, Claude Code가 제 메인 도구입니다.
모델 성능이 뛰어나고, "Harness" 개념의 구현이 최고 수준입니다. CLAUDE.md와 디렉토리 구조를 스캔하여 컨텍스트를 이해한 다음, 파일을 수정하고, 명령어를 실행하고, 오류를 확인하고, 스스로 반복합니다. 터미널에서 작동하기 때문에 git, 테스트, 스크립트를 직접 호출할 수 있습니다.
Claude Code는 사실 범용 Agent입니다. Anthropic의 내부 영업 및 재무 팀은 CRM 데이터와 이메일을 처리하는 데 사용합니다. 터미널이 싫다면 데스크톱 앱 Cowork를 사용하세요. 로컬 디렉토리를 읽고 써서 영수증 스크린샷을 비용 보고서로 변환하는 등의 작업을 수행할 수 있습니다.
중요한 점: 코딩에서는 정확성이 속도보다 중요합니다. 20분이 걸리더라도 제대로 작동하는 것이, 10분이 걸리지만 20분의 디버깅이 필요한 것보다 낫습니다.
가장 적합한 작업: 프로토타입 및 내부 도구, CSV/영업 보고서 처리, 계약 조항 요약, PDF/링크에서 정보 추출.
나만을 위한 소프트웨어 만들기
NYT 칼럼니스트 Kevin Roose는 software for one 개념을 제안했습니다: 백만 명을 위한 앱이 아니라, 자신만을 위한 소프트웨어를 만들 수 있다는 것입니다. 음성 메모를 회의록으로 바꾸는 도구나 개인 대시보드가 그 예입니다. 제품 및 비즈니스 담당자는 자신의 페인 포인트를 잘 알기 때문에 이에 가장 적합합니다.
1일에서 3개월까지의 리듬
첫날부터 Notion을 만들려고 하지 마세요. 다음 리듬을 따르세요:
1일차: 기존 Excel 또는 Markdown 파일 수정. 1주차: 단일 페이지 개인 홈페이지 구축. 1개월차: 반복적인 주간 작업 자동화. 3개월차: "software for one" 도구 구축.
OpenCLI로 웹 작업을 명령어로 전환하기
운영 담당자들은 종종 브라우저에서 하루 종일 클릭하며 작업합니다. 이러한 작업은 종종 API를 통해 UI를 우회할 수 있습니다.
OpenCLI는 Xiaohongshu, X, Bilibili 등에 대한 CLI 어댑터를 제공합니다. Claude Code가 클릭, 입력, 스크래핑과 같은 웹 작업을 단일 명령어로 수행할 수 있게 해줍니다.
Xiaohongshu 리서치: Claude Code가 OpenCLI를 사용하여 데이터를 스크래핑하고 핫 키워드를 요약하도록 합니다.
감정 요약: X, Reddit, HackerNews용 어댑터를 결합하여 일일 보고서를 만듭니다.
Claude Code에는 Webhooks 또는 GitHub 이벤트를 통해 워크플로우를 자동화하는 Routines 기능도 있습니다.
CLAUDE.md: 프로젝트 컨텍스트 먼저 정의하기
많은 사람들이 컨텍스트를 반복해서 설명해야 해서 좌절합니다. 해결책은 루트 디렉토리에 CLAUDE.md 파일을 두는 것입니다.
Claude Code는 시작할 때마다 이 파일을 읽습니다. 150줄 미만으로 유지하고, 명령형 언어를 사용하며, 검증 가능한 규칙을 제공하세요 (예: "함수는 50줄 미만이어야 함").
핵심 규칙: 실행 전에 물어보기, 단순성 우선, 필요한 부분만 건드리기, 완료 후 확인하기.
정확한 요구 사항이 이탈을 방지합니다
모호함: 고객 후속 관리 도구를 만들어 줘.
정확함: 단일 파일 로컬 웹페이지로 된 영업 후속 관리 도구를 만들어 줘. 왼쪽 목록에는 회사명, 다음 후속 일정, 상태를 표시해. 오른쪽에는 세부 정보를 보여줘. 상단에 필터 세 개를 추가해. 데이터는 localStorage에 저장해.
정확한 요구 사항은 첫날부터 작동하는 버전을 얻을 수 있게 해줍니다. 코드 세부 사항을 몰라도 요구 사항은 구체적으로 설명해야 합니다.
범위를 정의하세요: 하지 말아야 할 것을 명시적으로 언급하세요 (예: "로그인 없음, 지금은 SEO 없음"). 수치화된 승인 기준을 제공하세요 (예: "첫 화면 1.5초 내 로딩").
Plan 및 Auto 모드
복잡한 작업에는 Plan 모드 (Shift+Tab)를 사용하세요. 실행하기 전에 수행할 작업을 나열합니다. 자신 있다면 Auto 모드를 사용하세요. 안전한 작업은 자동으로 수행하고, 위험한 작업 (예: 파일 삭제)에 대해서만 허가를 요청합니다.
올바른지 확인하는 방법
AI의 말을 그대로 믿지 마세요.
Git 스냅샷: 큰 변경 전에 git status를 실행하고 체크포인트를 커밋하세요. /rewind를 사용하여 변경 사항을 되돌리세요.
"시도하고 확인" 루프 피하기: 진단 없이 코드를 패치하도록 두지 마세요. 변경을 허용하기 전에 "어느 줄이 문제이고 그 이유는 무엇인가요?"라고 물어보세요.
Max 고급 팁: 별칭, 모델 및 긴 세션
별칭: 저는 alias c='CLAUDE_CODE_AUTO_COMPACT_WINDOW=400000 claude --dangerously-skip-permissions'를 사용하여 확인을 건너뛰고 컨텍스트 압축을 지연시킵니다.
모델: /model opusplan을 사용하여 Opus가 계획을 수립하고 Sonnet이 실행을 담당하도록 합니다.
긴 세션: 작업 완료 후 /clear를 사용하세요. 긴 작업을 끝내기 전에 HANDOFF.md를 요청하여 새 세션에서 재개할 수 있도록 하세요.
Waza: 습관을 근육 기억으로 바꾸기
좋은 엔지니어링 습관을 나타내는 8가지 스킬 세트인 Waza를 만들었습니다.
/think는 계획, /design은 UI 디자인, /hunt는 문제 해결, /check는 최종 검토용입니다.
나만의 Skills 만들기
Skills는 .claude/skills/ 디렉토리 안에 SKILL.md 파일이 있는 폴더입니다. 워크플로우 기반 (예: 회의 요약), 체크리스트 기반 (예: 출시 전 점검), 또는 전문가 기반 (예: 문제 해결 매트릭스)이 될 수 있습니다.
Kami와 Claude Design
Kami는 콘텐츠를 전문적인 PDF로 변환하는 AI 레이아웃 도구입니다. Claude Design을 사용하면 코드 작성 없이 스크린샷이나 문서로 대화형 프로토타입을 만들 수 있습니다.
보안 고려 사항
명령어를 실행하기 전에 설명을 요청하세요. 프로덕션 환경을 연습용으로 절대 사용하지 마세요. API 키를 채팅에 직접 붙여넣지 말고 .env 파일을 사용하세요. 결제와 같은 민감한 기능은 처음부터 직접 작성하기보다 Stripe 같은 검증된 서비스를 사용하세요.
