1. Claude Code 설치하고 시작하기

1. Claude Code 설치하고 시작하기

처음이라도 괜찮습니다. 천천히 따라오세요.

Claude Code가 뭔가요?

한 줄로 설명하면, AI와 대화하면서 내 컴퓨터에서 일을 시키는 도구입니다.

‘이 폴더에 어떤 자료가 있어?’라고 물으면 파일을 찾아보고, ‘이 자료에서 할 일을 정리해줘’라고 하면 필요한 내용을 읽고 결과를 만듭니다. 어떻게 하면 좋을지 설명을 듣는 데서 끝나는 게 아니라, 파일을 읽고 수정하거나 프로그램을 실행하는 데까지 이어집니다.

웹에서 쓰는 AI도 파일이나 외부 도구와 연결할 수 있습니다. 제가 여기서 보여드리려는 건, 제 컴퓨터에 있는 업무 자료를 놓고 AI와 직접 일하는 방식입니다. 앞 글에서 이야기한 환경을 이제 자기 컴퓨터에서 시작해보겠습니다.

오늘은 설치하고, 작업할 폴더를 열고, 한국어로 첫 대화를 하는 데까지 갑니다. 다운로드 폴더를 실제로 정리하는 건 다음 글에서 해보겠습니다.

시작하기 전에

두 가지 프로그램을 사용합니다.

프로그램 하는 일
Claude Code AI와 대화하고, 파일을 읽거나 작업을 실행합니다.
Orca 작업 폴더와 파일, Claude Code가 실행되는 터미널을 함께 보는 앱입니다.

저는 요즘 Orca를 사용합니다. 여러 작업을 나란히 보거나, AI가 만든 HTML과 PDF를 같은 창에서 확인하기 편합니다. 휴대폰에서 이어서 쓸 수 있다는 점도 큰 이유입니다. 지금은 컴퓨터에서 시작하고, 모바일 연결은 뒤로 미루겠습니다.

터미널이 처음인 분은 이렇게 생각하면 됩니다. 글자로 프로그램을 실행하고, 그 결과를 보는 창입니다. 그 안에서 명령을 받아 처리하는 프로그램을 ‘셸’이라고 합니다. Mac에서는 보통 Zsh, 이 글의 Windows 실습에서는 PowerShell을 씁니다.

터미널에 claude를 입력하면 Claude Code가 시작됩니다. 그다음부터는 그 안에서 AI와 대화합니다. 같은 창이어도 처음에는 프로그램을 실행하는 명령을, 실행한 뒤에는 하고 싶은 일을 입력하는 겁니다.

사용할 계정

개인 계정으로 따라오는 분은 Claude Pro 또는 Max 구독을 준비하세요. 무료 Claude 계정만으로는 Claude Code를 사용할 수 없습니다.

회사에서 제공하는 Team·Enterprise 계정이나, 사용량에 따라 별도로 과금하는 Console 계정으로도 이용할 수 있습니다. 회사 계정은 관리자가 안내한 방법을 따르세요. 개인 구독과 Console의 API 사용료는 별개이므로, 구독으로 사용하려면 로그인할 때 구독한 Claude 계정을 선택하면 됩니다. 공식 계정 안내

내 컴퓨터에 맞게 설치합니다

아래에서 자기 컴퓨터에 해당하는 부분만 읽으면 됩니다. 이미 설치한 분은 설치 명령을 다시 실행할 필요 없이 버전 확인부터 해보세요.

Claude Code는 macOS 13 이상, Windows 10 버전 1809 이상에서 사용할 수 있습니다. 메모리 4GB 이상과 인터넷 연결이 필요합니다. 공식 사용 환경

Mac 설치

1. 터미널을 엽니다.

Command + Space를 누르고 ‘터미널’을 검색한 뒤 Enter를 누릅니다. 글자를 입력할 수 있는 창이 열립니다.

2. 아래 한 줄을 붙여넣고 Enter를 누릅니다.

curl -fsSL https://claude.ai/install.sh | bash

이건 AI에게 하는 말이 아니라 컴퓨터에 Claude Code를 설치하는 명령입니다. curl이 공식 주소에서 설치 내용을 가져오고, 가운데 |가 그 내용을 bash로 넘겨 실행합니다.

다운로드 중에는 진행 상황이 표시되지 않을 수 있습니다. 창을 닫지 말고 설치 완료 안내를 기다리세요.

3. 터미널을 닫고 새로 연 뒤 확인합니다.

claude --version

버전 번호와 Claude Code가 나오면 설치된 것입니다. 숫자는 글을 읽는 시점에 따라 달라도 괜찮습니다. 공식 설치 안내

Windows 설치

1. PowerShell을 엽니다.

