CLI 뜻과 터미널·셸 차이 — 클로드 코드 시작 전에 보는 글

CLI는 Command Line Interface의 줄임말로, 마우스 대신 글자로 컴퓨터에 명령하는 방식입니다. 아이콘을 클릭하는 대신 claude 같은 단어를 직접 쳐서 프로그램을 실행합니다.

"CLI가 뭐야?"에 한 문장으로 답하면 이렇습니다 — 화면의 버튼을 누르는 대신, 검은 창에 명령어를 쳐서 컴퓨터를 움직이는 방법입니다.

그리고 먼저 말씀드리면 — 클로드 코드를 쓰려고 이 글을 보고 계시다면, 터미널을 꼭 배우지 않아도 됩니다. 공식 데스크톱 앱이 있습니다. 자세한 건 아래에 적었습니다.

이 글은 2026년 8월 7일 Claude Code 공식 문서에서 확인한 내용으로 적었습니다.

작성자 — 지피터스에서 마케팅을 하고 있습니다. 개발자가 아니고, 클로드 코드를 업무에 쓰면서 터미널을 처음부터 익혔습니다.

CLI 뜻이 정확히 뭔가요?

Command Line Interface — 우리말로는 명령줄 인터페이스입니다. 컴퓨터에 일을 시키는 방식 하나를 가리키는 말입니다.

우리가 익숙한 방식은 반대쪽인 GUI(Graphical User Interface)입니다. 폴더 아이콘을 더블클릭하고, 버튼을 누르고, 파일을 끌어다 놓는 그 방식이요.

같은 일을 두 방식으로 하면 이렇게 됩니다.

"바탕화면의 report 폴더로 들어가기"

• GUI — 바탕화면 열기 → report 폴더 찾기 → 더블클릭
• CLI — cd ~/Desktop/report 입력

"이 폴더 안에 파일이 몇 개인지 보기"

• GUI — 폴더 열기 → 전체 선택 → 개수 확인
• CLI — ls | wc -l 입력

CLI가 어려워 보이는 건 뭘 칠 수 있는지가 화면에 안 보이기 때문입니다. GUI는 가능한 동작이 버튼으로 다 보이지만, CLI는 아는 만큼만 쓸 수 있습니다.

둘 중 뭐가 낫냐면, 하는 일에 따라 다릅니다. 처음 해보는 일이나 눈으로 확인하며 골라야 하는 일은 GUI가 빠릅니다. 반대로 같은 일을 반복하거나, 남에게 그대로 알려줘야 하거나, 자동으로 돌려야 할 때는 CLI가 낫습니다. 명령 한 줄은 복사해서 전달할 수 있지만 "이 버튼 누르고 저 버튼 누르세요"는 그렇게 안 되니까요.

터미널·셸·CLI는 뭐가 다른가요?

터미널은 창, 셸은 그 안에서 명령을 해석하는 프로그램, CLI는 이 방식 전체를 부르는 말입니다. 셋이 자주 섞여 쓰이지만 가리키는 것이 다릅니다.

• 터미널 — 검은 화면을 띄우는 프로그램입니다. 맥의 터미널 앱, 윈도우의 PowerShell 창 같은 것입니다. 글자를 입력받고 결과를 보여주는 창 자체입니다.
• 셸 — 입력한 글자를 해석해서 실행하는 프로그램입니다. zsh, bash, PowerShell 같은 이름이 셸입니다. 터미널 창 안에서 돌아갑니다.
• CLI — 이 둘을 통해 명령을 주고받는 방식을 가리키는 말입니다.

비유하면 이렇습니다. 터미널은 전화기, 셸은 통역사, CLI는 전화로 일을 시킨다는 방식 자체입니다. 전화기를 바꿔도 통역사는 그대로일 수 있고, 반대도 됩니다.

터미널 안에서 셸이 돌고, 이 방식 전체를 CLI라고 부릅니다.

