Claude Code 터미널 버전이란
Claude Code의 터미널 버전은 명령줄 환경에서 AI의 도움을 받을 수 있는 도구에요. 그래픽 인터페이스 없이 순수하게 터미널을 통해서만 작동하기 때문에, 서버 환경이나 원격 연결 상황에서도 Claude Code를 사용할 수 있다는 장점이 있어요.
터미널에 익숙한 개발자라면 이 버전이 훨씬 효율적이에요. 마우스로 클릭할 필요 없이 키보드만으로 모든 작업을 처리할 수 있기 때문이죠. 또한 터미널 스크립트나 자동화 도구와 쉽게 통합할 수 있다는 것도 큰 강점이에요.
터미널에서 설치하기 위한 준비
필요한 도구들 확인하기
Claude Code를 터미널에서 설치하려면 먼저 기본 개발 도구들이 설치되어 있어야 해요. macOS에는 이미 많은 도구들이 내장되어 있지만, Xcode Command Line Tools는 따로 설치해야 할 수 있어요. 터미널을 열어서 다음 명령어를 입력해보세요:
- xcode-select –install 입력
- 동의 프롬프트가 나타나면 동의하기
- 설치 완료 대기 (시간이 몇 분 걸릴 수 있어요)
이 도구들이 설치되어 있으면, 이후의 모든 설치 과정을 터미널에서 진행할 수 있어요.
API 키 준비하기
Claude Code가 Anthropic 서버와 통신하려면 API 키가 필요해요. 웹 브라우저에서 console.anthropic.com에 방문해서 계정을 만들고, API Keys 섹션에서 새 키를 생성해야 해요. 이 키를 안전하게 복사해두세요. 터미널에서 설치할 때 이 키를 입력해야 하거든요.
API 키는 절대 다른 사람과 공유하면 안 돼요. GitHub에 올리거나, 공개 저장소에 넣으면 안 된다는 점을 꼭 기억해야 해요.
터미널을 이용한 단계별 설치
Homebrew를 사용한 설치 방법
가장 간단한 방법은 Homebrew를 사용하는 거예요. 터미널을 열어서 다음 명령어들을 순서대로 입력하면 돼요:
- brew tap anthropic/brew
- brew install claude-code
- 설치가 완료되면 자동으로 PATH에 추가돼요
만약 Homebrew가 설치되어 있지 않다면, 먼저 설치해야 해요. /bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)” 명령어를 입력하면 Homebrew가 자동으로 설치될 거예요.
원본 파일로 직접 설치하기
Homebrew 대신 직접 다운로드해서 설치하고 싶다면 이 방법을 시도해보세요. 먼저 Anthropic 공식 웹사이트에서 macOS용 터미널 버전 파일을 다운로드해요. 그 다음 터미널에서 다음 명령어들을 입력합니다:
- cd ~/Downloads (다운로드 폴더로 이동)
- unzip claude-code-*.zip (압축 파일 해제)
- sudo mv claude-code /usr/local/bin/ (바이너리를 시스템 경로에 이동)
- sudo chmod +x /usr/local/bin/claude-code (실행 권한 부여)
이 방법은 시스템 권한(sudo)이 필요할 수 있으니, 비밀번호를 입력할 준비를 하세요.
터미널 환경 설정하기
API 키 환경 변수 설정하기
Claude Code가 정상적으로 작동하려면 API 키를 시스템이 인식해야 해요. 터미널에서 다음과 같이 환경 변수를 설정할 수 있어요:
- export ANTHROPIC_API_KEY=”your-api-key-here” (현재 터미널 세션에만 적용)
- 또는 ~/.zshrc 또는 ~/.bash_profile에 이 줄을 추가 (영구 설정)
- source ~/.zshrc 또는 source ~/.bash_profile로 설정 적용
영구 설정을 하면 매번 터미널을 열 때마다 API 키가 자동으로 인식돼요. 편집기(nano, vim 등)로 ~/.zshrc 파일을 열어서 마지막 줄에 export 명령어를 추가하면 돼요.
PATH 설정 확인하기
Claude Code가 정상적으로 설치되었는지 확인하려면, 터미널에서 which claude-code 명령어를 입력해보세요. /usr/local/bin/claude-code 같은 경로가 나타나면 설치가 제대로 된 거예요.
만약 ‘command not found’ 에러가 나타나면, PATH 설정에 문제가 있을 수 있어요. echo $PATH 명령어로 현재 PATH를 확인하고, 필요하면 ~/.zshrc에 수동으로 경로를 추가해보세요.
터미널에서 Claude Code 사용하기
기본 명령어 배우기
Claude Code 터미널 버전의 기본 사용법은 간단해요. 가장 기본적인 명령어는 다음과 같아요:
- claude-code analyze [파일명] (파일 분석)
- claude-code fix [파일명] (버그 수정)
- claude-code explain [파일명] (코드 설명)
- claude-code help (모든 명령어 목록 보기)
예를 들어 main.py 파일을 분석하고 싶다면 claude-code analyze main.py 명령어를 입력하면 돼요. 그러면 Claude가 파일을 읽고 코드를 분석한 결과를 터미널에 출력해줄 거예요.
인터랙티브 모드로 사용하기
단순한 명령어 실행뿐만 아니라, 대화형으로 Claude Code를 사용할 수도 있어요. 터미널에 claude-code 또는 claude-code interactive 명령어를 입력하면 대화 모드에 들어가요. 그 다음부터는 여러분의 질문이나 요청을 자유롭게 입력할 수 있어요.
대화 모드에서는 파일을 열고 수정하도록 요청할 수 있고, 특정 부분을 설명해달라고 할 수도 있어요. exit 또는 quit 명령어로 대화 모드를 빠져나올 수 있어요.
고급 터미널 팁들
파이프라인과 함께 사용하기
터미널의 강력한 기능 중 하나는 파이프라인(|)을 통한 명령어 연결이에요. Claude Code도 이런 방식으로 활용할 수 있어요. 예를 들어 다른 명령어의 결과를 Claude Code에 전달할 수 있죠:
- cat main.py | claude-code analyze (파일 내용을 분석)
- find . -name “*.py” | claude-code fix (특정 형식의 모든 파일 수정)
- git diff | claude-code review (변경사항 검토)
이런 방식으로 사용하면 스크립트 자동화가 가능해져요. 복잡한 작업들을 일괄 처리할 수 있다는 뜻이에요.
배치 파일로 자동화하기
자주 사용하는 Claude Code 명령어들을 스크립트로 만들어서 자동화할 수 있어요. 예를 들어 프로젝트 폴더의 모든 Python 파일을 분석하는 스크립트를 만들고 싶다면:
- 새 파일 analyze_all.sh 생성
- #!/bin/bash 로 시작
- for file in *.py; do claude-code analyze “$file”; done
- chmod +x analyze_all.sh로 실행 가능하게 설정
- ./analyze_all.sh 로 실행
이런 식으로 스크립트를 작성하면, 복잡한 작업들을 한 번의 명령어로 처리할 수 있어요.
터미널 사용 시 주의사항
API 키 보안 주의하기
터미널에서 API 키를 다룰 때는 보안에 특히 신경써야 해요. export ANTHROPIC_API_KEY=”…” 명령어를 입력하면 명령어 히스토리에 남을 수 있거든요. 대신 ~/.zshrc나 ~/.bash_profile에 저장해서 사용하는 게 더 안전해요.
또한 .zshrc 파일 자체도 chmod 600으로 권한을 제한해야 해요. 그러면 오직 본인만 파일에 접근할 수 있거든요.
메모리와 성능 관리
대용량 파일을 분석할 때는 시스템의 메모리 사용량이 늘어날 수 있어요. 터미널에서 top 명령어를 입력하면 실시간 시스템 상태를 볼 수 있어요. 만약 메모리 사용량이 너무 높아지면 프로세스를 중단하고 파일을 나누어서 처리해보세요.
또한 많은 파일을 동시에 처리하려고 할 때는 한 번에 하나씩 처리하는 게 안정적이에요. 병렬 처리가 필요하다면 xargs 같은 도구를 사용해서 조절할 수 있어요.
마무리하면서
Claude Code를 macOS 터미널에서 설치하고 사용하는 것은 생각보다 간단해요. Homebrew로 설치하거나 직접 바이너리를 다운로드해서 설정하면 되고, 그 다음부터는 다양한 명령어들을 자유롭게 사용할 수 있어요.
터미널 환경에 익숙한 개발자라면 Claude Code의 터미널 버전이 정말 강력한 도구라는 걸 금방 깨닫게 될 거예요. 스크립트 자동화, 배치 작업, 원격 서버에서의 사용 등 다양한 상황에서 활용할 수 있거든요. 지금 바로 설치해보고, 여러분의 개발 생산성을 한 단계 높여보세요.