CLI 뜻과 클로드 코드(Claude Code)를 CLI 없이 쓰는 방법

“클로드 코드가 좋다는데, CLI에서만 된다고?”라는 말을 들으면 검은 화면에 글자가 가득한 장면부터 떠오를 수 있습니다. 영화 속 해킹 장면에서 보던 화면이라 어디에 무엇을 입력해야 할지도 막막합니다.

CLI는 글자로 명령을 입력해 프로그램을 조작하는 방식입니다. Claude Code는 CLI 말고도 Claude Desktop, VS Code 같은 편집기의 확장, 웹에서 쓸 수 있습니다. 아래에서는 CLI가 무엇인지, Claude Code를 터미널에서 실행하면 무엇이 달라지는지 설명하고, 터미널이 낯선 사람이 쓸 수 있는 다른 화면까지 정리합니다.

CLI, 터미널, 셸은 어떻게 다른가요?

CLI는 Command Line Interface, 즉 명령줄 인터페이스의 약자입니다. 버튼과 메뉴로 조작하는 GUI(Graphical User Interface)와 대비되는 사용 방식입니다. GUI에서도 키보드를 쓰므로, CLI인지는 키보드 사용 여부가 아니라 명령을 글자로 입력하는지로 정해집니다.

위 이미지는 같은 파일을 아이콘으로 보는 방식과 명령의 결과 목록으로 보는 방식을 나란히 놓은 예시입니다.

CLI와 함께 나오는 말이 터미널과 셸입니다. 터미널은 명령을 입력하고 결과를 보는 창이고, 셸은 그 창 안에서 명령을 해석해 실행하는 프로그램입니다. Mac은 zsh, Windows는 PowerShell이 대표적인 셸입니다.

같은 일을 GUI와 CLI로 하면 이렇게 다릅니다. Mac과 Windows는 셸이 달라서 명령 이름도 다릅니다.

같은 일을 하는 GUI 조작과 CLI 명령

하고 싶은 일	GUIFinder, 파일 탐색기	Maczsh	WindowsPowerShell
현재 폴더의 파일 목록 보기	폴더 창 열기	ls	Get-ChildItem
지금 있는 폴더 경로 보기	경로 표시줄	pwd	Get-Location

검색창처럼 글자를 입력하고 결과를 본다는 점은 익숙합니다. 하지만 일반 셸은 “내 파일 정리해줘”라는 말을 AI처럼 알아듣지 못하고, 정해진 명령 이름과 문법만 실행합니다. 자연어 요청은 Claude Code 같은 AI 프로그램을 실행한 뒤 그 입력창에 적습니다.

터미널에서 지금 있는 폴더 확인하기

Claude Code를 CLI로 쓸 때는 실행하기 전에 지금 어느 폴더에 있는지부터 확인합니다. 터미널에서 claude를 실행한 그 폴더가 작업 폴더가 되기 때문입니다.

Mac은 Command와 Space를 함께 눌러 Spotlight 검색창을 열고 ‘터미널’을 검색합니다. Windows는 시작 메뉴에서 ‘PowerShell’을 검색해 엽니다. Windows Terminal을 열었다면 탭이 PowerShell인지 봅니다.

줄 끝의 %, $, PS C:\...> 같은 표시는 명령을 기다린다는 뜻의 프롬프트입니다. 앞의 계정 이름과 경로는 사람마다 다르고, 명령은 이 표시 뒤의 빈칸에 입력합니다. Mac에서 pwd를 입력하고 Enter를 누르면 현재 폴더 경로가, ls를 입력하면 그 폴더의 파일과 폴더 이름이 나옵니다.

Windows PowerShell에서는 Get-Location과 Get-ChildItem이 같은 일을 합니다. 다른 폴더로 옮기려면 cd 뒤에 공백을 넣고 경로를 적으며, 경로에 공백이 있으면 큰따옴표로 감쌉니다. 명령을 찾을 수 없다는 오류가 나오면 운영체제에 맞는 명령인지, 철자가 맞는지부터 봅니다.

