클로드AI에서 클로드 코드까지 사용법 기초
우리는 채팅에서 클로드 코드를 써요 — 웹 방식과 터미널 방식부터 GitHub 연동까지 한 번에 정리했어요.
1. 클로드, 어디로 들어가나요? — 웹 방식 vs 터미널 방식
1-1. 왜 두 가지 방법으로 나뉘었나요?
클로드는 원래 사용하는 사람이 서로 달랐기 때문에 두 가지 방식으로 나뉘어 있었어요.
- 웹(claude.ai): 일반 사용자가 브라우저나 앱에서 글로 대화하는 방식이에요. 개발 지식이 없어도 누구나 바로 쓸 수 있어요.
- 터미널(Claude Code): 개발자가 명령어 창에서 실행하는 방식이에요. 내 컴퓨터의 실제 폴더와 파일에 직접 접근해서 코드를 만들고 고치고 실행해요.
우리는 터미널을 직접 열 일이 없어요. 이 문서에서 클로드 코드는 앞으로 나올 2장처럼 클로드 채팅(웹 브라우저) 안에서 쓸 것이기 때문이에요. 터미널 설치 방법은 참고용으로만 아래 1-3에 접어두었으니, 나중에 필요할 때만 펼쳐서 보시면 돼요.
1-2. 웹으로 들어가는 방법
인터넷 브라우저에서 claude.ai에 접속한 뒤, 이메일 또는 구글 계정으로 로그인하면 바로 대화를 시작할 수 있어요. 별도의 설치가 필요 없어요.
1-3. 터미널로 들어가는 방법 (참고용 — 우리는 잘 안 써요)
아래는 터미널을 직접 설치해서 쓰는 방법이에요. 우리는 이 방법을 쓰지 않고, 2장부터 나오는 '채팅 안의 Code 탭'을 사용해요. 혹시 나중에 터미널이 필요해지면 그때 펼쳐서 참고하세요.
윈도우(Windows)에서 터미널 설치하기
- PowerShell 열기: 키보드에서
Win키를 누르고, 검색창에PowerShell이라고 입력해요. 검색 결과에서 Windows PowerShell을 선택해 열어요. (관리자 권한으로 실행하지 않아도 돼요.) - 아래 명령어를 그대로 복사해서 붙여넣고 Enter 키를 눌러요.
irm https://claude.ai/install.ps1 | iex
- 설치가 잘 되었는지 확인해요.
claude --version
- 로그인하고 실행해요.
이 명령어를 입력하면 인터넷 브라우저가 자동으로 열려요. 그 화면에서 본인의 Claude 계정으로 로그인하고 "허용"을 눌러주세요.claude
-
hello 페이지 만들기: 먼저
cd Desktop이라고 입력해서 바탕화면 폴더로 이동해요.claude가 실행된 상태에서 아래 문장을 그대로 입력해요.hello.html 파일을 만들어서 화면에 크게 Hello World가 보이게 해줘 - 바탕화면(파일 탐색기)에서 만들어진
hello.html파일을 더블클릭하면 브라우저에서 결과를 확인할 수 있어요.
윈도우에서 자주 막히는 부분
- "이 시스템에서 스크립트를 실행할 수 없습니다" 오류: PowerShell 보안 설정 때문이에요.
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser로 바꿔요. - 설치 후
claude명령어가 안 먹힐 때: PowerShell 창을 완전히 닫고 새로 여세요. - "Windows PowerShell (x86)"으로 잘못 열었을 때: x86이 붙지 않은 일반 "Windows PowerShell"을 열어야 해요.
맥북(macOS)에서 터미널 설치하기
- 터미널 열기: 키보드에서
Command + Space를 동시에 누르고, "터미널"이라고 입력한 뒤 실행해요. - 아래 명령어를 그대로 복사해서 붙여넣어요.
curl -fsSL https://claude.ai/install.sh | bash
- 설치가 잘 되었는지 확인해요.
claude --version
- 로그인하고 실행해요.
브라우저가 열리면 본인의 Claude 계정으로 로그인하고 "허용"을 눌러주세요.claude
-
cd Desktop이라고 입력해서 바탕화면 폴더로 이동한 뒤,claude가 실행된 상태에서 아래 문장을 그대로 입력해요.hello.html 파일을 만들어서 화면에 크게 Hello World가 보이게 해줘 - Finder(파인더)에서
hello.html파일을 더블클릭하면 확인할 수 있어요.
맥북에서 자주 막히는 부분
- 설치 후
claude명령어가 안 먹힐 때: 새 터미널 창을 열거나source ~/.zshrc를 입력해보세요. - 오래된 macOS 버전을 쓸 때: macOS를 최신 버전으로 업데이트해야 해요.
- 인증서 오류로 설치 파일을 못 받을 때: 회사/학교 네트워크 보안 장비 때문일 수 있어요. 담당 IT 부서에 문의하세요.
2. 웹에서도 이제 터미널처럼 개발자 방식으로 쓸 수 있게 됐어요
실제로 우리가 쓸 부분은 바로 여기부터예요. 1장은 참고용 배경 지식이었고, 지금부터가 본론이에요.
2-1. 예전에는 이렇게 나뉘어 있었어요
1번 목차에서 설명한 것처럼, 예전에는 "클로드 = 웹에서 채팅", "클로드 코드 = 터미널에서 실행"이라고만 이해하면 충분했어요.
2-2. 지금은 왜 바뀌었나요? (Anthropic 입장 포함)
아래는 실제 claude.ai 화면 좌측 상단을 캡처한 화면이에요. 말풍선 모양 아이콘과 </> 모양 아이콘, 두 개가 나란히 있는 것을 볼 수 있어요.
이 중 </> 아이콘을 누르면 Code 모드로 바뀌어요. 즉, 지금은 웹 화면(claude.ai) 안에서도 터미널 없이 클로드 코드를 쓸 수 있게 되었어요. 이것이 2026년 8월 28일 현재 우리가 실제로 쓰게 될 방법이에요.
왜 이렇게 바뀌었을까요? (Anthropic의 실제 입장)
Anthropic은 2025년 10월 20일, 클로드 코드를 웹 브라우저에서도 쓸 수 있게 정식으로 출시했어요. TechCrunch와의 인터뷰에서 Anthropic의 클로드 코드 담당 프로덕트 매니저는, 터미널이 앞으로도 클로드 코드의 "본거지" 역할을 계속하겠지만, 회사는 개발자들이 더 다양한 곳에서 코딩 에이전트를 켤 수 있도록 클로드 코드를 여러 곳에 넣으려 한다고 설명했어요.
비슷한 시기에 Anthropic은 클로드 코드와 같은 에이전트 기술을 개발자가 아닌 사람들도 쓸 수 있게 만드는 데에도 힘을 쏟았어요. 클로드 코드 개발 총괄인 Boris Cherny는 이런 흐름에 대해, "비개발자들도 훨씬 더 쉽게 쓸 수 있게 만들고 싶었다"는 취지로 언론에 밝혔어요. 정리하면, "코드를 직접 다루는 일 = 터미널을 쓸 줄 아는 개발자만 하는 일"이라는 예전 공식이 깨지고, 개발을 배우지 않은 일반 사용자도 어려운 명령어 없이 말(프롬프트)로 코딩을 시키고 싶어 하는 수요가 커진 것이 배경이에요.
- 클로드 코드 웹 출시일(2025년 10월 20일)과 "터미널이 계속 본거지 역할을 할 것"이라는 담당 PM 발언 — TechCrunch, "Anthropic brings Claude Code to the web" — techcrunch.com
- Claude Code 담당 총괄 Boris Cherny의 "비개발자를 위해 훨씬 쉽게 만들고 싶었다"는 취지의 발언(관련 제품인 Cowork 관련 인터뷰) — Fortune 인용, Yahoo Finance 재게재 — finance.yahoo.com
이 'Code' 모드가 터미널에서 쓰던 클로드 코드와 완전히 같은 건가요?
같은 점과 다른 점이 함께 있어요.
- 같은 점: Anthropic 공식 문서에 따르면 "Claude Code는 모든 곳에서 동일하게 작동합니다. 변경되는 것은 코드가 실행되는 위치와 로컬 구성을 사용할 수 있는지 여부입니다." 즉, 코드를 읽고 파일을 고치고 명령을 실행하는 핵심 기능 자체는 어디서 접속하든 같아요.
다른 점 1 — 채팅(Code 탭) 안에서도 실행 방식이 두 가지로 나뉩니다
클로드 채팅의 Code 탭을 눌러 작업을 시킬 때, 클로드 코드가 실제로 어디서 돌아가는지에 따라 다시 두 가지로 나뉘어요.
| ① 로컬 실행 | ② GitHub 연결 후 클라우드 실행 | |
|---|---|---|
| 어디서 돌아가나요? | 내 컴퓨터 안에서 직접 | Anthropic의 클라우드(인터넷 서버, 가상 컴퓨터) 안에서 |
| 결과 파일은? | 내 컴퓨터에 즉시 생겨요 | GitHub 저장소에 저장돼요 (내 컴퓨터엔 안 생겨요) |
| 컴퓨터/브라우저를 닫으면? | 작업이 멈춰요. 컴퓨터를 계속 켜두고 있어야 해요. | 브라우저를 닫아도 작업이 계속 진행되고, 휴대폰 앱에서도 진행 상황을 확인할 수 있어요. |
| 필요한 것 | 내 컴퓨터, 특별한 준비 없음 | GitHub 계정, 저장소(repository) 연결 |
쉽게 말해 ①은 "내 컴퓨터 안에서 바로 끝내는 방식", ②는 "인터넷 저편의 서버에 일을 맡겨두고 나는 다른 일을 하다가 나중에 확인하는 방식"이에요. 오늘 오후 시연(4장)에서는 ②번 방식을 써볼 예정이에요.
다른 점 2 — 시작하는 방법이 다릅니다
①번(로컬)은 내 컴퓨터의 아무 폴더에서나 바로 시작할 수 있어요. 반면 ②번(클라우드)은 GitHub 계정을 연결하고, 작업할 GitHub 저장소(repository)를 지정해야 시작할 수 있어요.
현재 상태: 웹에서의 클로드 코드는 아직 "연구 미리보기(정식 출시 전 시험 제공)" 단계이며, Pro·Max·Team 플랜 사용자 등 일부에게 제공돼요.
2-3. 서비스 이름 정리 (헷갈리지 않도록)
Anthropic이 공식적으로 구분하는 이름은 아래와 같아요. 앞으로 이 문서에서도 아래 이름으로 통일해서 부를게요.
| 이름 | 무엇인가요 | 필요한 플랜 |
|---|---|---|
| Chat | claude.ai에서 클로드와 글로 대화하는 기본 화면 | 무료(Free)부터 가능 |
| Cowork | 내 컴퓨터의 폴더를 열어주고, 클로드가 그 안의 파일을 읽고 고치고 새로 만들게 하는 기능 | Pro 이상 |
| Code (Claude Code) | 코드를 읽고, 고치고, 실행까지 하는 에이전트예요. 터미널·IDE·데스크톱 앱의 'Code' 탭·웹(claude.ai/code) 등 여러 방법으로 접속할 수 있으며, 화면 캡처에 보이는 </> 아이콘이 바로 이 Code 모드로 들어가는 버튼이에요. | Pro 이상 |
| Design | 디자인 시안·프로토타입 작업을 돕는 기능 | Pro 이상 |
| Science | 연구·과학적 분석 작업을 돕는 기능 | Pro 이상 |
※ 이번에 확인한 화면 캡처에는 Chat과 Code 두 가지 아이콘만 보였어요. Cowork·Design·Science는 계정·플랜 설정에 따라 다른 위치(예: 별도 메뉴)에 나타날 수 있어요.
참고: 클로드 코드를 실행하는 4가지 방법 상세 비교 (안 봐도 돼요)
Anthropic 공식 문서는 클로드 코드를 실행하는 방법을 아래와 같이 비교하고 있어요.
| 웹에서 | Remote Control | Terminal CLI | Desktop 앱 | |
|---|---|---|---|---|
| 코드 실행 위치 | Anthropic 클라우드 VM | 사용자의 머신 | 사용자의 머신 | 사용자의 머신 또는 클라우드 VM |
| 채팅 위치 | claude.ai 또는 모바일 앱 | claude.ai 또는 모바일 앱 | 터미널 | Desktop UI |
| 로컬 구성 사용 | 아니오, 저장소만 | 예 | 예 | 로컬은 예, 클라우드는 아니오 |
| GitHub 필요 | 예 | 아니오 | 아니오 | 클라우드 세션의 경우만 |
| 연결 해제 시 계속 실행 | 예 | 터미널이 열려 있는 동안 | 아니오 | 세션 유형에 따라 다름 |
3. 클로드 무료 계정으로 할 수 있는 것 / 안 되는 것
아래는 2026년 8월 28일 기준 claude.com/ko/pricing 공식 요금제 페이지를 직접 캡처한 화면이에요.
정리하면 이래요. 무료(Free) 플랜은 $0이고, 클로드와 웹·iOS·Android·데스크톱에서 채팅하는 것, 채팅 안에서 간단한 코드 생성이나 데이터 시각화, 파일 생성·실행, 웹 검색, 대화 기억 기능까지는 모두 무료로 돼요. 하지만 지금 우리가 쓰려는 Code(클로드 코드)는 무료 플랜에 포함되어 있지 않아요. 이 문서에서 여러 번 나온 Cowork, Design, Science도 마찬가지로 무료 플랜에는 없고, 모두 Pro 플랜부터 쓸 수 있어요. 방금 실시간으로 확인한 공식 페이지 기준 Pro는 $17, Max는 $100부터로 표시되어 있었는데, 이는 오늘 오전 캡처하신 화면($18, $110)과 조금 달라요 — Anthropic이 결제 주기(월간/연간)나 로그인 여부에 따라 다른 금액을 보여줄 수 있다고 공식 페이지에 안내되어 있으므로, 실제 결제 전에는 로그인한 상태로 claude.com/ko/pricing에서 최종 금액을 한 번 더 확인하시길 권해드려요.
참고: Team 플랜의 시트 가격 (여러 명이 같이 쓰는 플랜)
개인용 Free/Pro/Max와 별도로, 2~150명 팀을 위한 Team 플랜이 있고, 좌석(시트) 종류가 두 가지로 나뉘어요.
| 시트 종류 | 가격 | 내용 |
|---|---|---|
| 스탠다드 시트 | $20 | 모든 Claude 기능(Code·Cowork·Design·Science 포함)에 Pro보다 더 많은 사용량 제공 |
| 프리미엄 시트 | $100 | 스탠다드 시트보다 5배 높은 사용량 제공 |
※ 교육에서 "팀 플랜 스탠다드 시트는 월 $22"라고 안내받으셨는데, 공식 페이지의 $20과 $2 차이가 있어 별도 확인이 필요해요.
4. 오늘 오후에 해볼 것 — 웹 브라우저로 클로드 코드 써보기
오늘 오후 시연 목표는 터미널을 전혀 쓰지 않고, 비개발자도 웹 브라우저 안에서 클로드 코드를 써보는 것이에요. 앞서 설명한 "다른 점 1"의 ②번(GitHub 연결 후 클라우드 실행) 방식으로 진행해요. GitHub 계정을 만들고 연결하는 것부터 함께 진행해요.
4-1. GitHub 가입하고 로그인하기
GitHub는 클로드 코드가 작업한 파일을 저장해두는 "인터넷 창고" 같은 곳이에요. 계정이 있어야 클로드 코드를 클라우드에서 쓸 수 있어요.
- 인터넷 브라우저 주소창에 github.com을 입력해서 들어가요.
- 화면 오른쪽 위에 있는 "Sign up"(가입하기) 글자를 눌러요.
- 이메일 주소 → 비밀번호 → 사용할 이름(username) 순서로 화면에 나오는 대로 입력해요.
- 내 이메일로 인증 코드(숫자)가 도착해요. 그 숫자를 화면에 입력하면 가입이 끝나요.
- 가입이 끝나면 자동으로 로그인된 상태가 돼요. (다음에 다시 들어올 때는 "Sign in" 글자를 눌러서, 아까 만든 이메일과 비밀번호로 로그인하면 돼요.)
4-2. GitHub에서 저장소(repository) 만들기
저장소(repository)는 앞서 말한 "인터넷 창고" 안에 만드는 프로젝트별 폴더 하나라고 생각하면 돼요. 클로드 코드가 작업할 폴더를 미리 하나 만들어둘게요.
- github.com/new 주소로 들어가요. (또는 github.com에 로그인한 상태에서 화면 오른쪽 위 "+" 버튼 → "New repository"를 눌러도 돼요.)
- Repository name(저장소 이름) 칸에 원하는 이름을 영어로 입력해요. 띄어쓰기는 안 되고, 대신
-나_를 써요. (예:my-first-project) - 화면 아래쪽에 Public(퍼블릭)과 Private(프라이빗) 중 하나를 고르는 부분이 있어요. 처음이라면 Public을 선택하는 걸 추천해요.
- 맨 아래 "Create repository" 버튼을 누르면 비어 있는 새 저장소가 만들어져요.
4-3. 클로드에서 설정 → 커넥터 들어가서 GitHub 연결하기
이제 클로드가 방금 만든 GitHub 계정을 볼 수 있도록 "연결"해줘요. Anthropic 공식 도움말에 나온 순서 그대로예요.
- claude.ai에 로그인한 상태에서, 화면 왼쪽 아래에 있는 내 이름(또는 동그란 아이콘)을 눌러요.
- 나오는 메뉴에서 "설정(Settings)" 또는 "Customize"를 누른 뒤, "커넥터(Connectors)" 메뉴로 들어가요. (주소창에 직접
claude.ai/customize/connectors를 입력해서 들어가도 돼요.) - 커넥터 목록 옆에 있는 "+" 버튼을 눌러요. 여러 서비스 목록이 떠요.
- 목록에서 "GitHub"를 찾아서 누른 뒤, "Connect"(연결) 버튼을 눌러요.
- GitHub 로그인 화면이 새 창으로 떠요. 아까 4-1에서 만든 계정으로 로그인해요.
- "클로드가 어떤 저장소에 접근하게 할지" 물어보는 화면이 나와요. 여기서 "모든 저장소(All repositories)"를 선택해요. (나중에 저장소를 새로 만들어도 클로드가 자동으로 볼 수 있어서 편해요.)
- 연결이 끝나면 커넥터 목록에 GitHub가 "연결됨"으로 표시돼요.
- github.com에 로그인한 상태에서 Settings → Applications → Claude → Configure로 들어가요.
- Repository access 항목이 "Only select repositories"로 되어 있다면, 방금 만든 저장소가 목록에 추가되어 있는지 확인해요. 없다면 목록에 새로 추가하거나 "All repositories"로 바꿔줘요.
- 그래도 안 보이면, 클로드 설정 → 커넥터에서 GitHub 연결을 한 번 해제한 뒤 이 4-3 과정을 처음부터 다시 해보세요.
4-4. 클라우드 환경 만들기 (인터넷에 있는 내 작업 공간)
클로드 채팅에서 </>(Code) 탭을 누르고 저장소를 고르면, 처음 한 번은 "환경 생성(Create environment)"이라는 화면이 나와요. 이 "환경"은 쉽게 말해 클로드 코드가 일할 때 쓰는, 인터넷 위에 있는 작은 컴퓨터(작업 공간)라고 생각하면 돼요. 화면에는 아래 4가지 칸이 순서대로 나와요.
- 이름(Name) 칸: 이 작업 공간을 부르는 이름을 적는 빈칸이에요. 클로드가 자동으로 이름을 채워주므로, 그냥 그대로 두면 돼요. (나중에 프로젝트를 여러 개 만들 때만 구분하려고 이름을 바꾸면 돼요.)
- 네트워크 접근(Network access) 칸: 이 작업 공간이 인터넷의 어디까지 들어갈 수 있는지 정하는 부분이에요. 기본값은 "Trusted"라고 적혀 있는데, 이는 "프로그램을 설치할 때 꼭 필요한 몇몇 안전한 사이트에만 들어갈 수 있고, 그 외에는 못 들어간다"는 뜻이에요. 처음에는 이 기본값을 그대로 두세요.
- 환경 변수(Environment variables) 칸: 비밀번호나 특별한 설정값을 미리 넣어두는 칸이에요. 지금은 필요 없으니 비워둬요.
- 설정 스크립트(Setup script) 칸: 작업 공간이 만들어지기 전에 미리 실행할 명령어를 적는 칸이에요. 이것도 처음에는 비워둬요.
네 칸을 모두 그대로(비워두거나 기본값 그대로) 두고, 화면 아래쪽에 있는 "환경 생성(Create environment)" 버튼(파란색 또는 진한 색 버튼)을 누르면 끝이에요. Anthropic 공식 문서도 "첫 번째 프로젝트의 경우, 기본값을 유지하고 환경 생성을 클릭하세요"라고 정확히 이렇게 안내하고 있어요. 즉, 이 화면에서는 아무것도 고민하지 말고 버튼만 누르면 돼요.
4-5. 저장소 선택하고 작업 시켜보기
- 입력창 아래의 저장소 선택기(repository selector)에서, 아까 만든(또는 연결된) 저장소를 선택해요.
- "클로드가 얼마나 자유롭게 작업해도 되는지" 정하는 항목(권한 모드)이 있어요. 기본값인 "편집 자동 수락(Accept edits)"으로 두면, 클로드가 매번 물어보지 않고 바로 작업해서 결과를 저장해요. 한 단계씩 확인받고 싶다면 "Plan Mode"로 바꿔요.
-
하고 싶은 작업을 구체적으로 문장으로 적어요. 예시:
사용법을 설명하는 README 파일을 새로 만들어줘
- Enter를 누르면 클로드가 저장소를 복사해서 클라우드 안에서 작업을 시작해요.
4-6. 결과 확인하기
- 작업이 끝나면 변경된 줄 수(예: +42 -18)가 표시돼요. 이를 눌러 어떤 부분이 바뀌었는지 확인해요.
- 특정 줄에 마음에 안 드는 부분이 있으면, 그 줄을 클릭하고 의견을 남길 수 있어요.
- 결과가 마음에 들면 "PR 생성(Create PR)" 버튼을 눌러서, 클로드가 고친 내용을 실제 GitHub 저장소에 반영할 수 있어요. (PR은 "이렇게 바꿔도 될까요?"라고 제안하는 것이라고 생각하면 돼요.)
index.html 파일 1개만 있어도 배포할 수 있는 더 쉬운 방법이 있어요 — Netlify Drop이라는 무료 서비스에 파일을 끌어다 놓기만 하면 버튼 한 번으로 페이지 주소가 만들어져요. app.netlify.com/drop