[AI Tools] 클로드 코드(Claude Code) 리눅스 환경 설치 및 가이드

터미널에서 쓰는 코딩 에이전트 클로드 코드(Claude Code)가 인기 있습니다.

클로드 코드는 Linux 터미널 환경에서 소스코드를 분석하고, 테스트를 실행하며, 버그 수정 후 Git 커밋까지 스스로 수행하는 강력한 CLI 툴입니다.

Ubuntu 등 리눅스 환경에서 클로드 코드를 설치하는 방법을 정리 했습니다.

사전 준비 작업

클로드 코드를 설치하려면 Node.js (v18 이상)가 필요합니다. 터미널에서 아래 명령어로 Node.js를 확인합니다.

$ node -v
$ npm -v

Node.js 버전이 낮거나 설치되어 있지 않다면, nvm(Node Version Manager)을 이용해 최신 LTS 버전을 설치 해야합니다.

클로드 코드(Claude Code) 설치

1단계: 글로벌 NPM 패키지 설치

클로드 코드를 리눅스에 설치합니다. 보안 권한이 필요해 sudo 명령어를 앞에 붙여줍니다.

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

2단계: Anthropic 계정 인증 (Oauth 로그인)

claude를 입력하면 Anthropic API 사용을 위한 인증 과정이 나옵니다.

$ claude

1. 명령어를 입력하면 터미널에 인증용 코드와 함께 웹 링크가 나타납니다.
2. 링크를 클릭해 웹 브라우저를 열고 Anthropic 계정으로 로그인한 뒤, 코드를 입력해 인증을 완료합니다.

3단계: 특정 프로젝트 디렉토리에서 시작하기

특정 폴더로 이동해서 claude를 입력하면 해당 프로젝트를 기반으로 시작할 수 있습니다.

$ cd /path/to/your-project
$ claude

 

자주 쓰는 명령어

클로드 코드를 사용하면서 제가 자주 쓰는 명령어 들입니다.

• /compact : 콘텍스트 내용을 압축하여 요약합니다. 긴 대화로 토큰 소모가 심해질 때 메모리를 정리하기 좋습니다.
• /bug : 프로젝트 소스코드에서 버그나 잠재적 에러 요소를 탐색합니다.
• /test : 프로젝트 테스트 코드를 자동으로 실행하고 실패 원인을 분석합니다.
• /clear : 이전 대화 기록을 모두 지우고 콘텍스트를 초기화하여 토큰을 절약합니다.
• /exit : 세션을 종료하고 원래 리눅스 쉘로 돌아옵니다.
• /remote-control : 클로드 코드 세션을 스마트폰이나 다른 기기의 브라우저에서 원격 연결 및 제어하는 기능입니다.