Claude Code는 Pro, Max, Team, Enterprise 요금제에서 쓸 수 있고 무료 요금제에는 포함되지 않습니다. 회사에서 발급받은 Anthropic Console 계정으로도 터미널의 Claude Code를 쓸 수 있습니다.
Claude Code CLI 설치
CLI(Command Line Interface, 명령줄 인터페이스)는 앱 화면의 버튼 대신 터미널에 명령어를 입력해 Claude Code를 실행하는 방식입니다. 터미널을 한 번도 열어 본 적이 없어도 됩니다. 아래 설치 순서의 명령어 토글을 펼쳐 안에 있는 문장을 그대로 붙여넣고 엔터를 누르면 설치가 끝납니다.
이후 수업에서 터미널 명령과 자동 실행을 다루기 때문에 앱 설치 바로 다음에 함께 설치합니다. 설치 명령은 이 페이지와 공식 문서에 적힌 것만 실행하고 다른 곳에서 받은 설치 스크립트는 실행하지 않습니다.
같은 프로젝트 폴더를 엽니다
워크스페이스는 프로젝트 폴더를 여러 개 모아 둔 상위 폴더입니다. Claude가 읽고 고칠 수 있는 범위는 연 폴더에서 시작하므로, 작업 대상으로는 워크스페이스 전체 대신 지금 진행할 프로젝트 폴더 하나를 고릅니다.
앱과 터미널에서 같은 프로젝트 이름과 최상위 파일 목록이 보이면 연결이 맞습니다. 첫 요청에는 파일을 고치지 말라는 조건을 함께 적습니다.
Claude 공식 다운로드 페이지를 열고 macOS와 Windows 중 쓰고 있는 운영체제에 맞는 설치 파일을 내려받습니다.
화면에서 확인할 것앱 설치, 로그인, Code 열기 순서를 확인합니다. 출처는 Claude Code 공식 문서입니다. Claude Code Docs · 2026-08-19
Code 화면에서 Local을 고르고 Select folder를 눌러, 프로젝트를 모아 둔 상위 폴더 대신 지금 작업할 프로젝트 폴더 하나를 엽니다.
확인화면에 방금 고른 프로젝트 폴더 이름이 표시됩니다.
이 단계의 실제 화면
화면에서 확인할 것Code에서 Local과 Select folder를 차례로 선택합니다. 출처는 Claude Code 공식 문서입니다. Claude Code Docs · 2026-08-19
macOS나 Linux를 쓰면 터미널을 엽니다. macOS는 command와 스페이스를 함께 눌러 Spotlight 검색을 열고 Terminal을 입력한 뒤 엔터를 누르며, Linux는 control과 alt와 T를 함께 누릅니다. 창이 열리면 아래 명령어 토글을 펼쳐 설치 명령을 붙여넣고 엔터를 누릅니다.
첫 줄은 설치된 버전을 출력합니다. 둘째 줄은 세션을 시작하지 않고 설치 상태와 설정 파일을 점검한 결과를 보여 줍니다.
claude --version
claude doctor
확인첫 명령에서 2.1.211 (Claude Code)처럼 버전 번호가 나오고 둘째 명령에서 점검 결과가 나옵니다.
이 단계의 실제 화면
화면에서 확인할 것설치 뒤 새 터미널에서 버전과 상태를 확인합니다. 출처는 Claude Code 공식 설치 문서입니다. Claude Code Docs · 2026-08-19
앱에서 연 것과 같은 프로젝트 폴더로 터미널의 위치를 옮기고 Claude Code를 실행한 뒤, 파일을 고치지 않는 요청으로 폴더가 맞는지 확인합니다.
지금 선택한 프로젝트 폴더의 이름과 최상위 파일·폴더 이름만 보여 줘. 파일은 아직 고치지 마.
명령어로 직접 하기
첫 줄은 터미널이 보고 있는 위치를 그 폴더로 옮깁니다. cd를 입력하고 한 칸 띄운 다음 Finder나 파일 탐색기에서 폴더를 창 안으로 끌어다 놓으면 경로가 대신 입력됩니다. 둘째 줄은 그 폴더에서 Claude Code를 시작합니다.
cd 프로젝트-폴더-경로
claude
확인앱에서 본 것과 같은 프로젝트 이름과 최상위 목록이 나오고 파일은 하나도 바뀌지 않습니다.
연습
Claude 앱과 Claude Code CLI를 모두 설치하고 두 곳에서 같은 실제 프로젝트 폴더의 최상위 목록을 확인합니다.
Claude 앱의 Code와 Claude Code CLI에서 같은 프로젝트 이름과 최상위 파일 목록이 보이며 파일 변경이 0건이면 완료입니다.
알아두면 좋습니다
앱에서 Code를 눌렀을 때 업그레이드 안내가 나오면 요금제를 확인합니다. Claude Code는 Pro, Max, Team, Enterprise 요금제에서 쓸 수 있고 무료 요금제에는 포함되지 않습니다. Select folder에서는 프로젝트를 모아 둔 상위 폴더 대신 지금 작업할 프로젝트 폴더 하나를 고릅니다. Windows에서 앱의 Local 세션을 쓰려면 Git을 먼저 설치해야 합니다. 대부분의 Mac에는 Git이 기본으로 들어 있습니다. 터미널에서 쓰는 CLI에서는 Git for Windows가 선택입니다. 설치하면 Claude Code가 Git Bash로 Bash 도구를 쓰고 설치하지 않으면 PowerShell을 대신 씁니다. Windows에서 irm is not recognized라는 오류가 나오면 PowerShell 대신 CMD 창을 연 것이므로 줄 앞이 PS로 시작하는지 보고 창을 닫은 뒤 PowerShell을 새로 엽니다. 설치가 끝났는데 claude 명령을 찾지 못한다는 안내가 나오면 창을 완전히 닫았다가 새로 연 뒤 다시 실행합니다. 앱과 터미널에서 서로 다른 폴더 이름이 보이면 앱에서 Select folder를 다시 누르거나 터미널에서 그 폴더로 이동한 뒤 다시 확인합니다.
새 세션을 열면 Claude Code는 방금 고른 폴더를 작업 대상으로 잡고 요청을 기다립니다. 요청을 보내면 답만 돌아오는 것이 아니라 폴더 안의 파일이 실제로 만들어지거나 고쳐지는데, 그 일이 일어나기 전에 승인 창을 띄울지는 권한 모드가 정합니다.
권한 모드가 무엇을 허용하고 무엇을 막는지
모드 이름은 화면에 늘 표시되므로 외울 필요는 없습니다. 데스크톱 앱에서는 보내기 버튼 옆 모드 선택기에서 읽고 바꾸며, 터미널에서 연 화면에서는 Shift+Tab을 누를 때마다 다음 모드로 넘어가고 아래쪽 상태 표시줄에 현재 모드가 나타납니다.
Manual — 파일을 읽는 일만 바로 진행합니다. 파일을 만들거나 고칠 때, 터미널 명령을 실행할 때, 인터넷에 접속할 때는 그때마다 승인 창을 띄웁니다. 설정 파일과 안내 문서에서는 같은 모드를 default라는 값으로 부릅니다.
acceptEdits — 지금 연 폴더 안의 파일을 만들고 고치는 일까지 승인 창 없이 적용하며, mkdir·touch·mv·cp 같은 파일 정리 명령도 함께 통과시킵니다. 폴더 밖의 경로와 그 밖의 터미널 명령은 여전히 승인을 묻습니다.
plan — 파일을 고치지 않고 먼저 계획을 내놓습니다. 계획을 승인하면 그때 모드가 바뀌면서 수정이 시작되므로, 무엇을 건드릴지 미리 읽어 보고 싶을 때 씁니다.
auto — classifier라는 별도 모델이 작업을 대신 검토하면서 승인 창 없이 진행합니다. 요청 범위를 넘어서는 작업은 막지만, 사람이 읽는 승인 절차를 대신하지는 못합니다.
목록에는 dontAsk와 bypassPermissions도 보입니다. 자동화 스크립트와 격리된 컨테이너에서 쓰는 모드라, 연습하는 동안에는 고르지 않습니다.
모드를 잘못 골랐을 때
바꾼 모드는 다음 요청부터 적용되므로, 아직 요청을 보내기 전이라면 모드 선택기에서 Manual을 다시 고르는 것으로 끝납니다. 이미 요청이 지나간 뒤라면 파일이 바뀐 상태이므로, 되돌리기까지 함께 해야 합니다.
데스크톱 앱에서 모드 선택기로 고른 모드는 그 폴더에 기억됩니다. 다음에 같은 폴더를 열면 지난번에 고른 모드가 그대로 켜져 있으므로, 연습이 끝나면 Manual로 돌려 두는 편이 안전합니다. plan은 예외라서 그 세션에만 적용됩니다.
되돌리는 방법
Claude Code는 요청을 보낼 때마다 그 직전의 파일 상태를 체크포인트로 저장합니다. 입력창을 완전히 비운 상태에서 Esc를 두 번 누르면 이번 세션에서 보낸 요청 목록이 뜨고 돌아갈 지점을 고른 뒤 무엇을 되돌릴지 선택합니다. Restore code는 파일만 되돌리고 대화는 남기며, Restore code and conversation은 파일과 대화를 같은 지점으로 함께 되돌립니다.
되돌리기로 되살아나는 것은 Claude가 파일 편집 기능으로 직접 고친 파일까지입니다. 터미널 명령으로 지우거나 옮긴 파일은 체크포인트에 담기지 않아 rewind로 돌아오지 않으므로, 그런 작업까지 되돌리려면 Git으로 기록해 두어야 합니다.
진행 중인 답이나 실행을 중간에 멈출 때는 Esc를 한 번 누릅니다.
순서의 각 단계 아래 붙여넣기 예제가 있습니다. 위에서부터 하나씩 실행해 보세요.
Claude 앱에서 Code를 열고 Local을 고른 뒤, Select folder를 눌러 이번에 작업할 프로젝트 폴더 하나를 엽니다.
확인모드 선택기에 Manual이 표시됩니다. 계정과 조직 설정에 따라 세션이 다른 모드로 시작할 수 있으므로, 이미 Manual이면 그대로 둡니다.
이 단계의 실제 화면
화면에서 확인할 것화면에 Manual로 표시되는 모드의 설정값 이름이 표의 default입니다. acceptEdits는 파일 수정까지, auto는 전체 작업을 승인 창 없이 진행하며, plan은 파일을 고치기 전에 계획을 먼저 내놓습니다. Claude Code 공식 문서 · 2026-08-19
대화 입력창에 아래 요청을 붙여넣고 보냅니다.
메모 파일 하나를 새로 만들어 줘. 파일 이름은 note.md로 하고, 오늘 확인해야 할 일 3가지를 체크리스트로 적어 줘.
확인파일이 바뀌기 전에 승인 창이 뜨고 만들려는 파일 이름과 새로 들어갈 내용이 함께 보입니다.
승인 창에서 파일 이름이 note.md인지, 새로 들어갈 내용이 체크리스트 세 항목인지 읽은 뒤 Yes를 누릅니다. 다른 파일 이름이 보이면 No를 누르고 무엇을 만들지 다시 적어 보냅니다.
터미널에서 claude 명령으로 연 Claude Code 화면 안에서 입력합니다. Esc를 두 번 누르는 것과 같은 메뉴가 열립니다.
/rewind
확인이번 세션에서 보낸 요청이 차례로 보이고 Restore code를 고르면 note.md가 만들어지기 전 상태로 돌아갑니다.
이 단계의 실제 화면
화면에서 확인할 것Restore code는 파일 변경만 되돌리고 대화는 남깁니다. Restore code and conversation을 고르면 파일과 대화를 같은 시점으로 되돌립니다. Claude Code 공식 문서 · 2026-08-19
연습
승인 창에 뜬 파일 이름과 바뀔 내용을 끝까지 읽은 뒤에 Yes를 눌러 보세요.
지금 세션의 권한 모드 이름을 화면에서 찾아 말할 수 있고 방금 만든 파일을 되돌리는 rewind 메뉴를 열어 봤으면 통과입니다.
알아두면 좋습니다
acceptEdits는 파일 수정과 mkdir·mv·cp 같은 명령을 승인 창 없이 적용합니다. 데스크톱 앱의 모드 선택기에서 고른 모드는 그 폴더에 기억되어 다음에 같은 폴더를 열 때도 그대로 켜지므로, 한 번 바꿔 두면 다음 세션의 파일 변경도 승인 창 없이 지나갑니다. 파일을 하나씩 확인하며 연습하는 동안에는 모드 선택기에서 Manual을 고르고 터미널에서는 Shift+Tab으로 Manual까지 돌립니다.
프로젝트 폴더를 Claude Code 또는 Codex에서 열고, 필요한 자료를 첨부한 뒤 요청문 옆 복사 버튼을 누릅니다. 대괄호가 있는 요청은 내 내용으로 바꿔 붙여넣으며, 답변을 받은 뒤에는 안내된 파일이나 화면을 직접 확인합니다.
project-brief.md에는 다섯 가지를 정합니다. 이후 brand.md나 workflow.md로 갈라지는 모든 개인화 작업이 여기서 출발합니다.
만들 결과물
사용할 사람
현재 가진 자료
완료 기준
하지 않을 일
파일은 직접 채우지 않습니다.
Claude Code에게 한 번에 한 질문씩 묻게 합니다. 순서대로 답만 하면 브리프가 완성됩니다.
답이 모호하면 예시 3개를 보여 달라고 요청해 그중에서 고릅니다.
완료 기준은 확인 가능한 문장으로 적습니다.
애매한 기준 — “결과물이 좋아 보인다”
확인 가능한 기준 — “A4 한 장, 고객 3유형, 금지 표현 5개가 들어간다”
확인할 수 없는 기준은 나중에 결과물을 두고 다시 논쟁하게 됩니다.
아래 요청문을 복사해 붙여넣고 project-brief.md 인터뷰를 시작합니다.
만들 결과물을 한 문장으로 정합니다.
이 폴더에서 만들 결과물을 정리하려고 합니다. 제가 첨부한 자료를 읽고, 만들 것·사용할 사람·가진 자료·완료 기준·하지 않을 일을 한 번에 한 질문씩 물어봐 주세요. 답을 요약해 제 확인을 받은 뒤 project-brief.md로 저장하고 파일 위치를 알려 주세요. 기존 파일이 있으면 먼저 읽고 바꿀 부분을 보여 주세요.
확인답을 확인한 뒤 project-brief.md 파일이 생기고, 다섯 항목과 파일 위치를 확인할 수 있습니다.
그 결과물을 쓸 사람을 정합니다.
지금 가진 자료를 정리합니다.
완료 기준을 확인 가능한 문장으로 적습니다.
이번 프로젝트에서 하지 않을 일을 적습니다.
연습
완료 기준이 "결과물이 좋아 보인다"처럼 뭉뚱그린 문장은 아닌지 확인해 보세요. "A4 한 장, 고객 3유형, 금지 표현 5개"처럼 확인 가능한 문장인지가 기준입니다.
프로젝트 결과물, 사용할 사람, 가진 자료, 완료 기준, 하지 않을 일을 project-brief.md에 적었습니다.
알아두면 좋습니다
설치가 막혀 Claude Code를 아직 못 열었다면 Claude Chat에서 같은 질문을 먼저 진행하고 마지막 결과를 복사해 둡니다. Code 설치 후 파일로 옮기면 됩니다.
일을 시작하기 전에 무엇을 만들지 정리한 짧은 문서입니다. 여기서는 project-brief.md 파일을 말합니다.
04
브랜드 기준 문서
대상 고객·문제·인상·사용할 말·참고 브랜드 다섯 질문이 brand.md의 뼈대입니다
project-brief.md 다음 단계는 brand.md이고, 다섯 질문으로 정리합니다.
대상 고객
지금 겪는 문제
남기고 싶은 인상
자주 쓸 말과 쓰지 않을 말
참고할 브랜드
파일은 직접 채우지 않습니다.
project-brief.md를 먼저 읽게 하고, 다섯 항목을 한 번에 한 질문씩 물어보게 합니다.
답이 끝나면 사실, 결정, 아직 모르는 것을 구분해서 정리해 달라고 요청합니다.
색과 폰트처럼 아직 정하지 않은 항목은 추측으로 채우지 않습니다.
“미정”으로 남겨 두고, 다음 시각 탐색 단계에서 다시 결정합니다.
모르는 것을 안다고 적어 두면 이후 모든 요청이 그 위에서 어긋납니다.
아래 요청문을 복사해 붙여넣고 brand.md 인터뷰를 시작합니다.
누구를 위한 브랜드인지 정합니다.
project-brief.md와 첨부한 브랜드 자료를 읽고 brand.md를 만들어 주세요. 대상 고객·고객의 문제·남길 인상·쓸 말과 피할 말·참고할 브랜드 중 빠진 내용만 한 번에 하나씩 질문해 주세요. 제 답을 확인받은 뒤 사실·결정·미정을 구분해 저장하고, 추측으로 채운 항목이 없는지 확인해 주세요.
확인brand.md에서 대상 고객, 인상, 표현 기준을 확인하고 아직 정하지 않은 항목을 미정으로 구분할 수 있습니다.
그 사람이 지금 겪는 문제를 적습니다.
우리를 본 뒤 어떤 인상을 받아야 하는지 정합니다.
자주 쓸 말과 쓰지 않을 말을 나눕니다.
참고할 브랜드와 따라 하지 않을 요소를 구분합니다.
연습
brand.md에 적힌 문장이 사실인지 결정인지 구분해서 읽어 보세요. 색과 폰트처럼 아직 안 정한 항목이 추측으로 채워져 있지 않은지 확인합니다.
대상 고객, 남기고 싶은 인상, 금지 표현을 적고, 정하지 못한 항목은 미정으로 남겼습니다.
알아두면 좋습니다
색과 폰트를 아직 정하지 않았다면 추측해서 확정하지 말고, "미정"으로 남겨 다음 시각 탐색에서 결정합니다.
프로젝트의 목적과 배경을 정리해 두는 텍스트 파일입니다. brand.md를 만들기 전 먼저 준비하는 문서입니다.
05
업무 흐름 문서
입력·판단·실행·출력·예외를 순서대로 적고, 사람 승인이 필요한 지점에 표시합니다
workflow.md는 project-brief.md 다음 단계로 만들고, 다섯 항목으로 실제 업무 흐름을 정리합니다.
입력 — 일이 시작될 때 들어오는 자료
판단 — 사람이 결정해야 하는 기준
실행 — 반복해서 하는 단계
출력 — 마지막에 나와야 하는 결과
예외 — 자동으로 처리하면 안 되는 경우
project-brief.md를 먼저 읽게 하고, 실제로 하는 일을 인터뷰하게 합니다. 다섯 항목을 한 번에 한 질문씩 구분해서 묻게 합니다.
결제, 발송, 삭제, 공개처럼 되돌리기 어려운 단계는 자동 실행 대상으로 두지 않습니다. 먼저 사람이 확인하는 승인 지점으로 표시해 둡니다.
마지막에는 현재 흐름과 개선 후보를 분리해서 정리합니다. 지금 하는 일과 나중에 자동화할 일이 섞이지 않습니다.
아래 요청문을 복사해 붙여넣고 workflow.md 인터뷰를 시작합니다.
일이 시작될 때 들어오는 입력 자료를 정리합니다.
project-brief.md를 읽고 제가 반복하는 업무를 workflow.md로 정리해 주세요. 시작할 때 받는 자료·사람의 판단·반복 단계·최종 결과·예외 중 빠진 내용만 한 번에 하나씩 물어봐 주세요. 제 답을 확인받은 뒤 현재 방식과 개선 후보를 나눠 저장하고, 결제·외부 발송·삭제처럼 제 승인이 필요한 단계도 표시해 주세요. 실제 업무는 아직 실행하지 마세요.
확인workflow.md에 현재 업무 순서, 개선 후보, 직접 승인할 단계가 나뉘며 실제 업무는 실행하지 않습니다.
사람이 결정해야 하는 판단 기준을 적습니다.
반복해서 하는 실행 단계를 나열합니다.
마지막에 나와야 하는 출력을 정합니다.
자동으로 처리하면 안 되는 예외를 표시합니다.
연습
입력과 출력이 각각 한 문장으로 적혀 있는지, 사람이 판단해야 하는 지점이 표시되어 있는지 확인해 보세요.
입력과 출력이 적혀 있고, 사람이 판단해야 하는 지점과 자동 실행하면 안 되는 예외가 있으면 통과입니다.
알아두면 좋습니다
결제, 발송, 삭제, 공개처럼 되돌리기 어려운 단계는 자동 실행 대상으로 두지 않습니다. 먼저 사람이 확인하는 승인 지점으로 표시합니다.
자동으로 진행하지 않고, 사람이 한 번 확인한 뒤에만 다음 단계로 넘어가게 표시해 둔 곳입니다.
06
조사 기준 문서
조사 범위·출처·최신성 기준을 적어야 확인된 사실과 미확인 주장이 섞이지 않습니다
research-brief.md는 project-brief.md 다음 단계로 만듭니다. 질문, 출처, 최신성, 범위, 형식 다섯 항목으로 조사 기준을 정리합니다.
project-brief.md를 먼저 읽게 하고, 알아내야 하는 것을 인터뷰하게 합니다. 다음을 한 번에 한 질문씩 구분해서 묻게 합니다.
이 조사로 답하려는 질문
인정할 출처와 인정하지 않을 출처
언제 이후 자료만 쓸지
조사에서 뺄 범위
결과를 어떻게 정리해 받을지
출처 기준은 조사 주제마다 다릅니다.
공식 발표와 원문만 쓸지, 업계 기사까지 인정할지, 커뮤니티 글은 참고로만 둘지 미리 정해 두면 결과를 받아 놓고 다시 걸러 내지 않아도 됩니다.
기준 날짜도 함께 정합니다. 날짜를 정하지 않으면 몇 해 전 자료가 지금 상황처럼 섞여 들어옵니다.
가장 자주 어긋나는 곳은 수치와 인용입니다. 출처가 없어도 문장은 그럴듯하게 채워지므로, 수치와 인용에는 링크를 함께 달게 하고 몇 개는 직접 열어 확인합니다. 찾지 못한 항목은 사실로 적지 않고 확인하지 못한 것으로 따로 빼 둡니다.
아래 요청문을 복사해 붙여넣고 research-brief.md 인터뷰를 시작합니다.
알아내야 하는 것을 질문 형태로 적습니다.
project-brief.md를 읽고 research-brief.md를 만들어 주세요. 조사로 답할 질문·인정할 출처·자료의 기준 날짜·제외할 범위·결과 형식을 한 번에 하나씩 물어봐 주세요. 제 답을 확인받아 저장하고, 조사 결과에서 확인한 사실과 미확인 내용을 구분하도록 적어 주세요. 실제 조사는 아직 시작하지 마세요.
확인research-brief.md에 조사 질문, 출처 기준, 날짜, 제외 범위, 결과 형식이 담기며 아직 조사는 실행하지 않습니다.
어떤 자료를 출처로 인정할지 정합니다.
언제 이후 자료만 쓸지 기준 날짜를 정합니다.
조사에서 뺄 범위를 표시합니다.
확인한 사실과 아직 확인하지 못한 것을 나눠 적는 형식을 정합니다.
연습
정리된 결과에서 수치나 인용을 하나 골라 링크를 직접 열어 보세요. 원문에 그 문장이 실제로 있는지 확인합니다.
답하려는 질문과 인정할 출처가 적혀 있고, 기준 날짜가 있고, 확인한 사실과 확인하지 못한 것이 나뉘어 있으면 통과입니다.
알아두면 좋습니다
출처가 없는 수치와 인용은 그럴듯한 문장으로 채워지기 쉬우므로, 링크를 달게 하고 직접 열어 확인합니다. 기준 날짜를 정하지 않으면 몇 해 전 자료가 현재 상황처럼 섞여 들어옵니다.
