Skip to content

1장. 터미널과 Claude Code ​

필수 이 단계를 따라가려면 꼭 읽으세요.

한 줄 요약: 터미널은 글자로 컴퓨터에 일을 시키는 창입니다. 이 강좌는 터미널을 한 번도 안 열어 본 사람이 Claude Code를 설치하고, 마지막에는 명령 한 줄로 주간 메모를 정리하는 데까지 갑니다.[1]

이 강좌의 실행 결과는 리눅스에서 얻었습니다. macOS·Windows에서는 실행하지 않았고, 그 두 곳은 공식 문서를 근거로 썼습니다.

처음부터 완벽할 필요는 없습니다. 코드를 몰라도 괜찮습니다. 원하는 것을 말로 설명하면 됩니다.[2]

터미널이란 ​

터미널(Terminal)은 마우스 대신 글자로 명령을 쳐서 컴퓨터를 다루는 창입니다. 깜빡이는 커서가 있는 까만(또는 하얀) 창을 떠올리면 됩니다.[3]

평소에는 폴더를 더블클릭해서 엽니다. 터미널에서는 "이 폴더로 가"라고 글자로 칩니다. 하는 일은 같고 방법만 다릅니다.

터미널에서는 메뉴를 클릭해 고를 수는 없습니다. 화살표 키로 움직입니다.[4] 처음에는 낯설어도 곧 익숙해집니다. 2장에서 꼭 필요한 명령만 차근차근 익힙니다.

확인 퀴즈

터미널은 무엇을 하는 창인가요?

채팅과 무엇이 다른가 ​

Claude 채팅 창을 써 봤다면 이런 순서가 익숙할 겁니다. 메모를 복사해 붙여 넣습니다. 답을 받습니다. 그 답을 다시 복사해 파일에 옮깁니다.

Claude Code는 터미널에서 도는 에이전트형 도우미입니다.[5] 에이전트(Agent)는 답만 하지 않고 스스로 단계를 밟아 일을 하는 프로그램입니다. 일을 맡기면 맥락을 모으고, 행동하고, 결과를 확인합니다.[6]

같은 일을 나란히 놓고 보면 차이가 보입니다.

채팅 창Claude Code
메모 전달직접 붙여 넣기폴더에서 스스로 읽기
결과글로 된 답답과 파일
뒷정리내가 옮겨 적기Claude가 저장

Claude Code는 필요한 파일을 알아서 읽습니다.[7] 이미 있는 파일을 읽고 정리할 수도 있습니다.[8] 그래서 이렇게 말하면 됩니다.

text
inbox의 회의 메모를 읽고 회의록.md 로 저장해 줘. 답은 한 줄로.

지금 치지 않아도 됩니다. 4장에서 합니다.

파일을 직접 다루기 때문에 조심할 일도 생깁니다. 무엇을 허락할지는 뒤의 장에서 자세히 배웁니다.

확인 퀴즈

회의 메모를 정리할 때, 채팅 창과 비교한 Claude Code의 가장 큰 차이는 무엇인가요?

내 컴퓨터의 터미널 열기 ​

터미널은 컴퓨터에 이미 들어 있습니다. 따로 설치하지 않아도 됩니다. 내 운영체제에 맞는 방법으로 열어 보세요.

  • 맥: Cmd + Space를 눌러 Spotlight 검색을 엽니다. Terminal을 치고 Enter를 누릅니다.[9] 한글 상태라면 터미널이라고 쳐도 됩니다.
  • 리눅스: 대부분 Ctrl + Alt + T를 누르면 열립니다. 안 되면 프로그램 메뉴에서 "터미널"을 찾습니다.[10]
  • Windows: Win + X를 누르고 메뉴에서 Windows PowerShell 또는 터미널(Terminal)을 고릅니다.[11]

Windows에는 PowerShell과 CMD라는 두 가지 창이 있습니다. 쓰는 명령이 달라서 구별해야 합니다. 맨 앞에 PS C:\처럼 PS가 보이면 PowerShell이고, PS 없이 C:\로 시작하면 CMD입니다.[12] 이 강좌의 Windows 명령은 모두 PowerShell 기준입니다.

