도구는 딱 둘, Claude Code와 GitHub

1편에서 만드는 쪽과 정하는 쪽이 분리됐다는 것을 보았습니다. 이 글은 코스 전체에서 유일하게 도구 이야기를 하는 편입니다. Claude Code와 GitHub가 각각 무슨 역할인지, 무엇을 외워야 하고 무엇을 외우지 않아도 되는지, 그리고 설치 후 첫 30분에 무엇을 할지 정합니다. 다음 편 머릿속 그림을 키운다부터는 다시 도구가 아니라 생각의 이야기로 돌아갑니다.

핵심 요약

• Claude Code는 지시를 받아 손을 움직이는 쪽, GitHub는 사람과 AI가 같은 것을 보는 장소입니다.
• 외울 GitHub 단어는 리포지토리, 커밋, 푸시, 브랜치, PR 다섯 개입니다.
• 코드 에디터는 열지 않습니다. 파일을 보고 싶으면 Claude Code에게 보여 달라고 합니다.
• 도구 조작(설치, 연결, 첫 푸시)도 AI에게 시킵니다. 사람의 일은 연결한다, 말한다, 본다, 정한다입니다.

기술 얘기는 이 글에서만 합니다

이 코스는 도구 사용법 강의가 아닙니다. 그래서 설치 명령, 요금, 용어처럼 "알아야 하지만 오래 붙들 필요는 없는 것"을 이 한 편에 몰아넣었습니다. 여기 나온 것을 다 외울 필요는 없습니다. 막히면 다시 돌아와서 보면 됩니다. 우리 2주차 교재에서도 "용어는 외우지 말고 이해만 하라"고 못 박습니다.

Claude Code, 지시를 받아 손을 움직이는 쪽

Claude Code는 공식 문서 표현대로 코드베이스를 읽고, 파일을 편집하고, 명령을 실행하고, 개발 도구와 통합하는 에이전트 코딩 도구입니다. 터미널에서 claude라고 치면 켜지고, 그 뒤로는 한국어로 지시합니다. 사용하려면 Pro, Max, Team, Enterprise 구독 또는 Console 계정이 필요하며 무료 플랜에는 포함되지 않습니다. 교육에서는 Pro(월 20달러, 연간 결제 시 월 17달러)를 권장합니다.

설치는 한 줄입니다. 파이썬이나 Node.js를 먼저 깔 필요가 없습니다. 인터넷의 오래된 글은 복잡한 옛 방식을 알려주는 경우가 많으니 아래 공식 명령을 쓰십시오.

# macOS, Linux, WSL (터미널)
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

설치 확인과 첫 실행은 이렇게 합니다. 처음 실행하면 브라우저가 열리며 로그인을 요청합니다.

claude --version   # 버전 번호가 나오면 설치 성공
claude doctor      # 설치 상태와 설정을 점검
claude             # 실행. 첫 실행 시 로그인

Windows에서는 Git for Windows를 함께 설치하는 것을 공식 문서가 권장합니다. 없으면 Claude Code가 PowerShell을 셸로 쓰는데, 있으면 Bash 도구를 쓸 수 있어 뒤에 나올 GitHub 작업이 매끄럽습니다.

GitHub, 사람과 AI가 같은 것을 보는 장소

GitHub는 코드를 올리는 창고로 알려져 있지만, 이 코스에서는 다르게 씁니다. 여러분이 쓴 README와 Issue를 AI가 읽고, AI가 만든 변경을 여러분이 보는 "공동 작업대"입니다. AI가 읽을 수 없는 곳에 있는 생각은 없는 것과 같으므로(5편에서 자세히), 생각을 두는 자리가 GitHub인 것입니다. 부수적으로 백업도 됩니다. 실제로 우리 3주차 수업에서 폴더를 정리하다 대부분을 날린 사례가 있었고, 그날의 본론이 GitHub 백업이었습니다.

계정은 github.com에서 이메일로 만듭니다. 아이디는 영문으로, 앞으로 명함처럼 쓰인다고 생각하고 고르십시오. 저장소는 반드시 비공개(Private)로 만듭니다. 고객 자료가 섞일 수 있기 때문입니다.

