AI 에이전트 입문기: 맥미니에 클로드 코드 설치

맥미니를 활용한 클로드 코드 설치

지난 글에서 리눅스 환경에 Claude Code를 설치하는 과정을 정리했습니다. nvm으로 Node.js를 깔고, API 키를 발급받고, 터미널에서 claude를 실행하기까지. 엔진부터 체크하는 기초 공사의 이야기였죠.

드디어 맥미니가 왔습니다. 심플한 자태가 깔끔합니다. 손바닥만 한 은색 몸체, 그리고 전원 코드. 그게 전부입니다. 집에서는 "컴퓨터 샀다며, 모니터는 없어?" 하고 물어봅니다.

그런데 정말 집에 모니터가 없었습니다. 일단 급한대로 거실 TV에 HDMI를 연결했습니다. 화면이 켜지더니 "안녕하세요"를 여러 외국어로 돌아가며 보여주고 있습니다. 맥의 초기 설정 화면이었죠. 자, 이제 키보드와 마우스를 연결하라고 합니다. 생각해 보니 집에 키보드와 마우스도 없습니다. 노트북만 써온 지 몇 년인데, 당연히 없죠. 결국 울며 겨자먹기로 맥미니를 들고 연구실로 왔습니다. 연구실 모니터에 연결하고, 키보드와 마우스를 꽂았습니다.

마지막으로 맥을 쓴 것은 10년 전, 미국 유학 시절이었습니다. 한국에서 와서는 다시 윈도우가 편해서 윈도우를 쓰다가 오랜만에 쓰려니 기억이 잘 안 나네요. 클로드 깔건데 클로드한테 물어보는게 어색해서 제미나이를 열었습니다.

"맥미니 왔어. 클로드 코드 쓸 거야."

Homebrew 설치

지난 글에서 리눅스 환경의 엔진은 nvm이었습니다. 맥에서는 Homebrew가 그 역할을 합니다. 맥 생태계의 만능 패키지 관리자인데, 이것 하나로 Node.js, Git, 파이썬까지 전부 설치할 수 있죠.

먼저 터미널을 열어야 합니다. Command(⌘) + Space를 누르면 스포트라이트 검색창이 뜨는데, 'Terminal'이라고 치고 엔터를 누르세요. 윈도우에서 Win 키를 누르고 'cmd'를 검색하는 것과 같은 원리입니다. Homebrew 설치를 위해 터미널이 열리면 아래 한 줄을 복사해서 붙여넣고 엔터.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

설치 중에 맥 로그인 비밀번호를 물어보는데, 타이핑해도 화면에 아무 글자도 안 뜹니다. 보안상 원래 그런 거니까, 당황하지 마시고 비밀번호를 끝까지 치고 엔터를 누르세요. 중간에

Press RETURN to continue 가 나오면 엔터 한 번 더.

Homebrew 설치완료

설치가 끝나면 화면 하단에 Next steps라는 안내가 뜹니다. 여기가 핵심입니다. 이걸 안 하면 터미널이

brew 명령어를 인식하지 못합니다. 리눅스에서 nvm 설치 후에 source ~/.bashrc 를 해줬던 것과 같은 이치죠. 안내에 나온 명령어를 한 줄씩 실행해 주세요. 보통 이런 형태입니다.

echo >> /Users/사용자이름/.zprofile

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/사용자이름/.zprofile

eval "$(/opt/homebrew/bin/brew shellenv)"

사용자 이름 부분은 본인 것으로 바뀌어 있을 테니, 화면에 뜬 그대로 복사하시면 됩니다. 확인은

brew --version을 쳐서 버전 번호가 나오면 성공.

Node.js와 Claude Code 설치

리눅스에서는 nvm install 20 이었다면, 맥에서는 이렇게 합니다.

brew install node

한 줄이면 끝입니다. node -v를 쳐서 v18 이상이 나오면 완료. Git도 이 김에 같이 깔아두세요. 나중에 프로젝트 관리할 때 어차피 필요합니다.

brew install git

Node.js 설치 완료

그리고 드디어 본론입니다. 이 명령어는 리눅스든 맥이든 동일합니다.

npm install -g @anthropic-ai/claude-code

설치가 끝나면 2 packages are looking for funding이라는 메시지가 뜰 수 있는데, 에러가 아니라 오픈소스 후원 안내일 뿐이니 무시하셔도 됩니다.

설치가 완료되면 터미널에 그냥 딱 한 단어만 치면 됩니다.

claude

처음 실행하면 테마 선택 화면이 나옵니다. Dark mode가 기본값이니 그냥 엔터를 누르세요.

지난 글에서 인증 방식을 두 가지 소개했었죠. API Key 방식(종량제)과 OAuth 방식(구독제). 맥미니를 개인 작업용으로 쓴다면 OAuth 방식이 훨씬 편합니다. 브라우저가 자동으로 열리면 Claude.ai 계정으로 로그인하고 승인(Authorize)을 누르시면 됩니다. API 키를 복사해서 환경 변수에 넣는 번거로움이 없죠.

보안 확인에서 "Yes, I trust this folder"를 선택하면 세팅 끝.

Welcome to Claude Code

클로드 코드가 작동하기 시작했습니다.

자 이제부터가 시작입니다. 다양한 에이전트를 만들어서 일을 시켜볼 생각입니다. 우리 다 같이 차근차근 나아가 봅시다.

클로드 코드 시작