오픈클로 설치, 당신만 실패하는 게 아닙니다(에러코드 별 해결방법)

오늘 아침에도 딸아이 등원시키고 겨우 커피 한 잔 내려서 책상 앞에 앉아 오픈클로 설치하다가 터미널이 빨간색으로 도배됐어요… 그래도 저는 조금 더 익숙하지만.. 일반인 분들께서는 특히 ImportError: No module named... 같은 메시지를 마주하면 멘탈이 나갈 수밖에 없거든요. 12년 동안 코드 치면서 에러 로그만 수만 번 본 제가, 여러분의 맥미니를 살려낼 ‘에러 코드별 처방전’을 가져왔습니다.

• ModuleNotFoundError: 파이썬 경로가 꼬였을 때 나타나는 가장 흔한 증상입니다.
• Permission denied (OS Error 1): 맥의 보안 시스템이 AI의 손발을 묶어버린 상태죠.
• 401 Unauthorized: 클로드 API 키가 잘못됐거나 돈(?)을 안 냈을 때 뜨는 비정한 코드입니다.

터미널에 이 코드가 떴다면?

처음엔 저도 “오, 나도 이제 자비스 오너!”라며 가볍게 터미널을 열었습니다. 그런데 python main.py를 입력하자마자 ModuleNotFoundError: No module named 'anthropic'이라는 문구가 절 반기더군요.

알고 보니 이건 우리가 코딩을 몰라서가 아니라, 컴퓨터에게 “이 라이브러리 써!”라고 제대로 말을 안 해줘서 생기는 문제였습니다. 12년 차 짬밥으로 가장 많이 발생하는 에러 3인방을 정리해 드릴게요.

에러 로그별 즉시 해결법

1. ModuleNotFoundError: No module named...

이건 오픈클로가 돌아갈 ‘재료’가 없다는 뜻입니다.

• 왜 떴을까? pip install -r requirements.txt를 건너뛰었거나, 가상환경(venv) 밖에서 실행했을 때 발생합니다.
• 해결법: 터미널에 source venv/bin/activate를 먼저 치고, 그다음에 실행해 보세요. (이거 하나로 해결되는 경우가 80%입니다!)

2. PermissionError: [Errno 1] Operation not permitted

맥(macOS)이 “어딜 감히 내 파일을 뒤져!”라며 오픈클로를 막아선 겁니다.

• 왜 떴을까? 전체 디스크 접근 권한이 없어서 그렇습니다.
• 해결법: 시스템 설정 > 개인정보 보호 및 보안 > 전체 디스크 접근 권한에서 터미널(Terminal)을 켜주세요. (이거 안 하면 AI가 메일도 못 읽고 바보가 됩니다..ㅎㅎ)

3. anthropic.AuthenticationError: 401 Unauthorized

가장 슬픈 에러죠. 클로드(Claude)가 “님 누구세요?”라고 묻는 겁니다.

• 왜 떴을까? .env 파일에 API 키를 잘못 넣었거나, 앤스로픽 계정에 카드 등록을 안 해서 잔액이 0원일 때 뜹니다.
• 해결법: 앤스로픽 대시보드에서 $5라도 충전하고 키를 다시 복사해 넣으세요. 클로드도 자본주의 사회에 산답니다. (ㅠㅠ)

아, 갑자기 생각난 건데… 간혹 zsh: command not found: brew라고 뜨는 분들! 이건 홈브루(Homebrew) 자체가 안 깔린 겁니다. AI 에이전트 만들기 전에 집부터 지어야 해요. 맥초보라면 이 부분부터 체크해 보시는 게 좋습니다.

마지막 필살기: 12년 차가 알려주는 ‘터미널 심폐소생술’

“하라는 대로 다 했는데 여전히 빨간 글씨인데요?” 하시는 분들 분명 계실 거예요. 그럴 때 제가 마지막으로 시도하는 ‘필살기’ 두 가지가 있습니다.

• 첫째, 깡그리 지우고 다시 깔기 (Clean Install): 개발자들 사이에서는 “안 되면 밀어라”가 국룰이죠. rm -rf venv 명령어로 가상환경을 아예 날려버리고 다시 python -m venv venv부터 시작해 보세요. 의외로 라이브러리 간의 꼬인 실타래가 한 번에 풀리는 기적을 맛보게 되실 겁니다. (저도 어제 이거 하느라 30분을 날렸지만요..ㅋㅋ)
• 둘째, 맥의 보안(SIP) 잠깐 달래주기: 애플이 보안을 워낙 철저하게 하다 보니, 오픈클로가 파일 시스템을 건드리는 걸 ‘공격’으로 오해할 때가 많아요. 이럴 땐 ‘개인정보 보호 및 보안’ 탭에서 터미널에 ‘App 관리’ 권한까지 주면 웬만한 Permission Denied는 쑥 들어갑니다.

이런 에러 나오면 그냥 재부팅 하세요

• Kernel Panic 어쩌구: 이건 소프트웨어 문제가 아니라 맥미니 하드웨어 비명이거나 OS가 꼬인 겁니다. 조용히 껐다 켜세요.
• Memory Error: 8GB 램 모델에서 너무 무거운 모델을 돌릴 때 발생합니다. 맥미니가 불쌍하니 작업을 좀 줄여주세요.

Blogger’s One-Pick!

제 추천은 에러가 나면 “에러 코드의 마지막 3줄을 복사해서 챗GPT에게 던지는 것”입니다. 12년 차인 저도 가끔은 그렇게 해결하거든요. 아, 그리고 도저히 안 되겠다 싶으면 제 댓글창에 에러 로그를 남겨주세요. 제가 애 재우고 나서 ‘야간 상담소’ 열어드릴게요!

궁금해하실 것 같은 질문들 (Q&A)

Q. git clone 할 때부터 에러가 나요.

A. 맥에 ‘Git’이 안 깔려 있을 확률이 높습니다. xcode-select --install을 먼저 입력해 보세요.

Q. .env 파일이 안 보여요!

A. 점(.)으로 시작하는 파일은 숨김 파일입니다. 폴더 안에서 Command + Shift + . (점)을 누르면 마법처럼 나타납니다.

Q. API 비용이 너무 많이 나오면 어쩌죠?

A. 앤스로픽 설정에서 ‘Usage Limit’을 걸어두면 됩니다. 커피 한 잔 값으로 자비스를 고용한다고 생각하면 마음이 편해요.

여러분의 터미널엔 지금 어떤 에러가 떠 있나요? 해결 안 되는 ‘빨간 글씨’가 있다면 댓글로 들려주세요. 제가 함께 고민해 드릴게요!