시작 메뉴에서 ‘PowerShell’을 검색해 엽니다. 관리자 권한으로 실행할 필요는 없습니다. 입력 줄 앞에 PS가 표시되는지 확인하세요. CMD라는 다른 프로그램에서는 아래 명령을 그대로 쓸 수 없습니다.

2. 아래 한 줄을 붙여넣고 Enter를 누릅니다.

irm https://claude.ai/install.ps1 | iex

irm이 공식 주소에서 설치 내용을 가져오고, iex가 실행합니다. Mac 설치와 목적은 같고, PowerShell의 문법을 사용하는 겁니다. 설치 완료 안내가 나올 때까지 기다립니다.

3. PowerShell을 닫고 새로 연 뒤 확인합니다.

claude --version

버전 번호와 Claude Code가 나오면 다음으로 넘어갑니다.

Git for Windows를 먼저 설치할 필요는 없습니다. 현재 Claude Code는 Git for Windows가 없으면 PowerShell을 사용해 명령을 실행할 수 있습니다. 이번에는 Windows에 직접 설치하는 방법으로 진행합니다. 공식 Windows 안내

Orca를 설치합니다

Orca 공식 다운로드 페이지에서 자기 컴퓨터에 맞는 설치 파일을 받습니다.

  • Mac: Apple Silicon과 Intel이 나뉩니다. Apple 메뉴의 ‘이 Mac에 관하여’에서 칩을 확인하세요. Apple M 시리즈면 Apple Silicon입니다. 내려받은 파일을 열고 Orca를 응용 프로그램 폴더에 넣어 실행합니다.
  • Windows: Windows 설치 파일을 받아 실행하고 설치를 마칩니다.

처음 열 때 홈 폴더 접근 권한을 요청하거나, 기존 Claude Code 설정을 가져올지 물을 수 있습니다. 사용할 폴더를 확인하고 진행하세요. 처음 사용하는 분은 가져올 설정 없이 시작하면 됩니다.

이제 Claude Code와 Orca가 설치됐습니다. 다음부터는 Orca 안에서 Claude Code를 실행하겠습니다.

작업할 폴더를 엽니다

먼저 Finder나 파일 탐색기에서 문서 폴더 안에 claude-work라는 새 폴더를 하나 만듭니다. 실습할 공간입니다. 이름을 꼭 똑같이 할 필요는 없습니다.

Orca에서 폴더를 선택하는 순서는 다음과 같습니다. 메뉴 이름은 영문 기준이며 버전에 따라 위치나 표현이 달라질 수 있습니다.

  1. 프로젝트를 추가하는 화면인 Add a project를 엽니다.
  2. Browse folder를 눌러 방금 만든 폴더를 선택합니다.
  3. Git 저장소가 아니라는 안내가 나오면 Open as Folder를 선택합니다.

일반 폴더로 열어도 파일을 보고 터미널을 쓸 수 있습니다. 이 단계에서 Git 저장소를 만들거나 GitHub 계정을 연결할 필요는 없습니다. Orca의 폴더 열기 구현

선택한 폴더에서 탭 표시줄의 + 메뉴로 일반 터미널을 엽니다. Mac에서는 Command + T로 새 터미널을 열 수도 있습니다. Windows는 PowerShell을 선택하세요. 다른 셸로 열린다면 Settings → Terminal에서 기본 셸을 PowerShell로 정하고 새 터미널을 엽니다. Orca 터미널 안내

이제 폴더와 파일을 보면서, 같은 환경에서 Claude Code와 대화할 준비가 됐습니다. 앞으로 AI가 만든 결과도 여기서 확인할 겁니다.

선택한 폴더는 일을 시작할 기준 위치입니다. 폴더를 열었다고 모든 파일 내용이 한꺼번에 AI에게 읽히는 건 아닙니다. 요청에 필요한 파일을 찾아 읽게 됩니다. 다른 위치의 자료를 다루는 데에는 접근 범위와 권한도 관계가 있습니다. 시작 위치와 접근 권한은 구별하면 됩니다. 작업 폴더와 권한

처음 실행해봅니다

1. Orca의 터미널에 입력합니다.

claude

Enter를 누르면 Claude Code가 시작됩니다.

2. 로그인 안내를 따릅니다.

처음 실행하면 로그인과 초기 설정 안내가 나옵니다. 개인 구독으로 진행하는 분은 구독한 Claude 계정을 선택하고, 브라우저에서 로그인을 마친 뒤 터미널로 돌아옵니다. 브라우저가 자동으로 열리지 않으면 화면에 나온 로그인 주소를 열고 안내를 따르면 됩니다. 이미 로그인한 컴퓨터에서는 이 과정이 생략될 수 있습니다. 공식 첫 실행 안내