Claude Code를 실행하면 무엇이 달라지나요?

Claude Code는 Anthropic이 만든 AI 작업 도구입니다. 연결된 작업 폴더의 파일을 읽거나 편집하고, 명령을 실행할 수 있습니다. 이런 기능은 CLI라는 화면에서 생기는 것이 아니라 Claude Code에 연결된 도구와 권한에서 나옵니다.

설치와 로그인을 마쳤다면 작업 폴더로 이동한 터미널에서 claude를 입력해 시작합니다. 실행된 뒤에는 같은 창이 셸이 아니라 Claude Code의 입력창이 되고, 여기에는 한국어로 요청을 적습니다.

Claude Code, report-project

> README.md만 읽고 이 프로젝트의 목적과 실행 방법을 한 줄씩 요약해 주세요. 파일은 수정하지 마세요.

README.md를 읽었습니다.
목적: 주간 매출 데이터를 모아 보고서 표를 만듭니다.
실행 방법: scripts 폴더의 실행 파일을 엽니다.

어떤 파일을 읽었는지 답과 작업 내역에서 봅니다

요청이 막연하면 Claude Code도 되묻습니다. “파일을 수정해 주세요”라고만 보내면 아래 화면처럼 대상 파일 경로와 바꿀 내용을 다시 묻습니다.

처음에는 파일을 바꾸지 않는 요청부터 보내는 편이 좋습니다. 맡고 있는 프로젝트 폴더의 README.md나 회의록 파일 하나를 지정해 요약을 받아 보고, 답이 원문과 맞는지 대조합니다. 작업 내역을 펼치면 Claude Code가 실제로 어느 파일을 읽었는지도 나옵니다.

CLI에서는 길이와 사용량 제한이 없나요?

CLI에도 제한이 있습니다. Claude Code도 모델이 한 번에 처리하는 정보량인 컨텍스트와 출력 길이, 계정 사용량에 한도가 있습니다. Claude Code가 파일을 직접 읽으면 긴 내용을 매번 붙여 넣는 수고는 줄지만, 프로젝트의 모든 파일을 한 번에 읽지는 않습니다.

웹 채팅과 Claude Code CLI의 한도

항목	웹 채팅claude.ai	Claude Code CLI터미널
컨텍스트 한도	제공	제공
출력 길이 한도	제공	제공
계정 사용량 제한	제공	제공
파일과 도구 사용	연결한 기능 안에서	허용한 폴더와 도구 안에서

요금은 로그인 방식에 따라 다릅니다. API는 프로그램이 모델 제공자에게 요청을 보내는 통로이고, API 계정으로 쓰면 사용한 만큼 요금과 제한이 붙습니다. 지원되는 구독 계정으로 로그인하면 그 플랜의 조건을 따릅니다. 이미 쓰고 있다면 Claude Code 입력창에서 /usage로 사용량을 보고, 실제 청구 금액은 계정의 요금 내역과 맞춰 봅니다.

웹 채팅도 파일과 외부 도구를 쓸 수 있습니다. 그래서 차이는 화면 종류가 아니라 그 제품에 어떤 기능과 권한이 연결됐는지에서 생깁니다.

파일을 바꾸기 전에 항상 승인하나요?

권한 설정과 모드에 따라 다릅니다. 이미 허용한 작업이나 자동 승인 설정에서는 매번 묻지 않습니다. 파일 편집을 허용하는 모드와 모든 권한 검사를 건너뛰는 모드도 서로 다른 설정입니다. 승인 창이 있다고 해서 파일이 실수로 바뀌는 일이 모두 막히지는 않습니다.

위 화면은 수정 하나하나를 승인하는 화면이 아니라, 처음 연 폴더를 신뢰할지 묻는 화면입니다. 이미지에는 사용자 홈 폴더 전체가 보이지만 실제로는 작업할 프로젝트 폴더만 열어 신뢰하는 편이 안전합니다. Yes를 누르기 전에 화면에 나온 경로가 그 폴더인지 봅니다.