창이 떴다면 오늘 할 일의 절반은 끝났습니다. 연습이 끝나면 창을 그냥 닫아도 됩니다.

확인 퀴즈

Windows에서 열린 창의 맨 앞에 PS C:\ 처럼 보입니다. 이 창은 무엇인가요?

준비물 ​

필요한 것은 세 가지입니다.

  1. 유료 계정: 무료 claude.ai 요금제에는 Claude Code가 들어 있지 않습니다.[13] Pro, Max 같은 유료 계정이 있어야 합니다.[14]
  2. 맞는 컴퓨터: 맥, Windows, 리눅스 모두 됩니다. 운영체제 버전과 메모리 조건은 아래 상자에 있습니다.
  3. 인터넷 연결: 꼭 필요합니다.[15]
자세히 (눌러서 펼치기)
  • 쓸 수 있는 계정: Pro, Max, Ultra, Team, Enterprise, Console 중 하나입니다.[14:1]
  • 운영체제: 맥은 macOS 13.0 이상, Windows는 Windows 10 1809 이상입니다.[16] 리눅스는 Ubuntu 20.04 이상 등을 지원합니다.[17]
  • 메모리: 4GB 이상이어야 합니다.[15:1]
  • 지역: Anthropic이 지원하는 국가에서만 쓸 수 있습니다.[18]

연습 자료는 이 강좌가 드립니다. 지어낸 카페 메모로 연습하니 내 파일을 건드릴 걱정 없이 시작할 수 있습니다.

확인 퀴즈

Claude Code를 쓰는 데 필요한 계정에 대한 설명으로 맞는 것은 무엇인가요?

이 강좌에서 만들 것 ​

이 강좌에는 줄기가 하나 있습니다. 명령 한 줄로 도는 주간 정리입니다.

작은 카페 「모퉁이 카페」 직원 서연의 메모로 연습합니다. 뒤죽박죽 회의 메모를 폴더에 넣습니다. 스크립트(script, 명령을 순서대로 적어 둔 파일) 하나를 실행합니다. 그러면 메모가 하나씩 회의록으로 정리됩니다.

미리 보고 싶다면 완성된 스크립트와 그 스크립트가 만든 회의록을 열어 보세요. 지금은 무슨 뜻인지 몰라도 됩니다.

이렇게 할 수 있는 이유는 Claude Code에 한 번 답하고 끝나는 실행 방식이 있기 때문입니다.[19] 대화를 주고받지 않습니다. 할 일을 한 줄로 건네면 답한 뒤 스스로 끝납니다. 이 방식은 10장에서 배웁니다.

일이 잘못되면 스크립트가 그 사실을 알아챌 수 있습니다.[20] 그래서 사람이 지켜보지 않아도 되는 일을 맡기기에 좋습니다.

강좌는 이런 순서로 갑니다.

  • 1~5장: 터미널 기초, 설치, 첫 세션, 입력 요령
  • 6~9장: 대화 이어 가기, 허락과 되돌리기, 프로젝트 기억, 스킬
  • 10~13장: 자동화, 훅, 동시 작업, 비용과 문제 해결[21]
  • 14장: 내 메모로 만드는 주간 정리

확인 퀴즈

이 강좌가 끝날 때 만들게 되는 것은 무엇인가요?

앱 가이드와의 관계 ​

터미널 없이 창과 단추로 쓰고 싶은 사람을 위한 데스크톱 앱도 있습니다.[22] 이 사이트의 Claude Code 앱 가이드가 그 앱을 다룹니다.

어느 쪽을 볼지는 이렇게 고르면 됩니다.

  • 터미널이 부담스럽다: 앱 가이드로 가세요. 지금 터미널을 꼭 배워야 하는 것은 아닙니다.
  • 명령 한 줄로 일을 돌리고 싶다: 이 강좌를 계속 읽으세요.

