ASC 에이전트트랙0강 목차
LESSON 00 · 0-2

세 가지를
설치합니다.

전부 복사·붙여넣기와 버튼 클릭으로 끝납니다. 이 장은 Windows 기준으로 쓰고, Mac은 각 장 아래 ▸ For mac을 열면 됩니다.

  1. Git for WindowsWindows에서만 필요한 준비물입니다. (Mac은 건너뜀)
  2. Claude Code터미널에서 도는 코딩 에이전트 본체입니다.
  3. OrcaClaude Code를 편하게 굴리는 무료 오픈소스 작업 환경입니다.
  4. Claude 데스크톱 앱검은 화면이 부담스러울 때 대신 쓰는 창입니다.

요금제는 Pro부터입니다.

무료 플랜으로는 Claude Code가 실행되지 않습니다.

최소 Pro가 있어야 합니다. Max·Team·Enterprise도 됩니다.

실습을 넉넉하게 하려면 Max를 권장합니다.

Pro로도 트랙을 끝까지 따라올 수 있습니다. 다만 긴 작업을 반복하면 사용량 한도에 걸릴 수 있어서, 자주 막히면 그때 Max로 올리시면 됩니다.

터미널·Orca·앱 모두 같은 계정 하나로 씁니다. 따로 가입하거나 결제할 것은 없습니다. Node.js 같은 것도 설치할 필요 없습니다.

① Git for Windows를
설치합니다.

Orca와 Claude 앱의 Code 탭은 Git이 없으면 동작하지 않습니다. 터미널 Claude Code도 Git이 있어야 명령을 제대로 실행합니다. 그래서 Windows는 이것부터 설치합니다.

  1. 아래 버튼으로 설치 파일을 받습니다.64-bit 설치 파일을 고릅니다.
  2. 실행하고 Next만 계속 누릅니다.설정은 전부 기본값 그대로 둡니다.
Git for Windows 받기 →
For mac

Git은 대부분의 Mac에 이미 들어 있습니다. 이 장은 건너뛰어도 됩니다.

혹시 나중에 git 명령이 없다고 나오면 터미널에 아래를 붙여 넣고 뜨는 창에서 설치를 누르면 됩니다.

xcode-select --install

② Claude Code를
설치합니다.

시작 버튼을 누르고 PowerShell이라고 친 뒤 엔터를 눌러 창을 엽니다. 창 왼쪽에 PS C:\>가 보이면 맞게 열린 것입니다. 거기에 아래 한 줄을 붙여 넣습니다.

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

끝나면 창을 닫고 새로 열어서 확인합니다. 버전 숫자가 나오면 된 것입니다.

claude --version
command not found가 나온다면

십중팔구 창을 새로 안 열어서입니다. 닫고 다시 열면 됩니다. irm을 못 알아듣는다면 PowerShell이 아니라 CMD를 연 것이니 PowerShell을 다시 엽니다.

공식 설치 문서
For mac

⌘ + 스페이스를 누르고 터미널이라고 친 뒤 엔터를 눌러 창을 엽니다. 거기에 아래 한 줄을 붙여 넣습니다.

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

끝나면 똑같이 터미널을 닫고 새로 연 뒤 claude --version으로 확인합니다.

Homebrew를 쓰신다면

brew install --cask claude-code

다만 이 방식은 자동 업데이트가 안 되므로, 가끔 brew upgrade claude-code를 직접 실행해야 합니다.

③ Orca를
설치합니다.

Claude Code는 터미널 한 칸에서 한 가지 일만 합니다. Orca는 그 위에 작업 환경을 씌워 주는 무료 오픈소스 앱입니다. 아래 버튼으로 다운로드 페이지를 열고 Windows 10/11 x64 설치 파일을 받아 실행합니다.

Orca 다운로드 →GitHub 저장소
작업마다 폴더가 따로

작업 하나에 폴더 사본(git worktree)이 하나씩 붙습니다. 여러 개를 동시에 돌려도 서로 파일을 망치지 않습니다.

한 창에 다 있음

터미널, 바뀐 코드 비교, 브라우저, 파일 목록이 한 앱 안에 있습니다.

에이전트를 갈아 끼움

Claude Code, Codex, Cursor CLI를 같은 자리에서 씁니다.

Claude Code를 그대로 불러 씀

앞 장에서 설치한 것을 Orca가 찾아 씁니다. 다시 설치하지 않습니다.

For mac

같은 다운로드 페이지에서 Apple Silicon 또는 Intel용 .dmg를 받아 응용 프로그램 폴더로 끌어다 놓습니다. 어느 쪽인지 모르겠으면 사과 메뉴 → 이 Mac에 관하여에서 칩 항목을 봅니다. Apple M…이면 Apple Silicon입니다.

Homebrew를 쓰신다면

brew install --cask stablyai/orca/orca

④ Claude 앱을
설치합니다.

아래 버튼을 누르면 다운로드 페이지가 새 탭으로 열립니다. Windows는 설치 실행 파일, Mac은 .dmg가 받아집니다.

Claude 앱 다운로드 페이지 열기 →
  1. 받은 파일을 실행해 설치합니다.화면 안내를 그대로 따르면 됩니다.
  2. 앱을 열고 로그인합니다.Pro 이상 요금제를 쓰는 그 계정입니다.
  3. 위쪽 Code 탭을 한 번 눌러 봅니다.열리면 끝입니다. Windows에서 안 열리면 ①의 Git for Windows를 확인하고 앱을 껐다 켭니다.

앱은 선택입니다. Orca로 진행할 분은 설치만 해 두고 안 써도 됩니다.

설치 완료 확인

하나라도 안 되면

해당 장으로 돌아가 다시 한 번 그대로 따라 합니다. 그래도 안 되면 실행한 명령과 화면에 나온 문구를 그대로 기수 Discord에 올려 주세요.

다음 장에서 실제로 폴더를 지정하고 첫 파일을 만들어 봅니다.

문제를 확인해 봅니다.

Claude Code를 쓰려면 최소 어떤 요금제가 필요할까요?