Claude Code·Gemini CLI 입문 — 터미널에서 AI에게 코딩 맡기는 방법 (설치부터 첫 사용까지)

한 줄 요약: Claude Code와 Gemini CLI는 내 프로젝트 폴더에서 실행하면 AI가 파일을 직접 읽고 수정까지 도와주는 터미널 도구입니다. 채팅창에 코드를 복사·붙여넣기 하던 방식보다 훨씬 빠르지만, 변경 사항을 승인하기 전에 꼭 확인하는 습관이 필요합니다.

터미널 AI 코딩 도구가 뭔가요?

ChatGPT 같은 채팅형 AI는 코드를 대화창에 보여줄 뿐, 내 컴퓨터의 파일에는 접근하지 못합니다. 반면 터미널형 AI 코딩 에이전트는 내가 지정한 프로젝트 폴더 안의 파일 구조를 읽고, 필요한 파일을 열어 보고, 수정안을 만들어 반영해 줍니다. "로그인 페이지에 이메일 형식 검사를 추가해줘"처럼 말로 지시하면 알아서 관련 파일을 찾아 고칩니다.

대표적인 도구가 Anthropic의 Claude Code와 Google의 Gemini CLI입니다. 에디터 안에서 쓰는 방식이 궁금하다면 Cursor AI 실전 가이드나 GitHub Copilot 리뷰도 함께 참고해 보세요.

시작하기 전에 준비할 것

• Node.js: 두 도구 모두 npm으로 설치하므로 Node.js가 필요합니다. 요구 버전은 도구마다 다르고 바뀔 수 있으니 공식 문서의 안내를 확인하세요. 대체로 최신 LTS 버전을 설치하면 안전합니다.
• 터미널: Windows는 PowerShell, macOS는 터미널 앱, 또는 VS Code 내장 터미널을 쓰면 됩니다.
• 계정: Claude Code는 Anthropic 계정(구독 또는 API), Gemini CLI는 Google 계정이 필요합니다.
• Git: AI가 파일을 바꾸기 전에 되돌릴 수 있도록 Git 사용을 강력히 권장합니다. 처음이라면 깃허브 입문 가이드를 먼저 보세요.

1단계. 설치하기

터미널에서 아래 명령으로 전역 설치합니다. (설치 명령은 버전에 따라 바뀔 수 있으니, 안 되면 공식 문서를 확인하세요.)

Claude Code

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

Gemini CLI

npm install -g @google/gemini-cli

설치가 끝나면 터미널을 새로 열어 아래 명령으로 실행되는지 확인합니다.

claude --version
gemini --version

2단계. 프로젝트 폴더에서 실행하고 로그인하기

1. 터미널에서 내 프로젝트 폴더로 이동합니다. (예: cd my-blog)
2. Claude Code는 claude, Gemini CLI는 gemini를 입력해 실행합니다.
3. 처음 실행하면 로그인 안내가 나옵니다. 브라우저가 열리면 계정으로 로그인해 허용합니다.
4. 입력창이 나타나면 준비가 끝난 것입니다.

중요한 점은 반드시 프로젝트 폴더 안에서 실행해야 한다는 것입니다. 홈 폴더나 바탕화면처럼 넓은 위치에서 실행하면 AI가 불필요한 파일까지 읽게 됩니다.

3단계. 첫 번째 지시 내려보기

처음에는 파일을 바꾸지 않는 읽기·설명 요청부터 시작하는 것이 안전합니다.

이 프로젝트의 폴더 구조를 설명해줘.
어떤 파일이 어떤 역할을 하는지 초보자도 이해하게 정리해줘.

구조를 이해했다면 작은 수정을 요청해 봅니다.

README.md 파일의 맨 위에 프로젝트 한 줄 소개를 추가해줘.
수정하기 전에 어떤 내용을 넣을지 먼저 보여줘.

AI가 수정안을 제시하면 승인(허용) 여부를 묻는 화면이 나옵니다. 내용을 읽고 맞으면 허용, 아니면 거절하고 다시 지시하세요.

자주 쓰는 기본 명령 (슬래시 명령)

명령	설명
/help	사용 가능한 명령 목록 보기
/clear	대화 내용을 비우고 새로 시작
/init	(Claude Code) 프로젝트 설명 파일(CLAUDE.md) 생성
Ctrl + C	진행 중인 작업 중단