실무에서는 이 구분을 몰라도 대체로 문제가 없습니다. 다만 오류 메시지에 zsh: command not found 처럼 셸 이름이 튀어나올 때, 그게 터미널이 아니라 셸이 하는 말이라는 걸 알면 검색이 쉬워집니다.

맥과 윈도우에서 뭐가 다른가요?

쓰는 셸이 다릅니다. Claude Code 공식 문서가 지원한다고 밝힌 셸은 네 가지입니다 — Bash, Zsh, PowerShell, CMD.

• 맥 — 터미널.app을 열면 기본이 zsh입니다.
• 윈도우 — PowerShell과 CMD 두 가지가 있고, 둘이 명령어 문법이 다릅니다.

윈도우 쓰시면 이걸 꼭 구분하셔야 합니다. 공식 문서가 알려주는 구분법이 간단합니다.

PS C:\Users\내이름>     ← 앞에 PS가 붙어 있으면 PowerShell
C:\Users\내이름>        ← PS가 없으면 CMD

설치 명령이 서로 달라서, 엉뚱한 쪽에 붙여넣으면 이런 오류가 납니다.

The token '&&' is not a valid statement separator
  → CMD용 명령을 PowerShell에 넣은 것

'irm' is not recognized as an internal or external command
  → PowerShell용 명령을 CMD에 넣은 것

둘 다 "명령이 틀렸다"가 아니라 "창을 잘못 골랐다"는 뜻입니다.

화면에 뜨는 기호는 무슨 뜻인가요?

명령을 기다리는 자리를 프롬프트라고 하는데, 모양이 환경마다 다릅니다.

• % — 맥 기본 셸(zsh)
• $ — bash 계열
• > 또는 PS > — 윈도우
• # — 관리자 권한 상태 (여기서는 실수의 파장이 큽니다)

설명 글에서 $ claude --version 처럼 적혀 있으면, $는 치는 게 아니라 "여기부터 명령"이라는 표시입니다. 앞의 기호는 빼고 claude --version만 입력하시면 됩니다. 처음에 제일 많이 걸리는 지점입니다.

비개발자도 터미널을 배워야 하나요?

클로드 코드만 쓰실 거라면 안 배우셔도 됩니다.

공식 문서가 안내하는 내용입니다 — 그래픽 화면을 선호한다면 데스크톱 앱으로 터미널 없이 Claude Code를 쓸 수 있고, macOS·윈도우·리눅스용이 모두 있습니다.

그리고 터미널을 아예 처음 써보는 사람을 위한 공식 안내 문서도 따로 있습니다. 즉 "터미널을 모르면 못 쓴다"는 전제 자체가 지금은 사실이 아닙니다.

그럼에도 알아두면 좋은 이유는 있습니다.

• 문제가 생겼을 때 검색되는 오류 메시지가 터미널에 뜹니다
• 자동화를 걸거나 여러 도구를 엮을 때는 결국 CLI가 빠릅니다
• 남이 알려주는 해결책이 대부분 명령어 한 줄 형태입니다

그래서 순서를 이렇게 잡는 걸 권합니다. 데스크톱 앱으로 먼저 써보고, 막히는 게 생기면 그때 터미널을 열어보시는 겁니다. 반대 순서로 가면 시작도 못 하고 지치기 쉽습니다.

클로드 코드를 처음 켤 때 필요한 것

터미널 쪽으로 가보기로 하셨다면, 공식 문서 기준으로 준비물이 이렇습니다.

컴퓨터 조건

• macOS 13.0 이상 / Windows 10 1809 이상 / Ubuntu 20.04 이상
• 메모리 4GB 이상, 인터넷 연결

계정 조건 — 이게 중요합니다
공식 문서에 무료 Claude.ai 플랜으로는 Claude Code를 쓸 수 없다고 명시돼 있습니다. Pro·Max·Team·Enterprise 또는 Console 계정이 필요합니다.

