Mac 유저 환경 준비 가이드 (Mac)
맥 쓰시는 분들 반갑습니다. 결론부터 말씀드리면, 맥은 윈도우보다 설치가 훨씬 짧습니다. 윈도우 수강생은 PowerShell 7도 깔고 WSL(윈도우 안의 리눅스)도 따로 깔아야 하지만, 맥은 태생이 유닉스 계열이라 리눅스 환경이 이미 안에 들어 있거든요. 그래서 맥은 이 가이드 하나로 설치가 끝납니다.
이 가이드는 깨끗한 맥(macOS 26 기준)에서 직접 한 줄씩 실행해 확인한 내용입니다. 복사·붙여넣기로 차근차근 따라오시면 됩니다.
🍎 맥 사용자 수강 경로. 강의의 1.7 PowerShell 7, 1.10 WSL 유닛은 맥에 필요 없으니 건너뛰세요. 1.8 Wave·1.9 Docker도 윈도우 화면으로 찍혀 있으니, 그 대신 이 가이드를 따라 설치하시면 됩니다. 설치가 끝나면 강의 1.11 Codex CLI부터 윈도우 수강생과 똑같이 이어가시면 됩니다.
💡 이 가이드에서 만드는 것은 Xcode 개발도구 · Homebrew · Git · GitHub CLI · Wave Terminal(한글 패치) · Docker Desktop 입니다.
시작 전, 내 맥 칩 확인하기
화면 왼쪽 위 사과 메뉴() → 이 Mac에 관하여를 열어 칩을 확인하세요.
- Apple 실리콘(M1·M2·M3·M4). 대부분 여기 해당합니다. 이 가이드 명령어 그대로 진행하시면 됩니다.
- Intel. 명령어는 동일하고, Homebrew가 깔리는 위치만 다릅니다(
/usr/local). 화면에 다를 수 있는 부분은 따로 짚어드릴게요.
---
1단계. Xcode Command Line Tools 확인
맥에서 개발 도구의 기반이 되는 게 Xcode Command Line Tools(줄여서 CLT) 입니다. Git을 포함한 여러 도구가 이 위에서 동작합니다.
재미있는 점이 하나 있는데요. 맥에는 git 명령이 이미 있는 것처럼 보입니다. 하지만 CLT가 깔려 있지 않으면 그건 껍데기(스텁) 라서, 처음 git을 실행하면 "설치하겠냐"는 팝업이 뜹니다.
먼저 CLT가 깔려 있는지 확인합니다. 터미널(또는 Wave)을 열고 아래를 실행합니다.
xcode-select -p
✅ 이미 준비된 상태
아래 둘 중 하나가 나오면 정상입니다.
/Library/Developer/CommandLineTools
또는
/Applications/Xcode.app/Contents/Developer
- 첫 번째는 CLT만 설치된 상태
- 두 번째는 Xcode가 설치되어 있고 그 안의 개발 도구를 사용하는 상태
둘 다 문제없으므로 다음 단계로 넘어가면 됩니다.
\
❌ 아직 설치되지 않은 상태
아래와 비슷한 메시지가 나오면 CLT가 설치되지 않은 것입니다.
unable to find utility ...
또는
xcode-select: error ...
이 경우 아래 명령으로 설치합니다.
xcode-select --install
설치 창이 뜨면 Install(설치) 을 누르고 완료될 때까지 기다리면 됩니다.(몇 분 소요).
💡 이것도 알아두세요. 다음 단계인 Homebrew 설치 스크립트가 CLT가 없으면 알아서 함께 설치해 줍니다. 그래서 1단계를 건너뛰어도 결과적으로는 깔립니다. 다만 "맥 개발의 기반은 CLT"라는 걸 알고 가는 게 좋아서 먼저 짚었습니다.
---
2단계. Homebrew 설치 (맥용 앱 설치 도구)
Homebrew는 맥에서 명령어 한 줄로 프로그램을 깔아주는 패키지 매니저입니다. 윈도우의 winget이나 Microsoft 스토어 역할을, 맥에서는 Homebrew 하나가 담당한다고 보시면 됩니다.
공식 설치 명령을 그대로 붙여넣습니다(터미널 한 줄).
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
설치 중에 이런 것들이 지나갑니다. 당황하지 마세요.
Checking for sudo access. 맥 로그인 비밀번호를 입력합니다. (보안상 화면에 글자가 안 보이는 게 정상입니다. 그냥 치고 엔터)Press RETURN/ENTER to continue. 엔터를 누릅니다.- CLT가 없던 분은 여기서
The Xcode Command Line Tools will be installed가 뜨고 자동으로 함께 설치됩니다. - 마지막에
Installation successful!가 보이면 성공입니다.
### PATH 등록 (이걸 해야 brew 명령이 먹습니다)
설치가 끝나면 화면 맨 아래 Next steps 에 안내가 나옵니다. 그대로 따라 아래 세 줄을 실행하세요(Apple 실리콘 기준).
echo >> ~/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
이제 잘 깔렸는지 확인합니다.
brew --version
Homebrew 5.x.x 처럼 버전이 나오면 완료입니다.
⚠️ Intel 맥 사용자. 위 세 줄에서 경로만
/opt/homebrew대신/usr/local로 바뀝니다. 설치가 끝나면 화면의 Next steps 안내가 본인 맥에 맞는 경로를 그대로 알려주니, 그대로 복사해 쓰시면 됩니다.
3단계. Git · GitHub CLI 설치
이제 Homebrew로 Git과 GitHub CLI를 한 번에 깝니다. (Git이 왜 필요한지, GitHub이 무엇인지는 강의 1.5·1.6에서 다뤘습니다. 여기서는 맥 설치 방법만 짚습니다.)
brew install git gh
확인합니다.
git --version
gh --version
💡 알아두면 좋은 점. 맥에는 원래 CLT가 제공하는
git(예: 2.50)이 있는데, Homebrew로 깐 최신git(예: 2.54)이 그 앞 순서를 차지하게 됩니다. 그래서git --version이 더 높은 버전으로 나오면 정상입니다.
Git 사용자 정보 등록과 GitHub 로그인
git config --global user.name "본인 이름"
git config --global user.email "본인 GitHub 이메일"
gh auth login
gh auth login 은 몇 가지를 물어봅니다. GitHub.com, HTTPS, 브라우저로 로그인 순서로 선택하시면, 브라우저가 열리고 한 번 클릭으로 인증이 끝납니다.
---
4단계. Wave Terminal 설치 (⚠️ 한글 패치 빌드)
Wave Terminal은 한 화면에 여러 패널을 띄워 에이전트와 일하기 좋은 터미널입니다(자세한 소개는 강의 1.8 참고).
⚠️ 중요. 공식 빌드 말고 단테 패치 빌드를 받으세요. 터미널에서
brew install --cask wave로 깔리는 공식 빌드는 한글 입력(IME)이 깨집니다. 단테가 직접 한글 입력을 고친 패치 빌드를 받으셔야 합니다. 그 외 기능은 공식과 완전히 동일합니다.
다운로드 (수강생 전용 패치 빌드)
👉 https://github.com/dandacompany/waveterm/releases/tag/v0.14.6
릴리즈 페이지 아래 Assets 에서 본인 맥에 맞는 파일을 받습니다.
- Apple 실리콘(M1~M4)은 파일명에
darwin-arm64가 들어간.dmg를 받습니다 (예:Wave-darwin-arm64-0.14.5.dmg). - Intel 맥은 파일명에
x64가 들어간 자산을 받습니다. - 받은
.dmg를 더블 클릭해 열고, 안의 Wave 앱을 Applications 폴더로 드래그합니다.
⚠️ 터미널
cp명령으로 복사하지 마세요.cp -R로 Applications에 복사하면 앱 서명 봉인이 깨져서"a sealed resource is missing or invalid"오류로 실행이 안 됩니다. 반드시 Finder에서 드래그로 옮기세요(드래그는 서명을 그대로 보존합니다).
💡 "확인되지 않은 개발자" 경고가 안 떠요. 이 패치 빌드는 Apple 공증(notarization)이 완료돼 있어서, 드래그 후 바로 실행됩니다. 별도 우회가 필요 없습니다. (혹시 이전에 깐 Wave가 있다면,
/Applications에서 기존Wave.app을 휴지통으로 옮기고 새로 설치하세요.)
---
5단계. Docker Desktop 설치
Docker는 내 컴퓨터 안에 작은 격리 환경을 만들어, 에이전트 프로젝트끼리 설정이 엉키지 않게 해줍니다(자세한 소개는 강의 1.9 참고). 맥은 WSL 연동 같은 단계가 없습니다.
brew install --cask docker-desktop
⚠️ cask 이름이
docker-desktop입니다. 예전docker가 아니니 주의하세요.
설치가 끝나면 Docker Desktop을 한 번 실행해 초기 설정(서비스 약관 동의)을 마칩니다.
open -a Docker
처음 실행하면 약관 동의 화면이 나옵니다. 동의하고 로그인은 건너뛰어도 됩니다. 잠시 뒤 메뉴 막대에 고래 아이콘이 자리잡으면 준비 완료입니다. 터미널에서 확인합니다.
docker --version
docker run hello-world
Hello from Docker! 메시지가 나오면 정상입니다.
💡 처음
docker명령이 한 번 막힐 수 있어요. 맥 보안(Gatekeeper)이 새로 깐 명령을 처음 한 번 검사하면서 막는 경우가 있습니다. 잠시 뒤 다시 실행하면 정상 동작합니다.
---
마무리, 윈도우 수강생과 같은 출발선
여기까지 오셨으면 맥에도 Git · GitHub · Wave 터미널 · Docker가 모두 준비됐습니다. 이제부터는 OS와 상관없이 명령어가 똑같습니다. 강의 1.11 Codex CLI 유닛으로 이어가시면 됩니다.
자주 묻는 질문
Q. git 을 쳤더니 "설치하겠냐"는 팝업이 떠요.정상입니다. CLT가 아직 없다는 뜻이에요. 팝업에서 설치하거나, 2단계 Homebrew를 설치하면 함께 깔립니다.
Q. Wave를 깔았는데 실행이 안 되고 아무 창도 안 떠요.터미널 cp 로 복사하면 서명이 깨져 이 증상이 납니다. /Applications 의 Wave를 지우고, DMG에서 Finder 드래그로 다시 옮겨주세요. 그래도 안 되면 수강생 전용 최신 빌드(이 가이드 링크)인지 확인하세요.
Q. Intel 맥인데 명령어가 달라야 하나요? 명령어는 같습니다. Homebrew 경로만 /usr/local 로 다르고, 그 경로는 설치 후 화면 안내(Next steps)가 그대로 알려줍니다.
Q. docker run hello-world 가 가상화 관련 오류로 안 돼요.실제 맥에서는 정상 동작합니다. 만약 가상머신(VM) 안의 맥에서 시도하면 "CPU has no virtualization support" 가 뜰 수 있는데, 이는 가상머신의 한계일 뿐 본인 맥에서는 문제되지 않습니다.
진행하시다가 막히는 부분이 생기면 언제든 인프런 Q&A에 질문 남겨주세요.