Claude Code는 프로젝트 루트의 CLAUDE.md, Gemini CLI는 GEMINI.md 파일에 "이 프로젝트의 규칙"을 적어두면 매번 설명하지 않아도 그 내용을 참고합니다. 예를 들어 "답변은 한국어로 해줘", "수정 전에 계획을 먼저 보여줘" 같은 규칙을 적어 두면 편리합니다. 명령어 이름은 버전에 따라 바뀔 수 있으니 /help로 확인하세요.

Claude Code vs Gemini CLI 비교

항목	Claude Code	Gemini CLI
제공사	Anthropic	Google
실행 명령	claude	gemini
프로젝트 설명 파일	CLAUDE.md	GEMINI.md
로그인	Anthropic 계정(구독 또는 API)	Google 계정
비용	유료 요금제 또는 API 사용량 기준	무료 제공 한도가 있으나 변동될 수 있음
특징	대규모 코드 수정·리팩토링에 강점으로 평가	무료로 체험하기 좋음

요금 정책과 무료 한도, 지원 모델은 자주 바뀝니다. 이용 전에 공식 요금 안내 페이지를 꼭 확인하세요. 처음 체험하는 용도라면 무료 한도가 있는 Gemini CLI로 시작해 감을 잡고, 필요에 따라 다른 도구를 추가하는 방법도 좋습니다.

안전하게 쓰는 5가지 원칙

1. 작업 전에 Git 커밋: AI가 파일을 대량으로 바꿔도 git diff로 확인하고 되돌릴 수 있어야 합니다.
2. 변경 내용은 직접 읽고 승인: "모두 허용" 옵션은 익숙해진 뒤에도 신중히 사용하세요.
3. 비밀 정보 주의: .env 같은 비밀번호·API 키 파일을 AI가 읽거나 외부로 보내지 않도록 주의하고, 해당 파일은 가급적 열람 대상에서 제외하세요.
4. 작게 쪼개서 요청: "사이트 전체 만들어줘"보다 "댓글 입력창 하나 추가해줘"가 훨씬 정확합니다.
5. 이해하며 진행: 이해가 안 되는 코드는 "이 부분이 왜 필요한지 설명해줘"라고 물어보세요.

이럴 때 이렇게 쓰세요

상황	프롬프트 예시
오류가 났을 때	"이 오류 메시지의 원인을 찾아서 고쳐줘. 수정 전에 원인부터 설명해줘."
낯선 코드를 이해할 때	"이 파일이 하는 일을 한 줄씩 쉬운 말로 설명해줘."
작은 기능 추가	"문의 폼에 이메일 형식 검사를 추가해줘. 기존 스타일은 유지해줘."
정리·개선	"중복되는 코드를 찾아서 정리 방법을 제안해줘. 아직 수정은 하지 마."

자주 묻는 질문 (FAQ)

Q1. 코딩을 전혀 몰라도 쓸 수 있나요?

설치와 기본 사용은 가능합니다. 다만 AI가 틀릴 수 있으므로 결과를 확인하고 되돌릴 수 있는 최소한의 지식(Git 기본, 파일 구조)은 필요합니다.

Q2. 어떤 파일이 외부로 전송되나요?

AI가 작업을 위해 읽은 파일 내용은 해당 서비스의 서버로 전송될 수 있습니다. 각 서비스의 개인정보·데이터 정책을 확인하고, 비밀 키나 고객 정보가 든 파일은 다루지 않는 것이 안전합니다.

Q3. 에디터형 AI(Cursor 등)와 뭐가 다른가요?

에디터형은 화면에서 마우스로 변경 사항을 보며 작업하기 편하고, 터미널형은 명령 중심이라 자동화나 큰 단위 작업에 유리합니다. 둘을 함께 쓰는 사람도 많습니다.

Q4. 설치가 안 돼요.

대부분 Node.js 버전 문제이거나 권한 문제입니다. node --version으로 버전을 확인하고, 공식 문서의 설치 요구 사항과 비교해 보세요.

마치며

터미널 AI 도구는 "AI가 내 대신 코드를 짜주는" 경험을 한 단계 끌어올립니다. 오늘은 작은 연습용 프로젝트 하나에서 폴더 구조 설명 → 작은 수정 → 변경 내용 확인의 흐름만 한 번 해 보세요. 그 한 번이 앞으로의 개발 방식을 바꿔 놓을 수 있습니다.