처음 수정 작업을 맡길 때는 원본 대신 복사한 폴더에서 시작하고, 바뀐 전후를 비교합니다. Claude Code가 낯선 명령 실행이나 예상 밖의 파일 변경을 요청하면 내용을 읽은 뒤 진행할지 정합니다. 요청에 “읽기만 하세요”라고 적는 것은 의도를 전하는 것일 뿐이고, 프로그램의 권한 설정은 그대로 남습니다.

CLI를 직접 쓰지 않는 방법도 있습니다

Claude Code는 터미널을 배우지 않고도 쓸 수 있습니다. 아래 세 화면에서는 명령을 입력하지 않고 Claude Code를 씁니다.

터미널 없이 Claude Code를 쓰는 세 화면

항목	Desktop의 CodeClaude Desktop 앱	VS Code 확장공식 Claude Code 확장	Claude Code 웹claude.ai/code
시작하는 곳	로그인 후 Code 탭	확장 설치 후 패널 열기	브라우저에서 주소 열기
작업하는 곳	내 컴퓨터의 작업 폴더	VS Code에서 연 폴더	연결한 저장소와 클라우드 환경
CLI 별도 설치	제공하지 않음	제공하지 않음	제공하지 않음

편집기 아래쪽 터미널 패널에서 claude를 실행하는 방법도 있습니다. 편집기 안에 있어도 이 방법은 CLI입니다.

위쪽에서 파일 내용을 보고 아래쪽 터미널에서 Claude Code에 요청하는 구성입니다. 공식 VS Code 확장의 대화 패널과는 다른 화면입니다.

설치부터 첫 요청까지

어느 화면을 고르든 순서는 같습니다. 설치하고, 작업 폴더를 열고, 파일을 바꾸지 않는 요청으로 시작합니다.

1단계는 공식 시작 안내를 따릅니다. 현재 권장되는 네이티브 설치는 Claude Code 실행 파일을 직접 설치하는 방식이라 Node.js를 먼저 설치하지 않아도 됩니다.

CLI를 쓴다면 2단계에서 새 터미널을 열고 claude --version을 실행합니다. 버전 번호가 나오면 다음으로 넘어갑니다. claude를 찾을 수 없다는 오류가 나오면 공식 오류 안내에서 설치 경로와 터미널 재시작을 확인합니다.

3단계와 4단계는 화면마다 다릅니다. CLI는 편집기에서 프로젝트 폴더를 연 뒤 새 터미널을 열고, pwd로 경로를 확인한 다음 claude를 실행합니다. Desktop은 Code 탭에서 로컬 작업 폴더로 그 폴더를 고릅니다. VS Code 확장은 폴더를 연 상태에서 명령 팔레트를 열어 Claude Code: Open in New Tab을 실행합니다. 명령 팔레트는 Mac에서 Command+Shift+P, Windows에서 Control+Shift+P로 엽니다.

5단계 요청부터는 실제 모델 사용량이 듭니다. 앞에서 본 목업처럼 파일 하나를 지정해 요약을 받고, 답을 원문과 대조한 다음 작업 내역에서 읽은 파일이 맞는지 봅니다. 파일을 찾지 못했다고 하면 현재 작업 폴더와 파일 이름부터 확인합니다.

터미널이 낯설면 Desktop의 Code나 VS Code 확장으로 시작해도 같은 Claude Code를 씁니다. 어느 화면을 쓰든 Claude Code가 읽은 파일과 바꾼 파일은 직접 열어 대조합니다.

Sources

• Claude Code 사용 환경 개요
• Claude Code 시작 안내
• Claude Code 설치 방식
• Claude Code 사용량과 비용
• Claude Code 권한 설정
• Claude Code Desktop 안내
• Claude Code VS Code 확장 안내