0. 기초
AI와 컴퓨터, 터미널을 익히고 Claude Code를 처음 실행합니다.
67개 항목
컴퓨터 화면과 터미널
핵심 5 · 중요 10 · 참고 4| 중요도 | 키워드 | 뜻 |
|---|---|---|
| 핵심 | 프로젝트 폴더(작업 폴더)Project folder (workspace)상세설명 → | Claude Code와 한 가지 일을 진행하는 기준 폴더입니다. 이 폴더에서 claude를 실행하고, 안에 있는 자료를 읽거나 필요한 파일을 만들어 정리하도록 요청합니다. |
| 핵심 | 경로Path상세설명 → | 파일·폴더의 위치를 나타내는 주소이며, 절대경로는 전체 주소이고 상대경로는 현재 위치를 기준으로 한 주소입니다. |
| 핵심 | 현재 폴더Current directory | 지금 터미널이 작업하는 폴더이며, Mac 터미널은 pwd, Windows PowerShell은 Get-Location으로 확인합니다. |
| 핵심 | 파일 확장자File extension상세설명 → | 강의안.pdf의 .pdf처럼 파일 이름 끝에서 형식을 구분하는 부분입니다. 어떤 종류의 파일인지와 사용할 앱을 판단하는 단서이며, 이름 끝만 바꿔도 내용이 다른 형식으로 변환되지는 않습니다. |
| 핵심 | 마크다운(md 파일)상세설명 → | 텍스트 파일의 한 종류이며, .md로 저장하고 # 제목·- 목록 같은 기호로 글의 구조를 표시합니다. |
| 중요 | 절대경로Absolute path | 현재 위치와 관계없이 대상을 찾을 수 있도록 파일·폴더의 위치를 처음부터 적은 전체 주소입니다. |
| 중요 | 상대경로Relative path | 현재 폴더를 출발점으로 적는 주소로, 현재 위치가 바뀌면 가리키는 파일·폴더도 달라집니다. |
| 중요 | 홈 폴더Home folder (home directory) | 내 계정의 사용자 폴더이며, 셸에서 물결 기호는 이 폴더를 뜻합니다. |
| 중요 | 텍스트 파일Text file | 글자와 줄바꿈을 저장하는 파일이며, 일반 메모의 .txt뿐 아니라 마크다운(.md)과 CSV(.csv)도 여기에 속합니다. |
| 중요 | CSVComma-Separated Values | 쉼표로 구분한 값(Comma-Separated Values)의 줄임말로, 표 데이터를 쉼표로 구분해 저장하는 텍스트 파일 형식입니다. .csv 파일은 엑셀이나 텍스트 편집기로 열 수 있습니다. |
| 중요 | HTMLHyperText Markup Language상세설명 → | 하이퍼텍스트 마크업 언어(HyperText Markup Language)의 줄임말로, 웹페이지의 제목·본문·이미지·링크 같은 구조를 표시하는 언어입니다. 보통 .html 파일에 작성하며, 브라우저가 해석해 화면에 보여 줍니다. |
| 중요 | 브라우저Web browser | 웹페이지를 보는 프로그램입니다. |
| 중요 | 복사·붙여넣기(텍스트·캡처)Copy and paste / screenshot상세설명 → | 문제 해결을 요청할 때 오류 메시지 전체와 직전에 한 작업을 AI에게 전달하며, 선택할 수 있는 글은 복사하고 화면 모습은 캡처로 보충합니다. |
| 중요 | 옵션·플래그Option / flag | 명령을 어떤 방식으로 실행할지 정하는 추가 설정으로, “숨김 파일도 표시” 같은 조건을 붙입니다. |
| 중요 | 인자Argument | 명령이 처리할 대상이나 값으로, “lecture 폴더로 이동”에서 lecture에 해당합니다. |
| 참고 | 숨김 폴더·파일Hidden files and folders상세설명 → | 목록에서 기본적으로 감춰진 파일·폴더이며, macOS·Linux는 주로 이름 앞의 점을, Windows는 숨김 속성을 사용합니다. |
| 참고 | 끌어다 놓기Drag and drop상세설명 → | 파일이나 폴더를 마우스로 잡아 다른 창에 놓는 동작입니다. 로컬 터미널에는 파일 경로가 입력될 수 있지만, SSH로 접속한 원격 컴퓨터에 파일이 자동으로 전송되지는 않습니다. |
| 참고 | 대소문자 구분Case sensitivity | A와 a를 서로 다른 글자로 취급하는 규칙으로, 파일 이름·명령·코드에 따라 적용 여부가 다릅니다. |
| 참고 | 자동 완성 제안Autocomplete suggestion | 명령이나 파일 이름의 일부만 입력했을 때 나머지를 채워 주는 기능입니다. |
Claude Code 첫 화면
핵심 2 · 중요 4 · 참고 1| 중요도 | 키워드 | 뜻 |
|---|---|---|
| 핵심 | 입력창Prompt input | AI에게 요청을 적고 Enter로 보내는 줄이며, › 같은 표시는 입력 위치를 뜻하고 기호 모양은 제품·버전에 따라 다릅니다. |
| 핵심 | Permission Modes(승인 모드)상세설명 → | Claude Code가 파일을 수정하거나 명령을 실행할 때 누구의 확인을 거칠지 정하는 방식입니다. Manual(default), Auto, Bypass Permissions의 차이와 Mac·Windows별 실행 방법을 함께 살펴봅니다. |
| 중요 | 폴더 신뢰 확인Workspace trust | 프로젝트 설정·코드의 출처를 확인하고 신뢰 여부를 선택합니다. |
| 중요 | 시작 안내 화면(배너)Startup banner | claude를 실행했을 때 처음 나오는 안내 화면입니다. Claude Code 버전·사용 모델·현재 작업 폴더 등을 확인하며, 특히 원하는 폴더에서 시작했는지 살펴봅니다. |
| 중요 | 슬래시 명령Slash command | /로 시작하는 Claude Code 내부 명령이며, /exit·/clear·/usage 등이 있습니다. |
| 중요 | 종료Exit상세설명 → | Claude Code의 일반 세션을 마치는 조작입니다. 필요한 기록과 실행 중인 작업 상태를 먼저 확인합니다. |
| 참고 | 모드 표시(하단)Permission mode indicator상세설명 → | Claude Code 입력창 아래에서 현재 승인 모드를 알려 주는 표시입니다. 파일 수정·명령 실행을 사람이 확인하는지, 일부를 자동 허용하는지, 확인 없이 진행하는지를 구분합니다. |
터미널 기본 명령
핵심 13같은 작업을 OS별로 비교합니다. Mac은 zsh, Windows는 PowerShell, Linux는 bash 기준입니다. Windows 열은 익숙한 짧은 명령을 먼저 쓰고, 정식 이름을 아래에 작게 표시합니다. 예시의 파일·폴더는 직접 준비한 연습용 대상입니다. 명령은 한 번에 하나씩 확인하며, 표는 일괄 실행용이 아닙니다. PowerShell과 cmd의 차이를 먼저 확인합니다.
옆으로 밀면 Windows·Linux 열이 있습니다
| 중요도 | 키워드·설명 | Mac · zsh | Windows · PowerShell | Linux · bash |
|---|---|---|---|---|
| 핵심 | pwd현재 위치를 확인합니다. | pwd | pwd정식 Get-Location | pwd |
| 핵심 | ls파일과 폴더 목록을 봅니다. | ls | ls정식 Get-ChildItem | ls |
| 핵심 | cd 폴더lecture 폴더로 이동합니다. | cd lecture | cd lecture정식 Set-Location lecture | cd lecture |
| 핵심 | cd ..한 단계 위 폴더로 이동합니다. | cd .. | cd ..정식 Set-Location .. | cd .. |
| 핵심 | cd ~내 계정의 홈 폴더로 이동합니다. | cd ~ | cd ~정식 Set-Location $HOME | cd ~ |
| 핵심 | mkdir practice새 연습 폴더(practice)를 만듭니다. | mkdir practice | mkdir practice정식 New-Item practice -ItemType Directory | mkdir practice |
| 핵심 | open .현재 폴더를 파일 관리자로 엽니다. | open . | explorer . | xdg-open . |
| 핵심 | open 결과.html파일을 연결된 앱으로 엽니다. | open result.html | Invoke-Item result.html | xdg-open result.html |
| 핵심 | clear화면 표시를 정리합니다. | clear | clear정식 Clear-Host | clear |
| 핵심 | Tab 명령이나 파일 이름의 자동 완성을 시도합니다. | Tab | Tab | Tab |
| 핵심 | ↑ / ↓ 이전·다음 명령을 불러옵니다. | 위·아래 방향키 | 위·아래 방향키 | 위·아래 방향키 |
| 핵심 | Ctrl+C 실행 중인 프로그램에 중단을 요청합니다. | Ctrl+C | Ctrl+C | Ctrl+C |
| 핵심 | "공백 있는 경로"Quoted path공백이 있는 경로를 한 덩어리로 전달합니다. | cd "course notes" | Set-Location "course notes" | cd "course notes" |
OS별 차이와 주의사항
open .: Linux 예시는 그래픽 데스크톱 환경이 필요합니다.open 결과.html: Linux 예시는 그래픽 환경과 xdg-open이 필요합니다.clear: 작업 파일을 삭제하지 않습니다.Tab: 셸 설정에 따라 선택 방식이 다릅니다.Ctrl+C: 프로그램에 따라 반응이 다를 수 있습니다.
Claude Code 슬래시 명령
핵심 2 · 중요 2 · 참고 3| 중요도 | 키워드 | 뜻 |
|---|---|---|
| 핵심 | /login | 로그인합니다. |
| 핵심 | /status | 세션 상태를 확인합니다. |
| 중요 | /copy | 응답을 복사합니다. |
| 중요 | /logout | 로그아웃합니다. |
| 참고 | /focus | 간략한 화면으로 전환합니다. |
| 참고 | /theme | 화면 테마를 변경합니다. |
| 참고 | /upgrade | 상위 요금제를 안내합니다. |
Claude Code CLI 실행 명령
핵심 4 · 중요 1| 중요도 | 키워드 | 뜻 |
|---|---|---|
| 핵심 | claude | 대화형 세션을 시작합니다. |
| 핵심 | claude "요청" | 첫 요청과 함께 세션을 시작합니다. |
| 핵심 | claude auth login | 계정 인증을 시작합니다. |
| 핵심 | claude auth status | 로그인 상태를 확인합니다. |
| 중요 | claude auth logout | 계정 인증을 해제합니다. |
Claude Code CLI 플래그
핵심 1| 중요도 | 키워드 | 뜻 |
|---|---|---|
| 핵심 | --version, -v | 버전 번호를 확인합니다. |
CLI 하위 명령의 추가 옵션·출력 형식
핵심 1| 중요도 | 키워드 | 뜻 |
|---|---|---|
| 핵심 | --help | 사용법을 표시하며, 하위 명령 뒤에서도 확인할 수 있습니다. |
Claude Code 키보드 단축키
핵심 4 · 중요 3단축키는 대부분 공통이며 일부만 OS별로 다릅니다. Mac에서도 Ctrl은 Command가 아닌 Control 키입니다. 괄호의 적용 조건을 함께 확인합니다.
옆으로 밀면 Windows·Linux 열이 있습니다
| 중요도 | 키워드·설명 | Mac | Windows | Linux |
|---|---|---|---|---|
| 핵심 | Ctrl+D 빈 입력줄에서 두 번 누르면 종료하고, 글이 있으면 다음 글자를 삭제합니다. | Ctrl+D | Ctrl+D | Ctrl+D |
| 핵심 | ↑ / ↓ 또는 Ctrl+P/Ctrl+N 입력 줄을 이동하며, 끝에 도달하면 이전·다음 요청을 불러옵니다. | ↑ / ↓ / Ctrl+P / Ctrl+N | ↑ / ↓ / Ctrl+P / Ctrl+N | ↑ / ↓ / Ctrl+P / Ctrl+N |
| 핵심 | \ + Enter 역슬래시 뒤에서 Enter를 눌러 줄을 바꿉니다. | \ 후 Enter | \ 후 Enter | \ 후 Enter |
| 핵심 | / (맨 앞)Slash commands 명령·스킬 목록을 엽니다. | / | / | / |
| 중요 | Option+Enter Mac에서 Meta 설정 후 Option+Enter로 줄을 바꿉니다. | Option+Enter (Meta 설정 필요) | Ctrl+J (줄바꿈 대안) | Ctrl+J (줄바꿈 대안) |
| 중요 | 여러 줄 붙여넣기Multiline paste 여러 줄의 텍스트를 그대로 붙여 넣습니다. | 여러 줄 붙여넣기 | 여러 줄 붙여넣기 | 여러 줄 붙여넣기 |
| 중요 | ? (빈 입력)Keyboard shortcut help 빈 입력줄에서 단축키 도움말을 표시합니다. | ? | ? | ? |
Mac에서 Option 단축키 쓰기
Option+P・Option+B/F/D/Y・Option+Enter는 Option을 Meta로 설정한 뒤 사용합니다. Apple Terminal은 설정 → 프로필 → 키보드 → “Option 키를 Meta 키로 사용”을 켭니다. iTerm2는 Settings → Profiles → Keys → General에서 두 Option 키를 Esc+로 설정합니다. Option+T는 이 설정이 필요하지 않습니다.
Shift+Enter는 Apple Terminal・iTerm2・Windows Terminal 등에서 기본 지원합니다. VS Code・Cursor 터미널은 /terminal-setup을 한 번 실행합니다. 어디서나 Ctrl+J 또는 \ 후 Enter로 줄을 바꿀 수 있습니다.
공식 문서: 단축키와 대화형 모드 · 터미널 설정
입력 모드·백그라운드·체크포인트
핵심 1| 중요도 | 키워드 | 뜻 |
|---|---|---|
| 핵심 | /명령Slash command | 입력 맨 앞에서 내장 명령·스킬을 호출합니다. |
실행·연결·여러 에이전트
참고 1| 중요도 | 키워드 | 뜻 |
|---|---|---|
| 참고 | 작업 공간Workspace | 도구가 작업 대상으로 삼는 폴더·환경입니다. |
직접 조작
5개 · 핵심 2 · 중요 3말로 요청하지 않고 직접 입력하거나 누르는 조작입니다.
| 중요도 | 조작 | 하는 일 | Mac / Windows |
|---|---|---|---|
| 핵심 | Esc | 진행 중인 응답을 중단합니다. 응답 방향이 어긋나거나 중단이 필요할 때 사용합니다. 이미 발생한 파일 변경·외부 효과를 자동 복구하지는 않습니다. | 같음 |
| 핵심 | Ctrl+C | 작업 실행 중에는 중단합니다. 유휴 상태에서는 첫 입력이 요청문을 지우고 추가로 누르면 세션을 종료합니다. 실행을 중단하거나 유휴 입력을 지울 때 사용하며 현재 실행 상태를 먼저 확인합니다. | 같음 |
| 중요 | /exit상세설명 → | Claude Code 세션을 종료합니다. 필요한 작업 기록과 실행 중인 작업 상태를 확인한 뒤 종료합니다. | 같음 |
| 중요 | /help | 도움말을 봅니다. 현재 환경에서 제공되는 명령과 조작 도움말을 확인합니다. | 같음 |
| 중요 | Tab | 입력창에 자동완성 후보가 표시될 때 선택한 파일명·명령 후보를 입력합니다. 긴 경로·명령을 입력할 때 사용합니다. 권한 질문 화면에서는 댓글 입력 등 다른 동작을 할 수 있습니다. | 같음 |