터미널이 곧 비서가 된다, 맥북 + Claude Code 생산성 워크플로우

Claude Code는 Anthropic이 만든, 터미널에서 바로 도는 AI 코딩 도구입니다. 코드를 대신 짜는 것을 넘어, 프로젝트 폴더를 읽고, 여러 파일을 걸쳐 수정하고, 명령을 실행하는 일을 명령줄 하나에서 처리합니다. 개발자는 물론, 반복 작업을 스크립트로 자동화하고 싶은 파워유저에게도 강력한 조합입니다. 맥북에서 어떻게 세팅하고 어떤 흐름으로 쓰면 생산성이 오르는지 정리했습니다.

정확성 안내: 아래 설치 명령·요구사항은 2026-07 공식 자료 기준입니다. Claude Code는 자주 업데이트되므로, 명령이나 기능 명칭이 다르면 공식 문서와 claude --help를 확인하세요.

1. 설치 (맥 기준, 세 갈래)

가장 간단한 방법은 공식 설치 스크립트입니다.

• 스크립트: curl -fsSL https://claude.ai/install.sh | bash — 별도 Node.js 없이 설치되며 백그라운드 자동 업데이트
• Homebrew 사용자: brew upgrade claude-code (설치/업데이트)
• npm 사용자: npm install -g @anthropic-ai/claude-code

시스템 요구: macOS 13(Ventura) 이상, 메모리 4GB 이상. Apple Silicon(M1~M4)과 Intel 모두 지원. Monterey(12.x) 이하라면 macOS를 먼저 올려야 합니다.

2. 설치 확인과 진단

• 버전 확인: claude --version (PATH에 잡혔는지 함께 확인)
• 설치/설정 점검: claude doctor
• (스크린샷 필요: 터미널에서 claude --version과 claude doctor 출력이 정상으로 나온 화면)

3. 첫 실행 — 프로젝트를 이해시키기

프로젝트 폴더로 이동해 claude를 실행하면 대화형 세션이 열립니다. 처음엔 /init을 실행하면 코드베이스를 분석해 빌드 명령·컨벤션·구조를 담은 시작용 CLAUDE.md를 생성합니다. 이 파일은 이후 모든 세션에 자동으로 로드되어, 매번 프로젝트 설명을 반복하지 않아도 됩니다.

• 흐름: cd 내프로젝트 → claude → /init → 생성된 CLAUDE.md 검토·수정

4. 실전 워크플로우 4가지

(1) 버그 재현 → 수정 → 검증 루프

“이 에러 로그를 보고 원인을 찾아 고쳐줘”처럼 자연어로 요청하면 관련 파일을 찾아 수정 제안을 만들고, 허용하면 테스트까지 돌립니다. 변경은 diff로 확인하고 승인하는 방식이라 통제권이 유지됩니다.

(2) 반복 작업 자동화

“이 폴더의 CSV들을 같은 스키마로 합치는 스크립트를 만들어 실행해줘” 같은 1회성 자동화를 개발자가 아니어도 시킬 수 있습니다. 결과 스크립트가 남으니 재사용도 됩니다.

(3) 코드 리뷰·리팩터링

큰 파일을 함수 단위로 쪼개거나, 네이밍 컨벤션을 맞추는 등 지루한 정리 작업을 위임합니다. 무엇을 왜 바꿨는지 설명을 함께 받습니다.

(4) 문서화

“이 모듈이 뭐 하는지 README 초안을 써줘”처럼, 코드를 읽고 문서 초안을 만들게 할 수 있습니다.

5. 맥 생태계와 시너지 (앞 글들과 연결)

• Tailscale + Claude Code: 집 맥/홈서버에 Tailscale로 SSH 접속한 뒤 거기서 Claude Code를 돌리면, 외부 노트북에서도 집의 강한 머신과 프로젝트를 그대로 다룰 수 있습니다(원격접속은 4편 참고)
• 아이폰 단축어 + 터미널: 자주 쓰는 실행 흐름을 스크립트로 만들어두면 맥에서의 반복이 줄어듭니다
• 집중 모드: 긴 작업을 맡겨두는 동안 알림을 차단해 흐름을 유지(1편 참고)

6. 안전하게 쓰는 습관

• 변경은 항상 diff로 확인 후 승인 — 자동 승인은 신뢰되는 작업에만
• 중요한 프로젝트는 git으로 커밋 상태를 유지해 언제든 되돌릴 수 있게
• 민감정보(키·비밀번호)가 든 파일은 접근 범위를 신중히 다루기

핵심 요약

• Claude Code는 터미널에서 도는 Anthropic의 AI 코딩 도구 — 코드베이스를 읽고 다중 파일 수정·명령 실행까지 수행
• 설치: 공식 스크립트 curl ... install.sh | bash, 또는 Homebrew/npm. macOS 13+ 필요
• /init으로 CLAUDE.md를 만들면 프로젝트 맥락이 매 세션 자동 로드
• 버그 수정 루프·1회성 자동화·리팩터링·문서화가 대표 활용처
• Tailscale 원격접속과 묶으면 ‘어디서든 집 머신에서 작업’ 가능. 변경은 diff 승인 + git 관리로 안전하게

바이라인: 테크노하우 편집팀

출처/검증: Anthropic Claude Code 공식 문서 및 2026-07 기준 설치 가이드. 설치 명령(install.sh/brew/npm)·요구사항(macOS 13+, 4GB)·/init·CLAUDE.md·claude doctor는 공식 자료 기준. 도구가 자주 업데이트되므로 세부 명령은 claude --help/공식 문서로 재확인 권장.

작성 · 테크노하우 편집팀 — 혁신 디바이스를 생산성 도구로 극한 활용하는 실전 하우투. 정보·해설 목적입니다.