Claude Code 사용법, 맥에서 설치하고 첫 작업까지

터미널에서 AI에게 일을 시키는 도구다. 채팅창에 코드를 복사해 붙이는 게 아니라, 내 폴더의 파일을 직접 읽고 고치고 명령을 실행한다.

우리는 이걸로 블로그 글을 올리고, 로그를 뒤지고, 유튜브 태그를 고친다. 이 글은 처음 깔고 첫 작업을 시키기까지의 순서다.

설치

Node가 깔려 있으면 한 줄이다.

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

맥에서 Homebrew를 쓴다면 이쪽도 된다.

brew install --cask claude-code

깔렸는지는 이렇게 본다.

claude --version

버전이 나오면 된다. "명령을 찾을 수 없다"고 나오면 설치는 됐는데 경로가 안 잡힌 것이다. 그건 따로 정리했다. 맥 환경변수 설정하는 법, zshrc에 넣었는데 안 먹을 때

어느 폴더에서 켜느냐가 먼저다

여기가 다른 도구와 제일 다른 점이다. 이 도구는 실행한 폴더를 작업 공간으로 삼는다.

cd ~/내프로젝트
claude

그 폴더의 파일을 읽고 고친다. 그래서 아무 데서나 켜면 안 된다. 홈 폴더에서 켜면 홈 전체가 작업 대상이 된다.

처음 보는 폴더에서 켜면 이 폴더를 신뢰하느냐고 한 번 묻는다. 한 번 답하면 기억한다.

자동 실행에 올릴 생각이라면 이 물음이 함정이 된다. 사람이 없으니 아무도 답하지 않고, 프로세스는 살아 있는 채로 영원히 기다린다. 그래서 자동 실행 스크립트는 이미 신뢰한 폴더로 이동한 뒤 켜야 한다.

첫 작업 시키기

켜면 입력창이 나온다. 한국어로 그냥 말하면 된다.

이 폴더에 뭐가 있는지 정리해줘

파일을 고치라고 시킬 수도 있다.

README에 설치 방법 절을 추가해줘

파일을 고치거나 명령을 실행하기 전에 물어본다. 무엇을 하려는지 보여주고 허락을 받는다. 처음에는 하나씩 읽어보고 허락하는 게 좋다. 익숙해지면 자주 쓰는 것만 미리 허용해둘 수 있다.

설정 파일

허용 범위 같은 것은 설정 파일에 쌓인다.

~/.claude/settings.json

여기에 권한, 쓸 모델, 화면 설정 같은 게 들어간다. 손으로 고쳐도 되고 도구 안에서 바꿔도 된다.

모델은 여기서 정한다. 그리고 이게 생각보다 중요하다.

모델을 바꿀 때 조심할 것

우리가 실제로 당한 일이다.

모델을 더 긴 컨텍스트로 바꿔서 띄웠더니, 프로세스도 멀쩡하고 메시지도 받고 답변 문장까지 만드는데 결과가 나가지 않았다.

원인은 도구를 부르는 방식이 달라진 것이었다. 긴 컨텍스트 모드에서는 일부 도구가 바로 쓸 수 없는 상태로 들어오는데, 그러면 그 도구를 안 부르고 그냥 글자로만 답해버린다. 화면에는 답이 있는데 실제로는 아무것도 안 한 상태다.

같은 버전, 같은 폴더, 모델만 달랐다. 찾는 데 한참 걸렸다.

교훈은 이것이다. 모델을 바꾸면 전체 동작을 한 번 다시 확인한다. 특히 자동으로 도는 것에 물려 있다면 반드시 봐야 한다.

알아두면 좋은 것들

• 작업 폴더마다 지침을 남길 수 있다. 폴더에 CLAUDE.md를 두면 켤 때마다 읽는다. "항상 한국어로 답해라", "이 폴더는 이런 구조다" 같은 걸 적어두면 매번 설명 안 해도 된다
• 대화가 길어지면 알아서 정리한다. 앞부분을 요약해서 이어간다. 긴 작업 중에 끊길 걱정은 안 해도 된다
• 되돌리기는 도구가 안 해준다. 파일을 고치는 물건이라 중요한 폴더라면 git 같은 것으로 되돌릴 수 있게 해두는 게 안전하다

더 나가면

터미널이 아니라 디스코드에서 말을 걸어 쓸 수도 있다. 폰으로 한 줄 보내면 집에 있는 맥이 일한다. 우리가 쓰는 방식이고 따로 적었다. 클로드를 디스코드 봇으로 쓰기, 맥미니에서 24시간

정리

1. npm install -g @anthropic-ai/claude-code 또는 Homebrew

2. 작업할 폴더로 이동해서 켠다. 아무 데서나 켜지 않는다

3. 한국어로 시키면 된다. 파일을 고치기 전에 물어본다

4. 폴더에 CLAUDE.md를 두면 매번 설명할 필요가 없다

5. 모델을 바꾸면 동작을 다시 확인한다

여기 나오는 버전과 경로는 맥미니에서 실제로 확인한 값이다.

함께 보면 좋은 글

• 클로드를 디스코드 봇으로 쓰기, 맥미니에서 24시간
• 맥 외장하드 exFAT 손상, 영상 파일 유실 복구: 재마운트와 코덱 일치