이 강좌는 앱 가이드를 읽지 않았다고 가정합니다. 혼자 따라올 수 있습니다. 앱 가이드와 같은 모퉁이 카페 메모를 쓰니, 이미 읽었다면 내용이 낯익을 겁니다.

확인 퀴즈

터미널이 부담스럽고 창과 단추로 쓰고 싶은 사람은 어떻게 하면 좋을까요?

직접 해 보기 ​

  1. 위 방법으로 내 컴퓨터의 터미널을 엽니다.
  2. 아래 명령을 치고 Enter를 누릅니다.
bash
claude --version

둘 중 하나가 나옵니다. 어느 쪽이든 괜찮습니다.

  • 2.1.318 (Claude Code)처럼 숫자가 나온다: 이미 설치되어 있습니다.[23] 번호는 달라도 됩니다.
  • command not found나 not recognized가 나온다: 아직 찾지 못한다는 뜻입니다.[24] 화면 언어에 따라 한글로 나올 수 있습니다. 뜻은 같습니다. 3장에서 설치합니다. 고장 난 것이 아닙니다.

스스로 물어보세요. 내 컴퓨터의 터미널은 무엇인가? 맥의 터미널, 리눅스의 터미널, Windows의 PowerShell 중 하나로 답할 수 있으면 됩니다.

정리 ​

  • 터미널은 글자로 명령을 쳐서 컴퓨터를 다루는 창이다. 이미 컴퓨터에 들어 있다.
  • Claude Code는 폴더의 파일을 스스로 읽고 만드는 에이전트형 도우미다.
  • 유료 계정이 필요하다. 무료 요금제에는 없다.
  • Windows의 명령은 PowerShell 기준이다. PS가 보이는지 확인한다.
  • 이 강좌의 목표는 명령 한 줄로 도는 주간 정리다. 터미널이 부담스러우면 앱 가이드로 가도 된다.

용어 정리 ​

용어읽는 법한 줄 뜻
Terminal터미널글자로 명령을 쳐서 컴퓨터를 다루는 창
PowerShell파워셸Windows의 터미널 프로그램
CMD씨엠디PowerShell과 명령이 다른 Windows의 옛 명령 창
Agent에이전트스스로 단계를 밟아 일을 하는 프로그램
Script스크립트명령을 순서대로 적어 둔 파일

이 장을 다 읽었나요?

기록은 이 브라우저에만 저장됩니다. 진행 현황은 전체 목차에서 볼 수 있어요.

다음 장: 2장. 터미널 기초

