Terminal CLI 환경에서 Claude Code 설치하고 바로 쓰는 법

2026-07-22

터미널 창 하나만 열고 바로 AI와 작업하는 시대가 왔습니다. Cursor나 VS Code 창을 마우스로 이리저리 누르는 일이 번거롭게 느껴질 때가 많거든요. Anthropic이 공식으로 내놓은 Claude Code는 완전히 터미널 안에서만 돌아가는 에이전트라서, 키보드에서 손을 거의 떼지 않고 코드를 다룰 수 있습니다. 직접 써 보면 GUI보다 CLI가 손가락 피로감이 덜하다는 점이 먼저 와 닿습니다.

Step 1: Node.js 버전 확인하기

Claude Code를 쓰려면 먼저 컴퓨터에 Node.js가 설치되어 있어야 합니다. 최소 18버전 이상이어야 작동하므로 터미널을 열고 버전부터 확인해 봅시다.

버전이 낮게 나오거나 명령어를 찾을 수 없다는 메시지가 뜨면 공식 사이트에서 최신 LTS 버전을 내려받아 설치해야 합니다. 구버전 Node 환경에서 그대로 실행하면 의존성이 꼬이거나 패키지 빌드 과정에서 에러가 날 수 있으니, 이 단계는 건너뛰지 않는 편이 좋습니다.

Step 2: npm 글로벌 명령어로 설치하기

준비가 끝났다면 npm으로 도구를 전역 설치하면 됩니다. 터미널에 아래 명령어를 그대로 입력해 보세요.

설치 진행이 잠깐 멈춘 것처럼 보여도 너무 걱정할 필요는 없습니다. 파일 용량이 아주 큰 편은 아니어서 잠시 기다리면 끝납니다. 만약 권한 관련 에러인 EACCES가 뜬다면 sudo 권한을 쓰거나 nvm 환경을 정리해야 합니다. 윈도우에서는 터미널을 관리자 권한으로 열고 다시 실행하면 한결 수월합니다.

Step 3: Anthropic 계정 로그인 및 인증

설치가 끝났다면 터미널에 단어 하나만 입력하면 됩니다.

처음 실행할 때는 브라우저 창이 열리면서 Anthropic 계정 로그인을 요구합니다. 웹에서 승인 버튼만 누르면 터미널과 연결이 끝나기 때문에 흐름이 꽤 단순합니다. API Key를 직접 환경변수에 넣는 번거로움이 없어서 진입장벽도 낮은 편입니다.

자주 마주치는 에러와 해결 방법

명령어를 쳤는데 빨간색 글씨로 npm ERR! EACCES 에러가 뜬다면, 폴더 쓰기 권한이 부족하다는 뜻입니다. 리눅스나 macOS에서는 sudo를 붙여서 해결하는 경우가 많지만, 글로벌 설치 폴더의 소유권을 사용자 계정으로 바꾸는 방식이 더 안전합니다. 윈도우 사용자라면 명령 프롬프트나 PowerShell을 마우스 우클릭해서 관리자 권한으로 실행한 뒤 다시 시도하면 됩니다.

가끔은 인증 과정에서 브라우저 승인을 마쳤는데도 터미널이 멈춰 있는 것처럼 보일 수 있습니다. 이럴 때는 Ctrl + C로 한 번 종료한 다음 claude 명령어를 다시 입력해 보세요. 두 번째 실행에서는 대개 정상적으로 로그인 상태를 인식하고 입력창을 띄워 줍니다.

또 다른 실패 케이스는 git 저장소 밖에서 실행했을 때입니다. Claude Code는 작업 중인 프로젝트의 git 상태를 바탕으로 파일을 파악합니다. 일반 폴더에서 무작정 실행하면 git 저장소가 아니라는 경고가 나올 수 있으니, 먼저 작업할 프로젝트 폴더로 이동한 뒤 git init으로 저장소를 만들어 두는 편이 좋습니다.

월 구독료가 아깝지 않게 토큰 관리하기

회사 비용으로 쓰든 개인 토큰으로 쓰든, 비용 관리는 꽤 민감한 문제입니다. Cursor는 월 20달러 고정 구독이라 예산 감각이 단순한 편이지만, Claude Code는 사용한 토큰 양에 따라 Anthropic 계정 잔액에서 비용이 바로 빠집니다. 파일 크기가 크거나 git 히스토리가 길면 명령 한 번에 드는 비용이 생각보다 커질 수 있습니다.

비용 폭탄을 줄이려면 템플릿 파일이나 빌드 결과물처럼 굳이 읽힐 필요가 없는 폴더를 제외하는 편이 좋습니다. 프로젝트 루트에 .claudeignore 파일을 만들고 node_modules나 dist 같은 큰 경로를 적어 두면 됩니다. 이런 부분을 빼 두지 않으면 코드 몇 줄 고치는 데도 불필요하게 토큰이 많이 소모될 수 있습니다.

그래도 작업 속도만 놓고 보면 이 비용을 낼 만한 가치가 있습니다. 버그 리포트가 들어왔을 때 터미널 창에서 에러 로그를 바로 넣고 명령어 한 줄로 돌리면, Claude Code가 고치고 테스트까지 이어서 처리해 주는 흐름이 꽤 편합니다. 사람이 소스를 직접 찾고 에디터를 열고 복사 붙여넣기하던 과정을 터미널 안에서 빠르게 넘길 수 있으니, 체감상 효율은 분명히 올라갑니다.

직접 써 보면 되돌아가기 힘든 터미널 코딩

결국 중요한 건 에이전트를 내 작업 흐름에 얼마나 자연스럽게 붙이느냐입니다. 개발 도구를 여러 개 띄우지 않고 터미널 안에서 빌드, 테스트, 커밋까지 이어서 처리하는 맛을 들이면, 예전 방식의 마우스 클릭은 점점 번거롭게 느껴질 수 있습니다. 처음에는 단축키나 옵션이 조금 낯설 수 있지만, 매일 쓰는 명령 몇 가지만 익혀 두면 바이브 코딩의 장점이 또렷하게 보입니다. 일단 가볍게 npm 글로벌 설치부터 시작해 보세요.