작업 폴더를 신뢰하는지 묻는 화면이 나오면 방금 선택한 폴더가 맞는지 확인하고 진행합니다. 다른 폴더가 보인다면 종료하고 Orca에서 선택한 폴더를 다시 확인하세요.

3. 한국어로 말을 걸어봅니다.

Claude Code의 대화 입력란이 보이면 이렇게 입력합니다.

안녕! 앞으로 여기서 업무를 함께 하려고 해. 한국어로 답해줘.
현재 폴더에 어떤 파일이 있는지 확인해서 알려줘. 아직 파일을 바꾸지는 마.

이건 실행 명령이 아니라 시작된 Claude Code 안에서 AI에게 하는 요청입니다. Enter를 눌러 보냅니다. 방금 빈 폴더를 만들었다면 파일이 없다는 답이 나와도 정상입니다. 답변 문장이 예시와 같을 필요는 없습니다. 선택한 폴더를 살펴본 결과인지 확인하세요.

이렇게 평범한 한국어로 대화하면 됩니다. 어떤 명령으로 파일을 찾는지 미리 외울 필요는 없습니다. 무엇이 필요한지 설명하고, AI가 확인한 결과를 보면 됩니다.

작업 중 멈추고 싶으면 Esc를 누릅니다. 끝내고 터미널로 돌아가려면 대화 입력란에 exit를 입력합니다. 다시 시작할 때는 같은 폴더의 터미널에서 claude를 실행하면 됩니다. 기본 사용법

권한을 물어보면

파일을 바꾸거나 명령을 실행할 때 허용 여부를 물을 수 있습니다. 무엇을 하려는지와 대상이 맞는지 읽고 결정하세요.

다만 모든 작업에서 매번 묻는 것은 아닙니다. 읽기 작업이나 이미 허용한 작업, 선택한 권한 모드에 따라 확인 방식이 달라집니다. AI에게 ‘바꾸기 전에 물어봐’라고 말하는 것과 프로그램의 권한 설정을 바꾸는 것도 다릅니다. 요청은 작업 방향을 정하고, 실제 도구 사용은 권한 설정을 따릅니다. 공식 권한 안내

잘 안 될 때

claude를 찾을 수 없다는 메시지가 나오면 우선 터미널을 닫고 새로 열어봅니다. 기본 터미널에서는 되는데 Orca에서만 안 된다면 Orca도 완전히 종료했다가 다시 엽니다.

그래도 안 되면 설치 위치를 터미널이 찾지 못하는 문제일 수 있습니다. 이때 확인하는 것이 PATH, 프로그램을 찾을 위치의 목록입니다. 공식 터미널 문제 해결 안내에서 자신의 운영체제와 오류에 맞는 항목을 확인하세요. 원인을 확인하기 전에 같은 설치나 설정 추가를 반복할 필요는 없습니다.

더 자세한 설치 상태가 필요하면 Claude Code를 종료한 뒤, 셸에서 다음 명령으로 진단할 수 있습니다.

claude doctor

설치와 설정의 상태, 경고와 해결 안내가 나옵니다. 특정 성공 문구 하나를 찾는 것보다 표시된 문제를 확인하는 용도입니다. 로그인 뒤 사용 권한 안내가 나온다면 구독한 계정이 맞는지, 회사 계정이면 Claude Code 사용 권한이 있는지 확인합니다.

이 글의 설치 방식은 기본적으로 자동 업데이트됩니다. 직접 업데이트하려면 셸에서 claude update를 실행할 수도 있습니다. 설치 진단과 업데이트

다음에는 실제 일을 맡겨봅니다

여기까지 왔다면 세 가지를 확인할 수 있습니다.

  • claude --version을 입력하면 버전이 나옵니다.
  • Orca에서 작업 폴더를 열고 Claude Code를 실행할 수 있습니다.
  • 한국어로 요청하면 선택한 폴더를 살펴보고 답합니다.

Claude Code를 쓰기 위해 코딩부터 배울 필요는 없습니다. 하고 싶은 일을 설명하고, AI가 한 일을 확인하면서 자기 방식으로 만들어가면 됩니다.

다음 글에서는 다운로드 폴더를 정리해보겠습니다. AI가 폴더를 살펴보고 정리 방법을 제안하면, 내 기준을 이야기하고 실제로 정리하게 한 뒤 결과를 확인할 겁니다. AI가 내 컴퓨터에서 직접 일한다는 것을 경험해보겠습니다.

Subscribe to 비개발자를 위한 Claude Code | 일을 잘하기 위한 AI Workspace

Don’t miss out on the latest issues. Sign up now to get access to the library of members-only issues.
[email protected]
Subscribe