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를 다시 누르거나 터미널에서 그 폴더로 이동한 뒤 다시 확인합니다.
02설치첫 세션첫 세션화면에서 권한 모드를 확인해 고르고 첫 세션에서 파일을 하나 만든 뒤 되돌릴 수 있습니다내용 열기내용 접기
첫 세션에서는 권한 요청을 확인한 뒤 작은 파일 하나를 만들어 설치를 검증합니다
새 세션을 열면 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까지 돌립니다.