설치 명령 (2026년 8월 7일 기준)

맥·리눅스·WSL:

curl -fsSL https://claude.ai/install.sh | bash

윈도우 PowerShell:

irm https://claude.ai/install.ps1 | iex

설치가 됐는지 확인

claude --version

2.1.211 (Claude Code) 처럼 버전 번호가 뜨면 성공입니다. command not found가 뜨면 설치가 안 된 것이고요.

뭔가 이상할 때

claude doctor

설치 상태와 설정 오류를 읽기 전용으로 점검해서 보여줍니다. 세션을 시작하지 않으니 부담 없이 돌려보셔도 됩니다.

자주 나오는 질문

CLI가 뭔데 자꾸 나오나요?
AI 개발 도구들이 대부분 CLI로 먼저 나오기 때문입니다. 클로드 코드, 코덱스, 제미나이 CLI 모두 명령어로 실행하는 형태가 기본입니다. 그래서 AI 도구를 쓰다 보면 안 마주치기가 어렵습니다.

CLI와 터미널은 같은 말인가요?
아닙니다. 터미널은 창을 띄우는 프로그램이고, CLI는 글자로 명령하는 방식을 가리킵니다. 터미널은 CLI를 쓰는 통로 중 하나입니다.

명령어를 다 외워야 하나요?
아니요. 실제로 쓰는 건 폴더 이동(cd), 목록 보기(ls), 프로그램 실행 정도입니다. 나머지는 필요할 때 찾아 쓰는 게 보통입니다.

잘못 치면 컴퓨터가 망가지나요?
평범한 명령으로는 안 됩니다. 다만 sudo나 rm -rf처럼 권한이 높거나 삭제하는 명령은 되돌릴 수 없으니, 뜻을 모르는 명령을 그대로 붙여넣지 않는 것이 유일한 원칙입니다.

맥이랑 윈도우 중 뭐가 편한가요?
맥·리눅스 계열이 자료가 더 많습니다. 윈도우에서도 다 되지만, PowerShell과 CMD를 구분해야 하는 단계가 하나 더 있습니다.

터미널을 안 쓰고 시작하려면요?
공식 데스크톱 앱을 받으시면 됩니다. 같은 Claude Code를 그래픽 화면으로 쓰는 방식입니다.

쓰다 보면 요금이 얼마나 나오나요?
모델과 대화 길이에 따라 다릅니다. 계산 구조는 AI 토큰 뜻과 비용 계산에 정리해뒀습니다.

정리하며

CLI는 글자로 명령하는 방식이고, 터미널은 그 글자를 치는 창이며, 셸은 친 글자를 해석해 실행하는 프로그램입니다.

• CLI = 글자로 명령하는 방식 (마우스 대신 키보드)
• 터미널 = 그 글자를 입력하는 창
• 셸 = 입력을 해석해 실행하는 프로그램 (zsh·bash·PowerShell)
• 클로드 코드 = 터미널로도, 데스크톱 앱으로도 쓸 수 있음

시작하는 데 필요한 건 이해가 아니라 한 번 켜보는 것입니다. 데스크톱 앱이든 터미널이든 먼저 열어서 한 줄 쳐보면, 위 구분이 저절로 눈에 들어옵니다.

지피터스에는 비개발자로 시작해 AI 도구를 업무에 붙인 분들의 기록이 쌓여 있습니다. 어디서 막혔고 어떻게 넘어갔는지가 남아 있어서, 같은 자리에서 헤매는 시간을 줄일 수 있습니다.

확인일: 2026년 8월 7일
출처: Claude Code 공식 설치 문서 · 터미널 입문 안내

설치 명령과 지원 사양은 바뀝니다. 실제로 설치하실 때는 공식 문서를 한 번 더 확인하세요. 이 글의 버전 표기(2.1.211)는 공식 문서의 예시이며 현재 최신 버전과 다를 수 있습니다.