외울 단어는 5개면 충분합니다

서류 작업에 비유하면 다섯 단어가 전부입니다.

머지(merge)는 PR이 통과되어 사본이 원본에 합쳐지는 것이니 PR의 뒷부분으로 이해하면 됩니다. 이 다섯 단어를 알면 Claude Code가 "커밋하고 푸시했습니다"라고 보고할 때 무슨 일이 일어났는지 알 수 있습니다. 그 이상은 필요할 때 AI에게 물으면 됩니다.

코드 에디터는 열지 않아도 됩니다

VS Code 같은 에디터를 깔아야 하나 고민하는 분이 많습니다. 이 코스에서는 열지 않습니다. 파일 내용을 보고 싶으면 Claude Code에게 "이 파일 내용 보여 줘"라고 하면 되고, 고치고 싶으면 "이 부분을 이렇게 바꿔 줘"라고 하면 됩니다. 에디터를 열어 직접 고치기 시작하면 AI가 모르는 변경이 생기고, 그때부터 대화가 어긋납니다. 우리 수업에서 기본 터미널로만 진행하는 이유도 같습니다. IDE는 익숙해진 뒤 취향으로 골라도 늦지 않습니다.

도구 조작도 AI에게 시킨다

GitHub 연결, 첫 커밋, 첫 푸시를 외울 필요가 없습니다. Claude Code에게 시키고 화면의 안내를 따라가면 됩니다. 우리 3주차 실습 문장을 그대로 쓰면 됩니다.

이 폴더를 GitHub에 백업하고 싶어. 나는 GitHub 계정만 있는 초보야.
계정 연결(로그인)부터 첫 저장(커밋, 푸시)까지 한 단계씩 안내해 줘.
저장소는 반드시 비공개(Private)로 만들어 줘.

완료 확인은 증거로 합니다. 브라우저에서 내 GitHub 저장소에 들어가 방금 올린 파일이 보이면 성공입니다. 이후 습관은 하나입니다. 작업이 한 단락 끝날 때마다 "지금까지 작업 커밋하고 푸시해 줘"라고 말하는 것입니다.

그래서 사람에게 남는 동작은 네 개입니다. 연결한다(계정과 도구를 잇는다), 말한다(무엇을 원하는지 문장으로), 본다(결과와 증거를), 정한다(다음에 무엇을 할지).

처음 30분 동안 할 일

1. 작업 폴더를 만듭니다. 사용자 폴더 아래, 영문 이름, OneDrive 같은 동기화 폴더 바깥에 둡니다. 한글이나 공백이 든 경로는 알 수 없는 오류의 단골 원인입니다.
2. 그 폴더에서 Claude Code를 켭니다.
3. "이 폴더에 뭐가 있는지 정리해서 알려 줘"로 첫 대화를 합니다.
4. 위의 GitHub 백업 문장을 그대로 시킵니다.
5. 브라우저에서 저장소를 확인합니다.

# macOS
mkdir -p ~/work/my-first-tool && cd ~/work/my-first-tool && claude

# Windows PowerShell
mkdir C:\Users\내이름\work\my-first-tool; cd C:\Users\내이름\work\my-first-tool; claude

해 보기

위의 30분 절차를 오늘 안에 끝내십시오. 끝났다는 증거는 두 가지입니다. 터미널에서 claude --version에 버전이 나오는 화면, 그리고 브라우저에서 보이는 비공개 저장소 화면입니다. 이 둘이 없으면 다음 편으로 넘어가지 마십시오.

정리

• Claude Code는 손, GitHub는 공동 작업대입니다.
• 설치는 공식 명령 한 줄이고 유료 구독이 필요합니다.
• 외울 단어는 리포지토리, 커밋, 푸시, 브랜치, PR 다섯 개입니다.
• 에디터는 열지 않고, 도구 조작도 AI에게 시킵니다.
• 사람의 동작은 연결한다, 말한다, 본다, 정한다입니다.

자주 묻는 질문