참고 자료 (24개)
  1. 이 강좌는 2026년 11월 6일에 확인한 Claude Code 공식 문서를 바탕으로 썼습니다. 실행 결과는 같은 날 리눅스에서 Claude Code 2.1.318로 실행한 결과입니다. 작성자의 개인 설정이 섞이지 않도록 그 설정을 끄고 돌렸습니다. macOS와 Windows에서는 실행해 보지 않았습니다. 그 두 곳의 내용은 공식 문서를 근거로 썼습니다. 이 안내는 뒤의 장에서 되풀이하지 않습니다. 실행해 보지 않은 기능은 그 자리에서 밝힙니다. ↩︎

  2. Claude Code 공식 문서, 「Terminal guide for new users」. "You don't need to know how to code." code.claude.com (확인일 2026-11-06) ↩︎

  3. Claude Code 공식 문서, 「Terminal guide for new users」. "A window will appear with a blinking cursor. This is your terminal, where you type commands." code.claude.com (확인일 2026-11-06) ↩︎

  4. Claude Code 공식 문서, 「Terminal guide for new users」. "You can't click on things in the terminal. Use the arrow keys to move around." code.claude.com (확인일 2026-11-06) ↩︎

  5. Claude Code 공식 문서, 「How Claude Code works」. "Claude Code is an agentic assistant that runs in your terminal." code.claude.com (확인일 2026-11-06) ↩︎

  6. Claude Code 공식 문서, 「How Claude Code works」. "When you give Claude a task, it works through three phases: gather context, take action, and verify results." code.claude.com (확인일 2026-11-06) ↩︎

  7. Claude Code 공식 문서, 「Quickstart」. "Claude Code reads your project files as needed." code.claude.com (확인일 2026-11-06) ↩︎

  8. Claude Code 공식 문서, 「Terminal guide for new users」. "Claude can read and organize files you already have:" code.claude.com (확인일 2026-11-06) ↩︎

  9. Claude Code 공식 문서, 「Terminal guide for new users」. "Press Cmd + Space to open Spotlight Search, type Terminal, and press Enter." code.claude.com (확인일 2026-11-06) ↩︎

  10. Claude Code 공식 문서, 「Terminal guide for new users」. "On most distributions, press Ctrl + Alt + T or search for "Terminal" in your application menu." code.claude.com (확인일 2026-11-06) ↩︎

  11. Claude Code 공식 문서, 「Terminal guide for new users」. "Press Win + X and select Windows PowerShell (or Terminal) from the menu." code.claude.com (확인일 2026-11-06) ↩︎

  12. Claude Code 공식 문서, 「Quickstart」. "On Windows, your prompt shows PS C:\ when you're in PowerShell and C:\ without the PS when you're in CMD." code.claude.com (확인일 2026-11-06) ↩︎

  13. Claude Code 공식 문서, 「Advanced setup」. "The free claude.ai plan does not include Claude Code access." code.claude.com (확인일 2026-11-06) ↩︎

  14. Claude Code 공식 문서, 「Advanced setup」. "Claude Code requires a Pro, Max, Ultra, Team, Enterprise, or Console account." code.claude.com (확인일 2026-11-06) ↩︎

  15. Claude Code 공식 문서, 「Advanced setup」. "4 GB+ RAM, x64 or ARM64 processor" / "internet connection required" code.claude.com (확인일 2026-11-06) ↩︎

  16. Claude Code 공식 문서, 「Advanced setup」. "macOS 13.0+" / "Windows 10 1809+ or Windows Server 2019+" code.claude.com (확인일 2026-11-06) ↩︎

  17. Claude Code 공식 문서, 「Advanced setup」. "Ubuntu 20.04+" code.claude.com (확인일 2026-11-06) ↩︎

  18. Claude Code 공식 문서, 「Advanced setup」. "Anthropic supported countries" code.claude.com (확인일 2026-11-06) ↩︎

  19. Claude Code 공식 문서, 「Quickstart」. "Run one-off query, then exit" code.claude.com (확인일 2026-11-06) ↩︎

  20. Claude Code 공식 문서, 「Run Claude Code programmatically」. "Claude Code exits with code 0 on success and a non-zero code when the run fails, so your scripts can branch on the exit status." code.claude.com (확인일 2026-11-06) ↩︎

  21. 이 강좌의 스크립트는 맥·리눅스의 bash(배시) 기준입니다. bash는 셸(터미널에서 명령을 알아듣는 프로그램)의 한 종류입니다. 맥의 기본 셸은 zsh지만, 이 강좌는 스크립트를 bash 파일이름처럼 bash로 돌립니다. Windows PowerShell에서는 그대로 돌지 않습니다. Windows는 저장한 파일 대신 블록을 붙여 넣어 돌립니다. 10장에서 다시 짚습니다. ↩︎

  22. Claude Code 공식 문서, 「Advanced setup」. "Prefer a graphical interface?" code.claude.com (확인일 2026-11-06) ↩︎

  23. Claude Code 공식 문서, 「Advanced setup」. "A working installation prints a version number such as 2.1.211 (Claude Code)." code.claude.com (확인일 2026-11-06) ↩︎

  24. Claude Code 공식 문서, 「Troubleshoot installation and login」. "If installation succeeded but you get a command not found or not recognized error when running claude, the install directory isn't in your PATH." code.claude.com (확인일 2026-11-06) ↩︎