Claude Code 입문
Claude Code를 검색하면 대부분 검은 화면에 명령어를 입력하는 장면부터 나옵니다. 비개발자 입장에서는 이 첫인상 때문에 시작도 전에 포기하는 경우가 많네요. 그런데 사실 지금은 터미널을 한 번도 열지 않고 Claude Code를 쓸 수 있습니다. 이 글에서는 그 두 가지 공식 경로를 하나씩 안내합니다.
📌 3줄 요약
1. 터미널 없이도 데스크톱 앱과 VS Code 확장, 두 가지 공식 경로로 Claude Code를 쓸 수 있습니다.
2. 두 방식 모두 터미널 버전과 같은 엔진을 사용하므로 기능 차이 때문에 손해 볼 일이 없습니다.
3. 결과물만 받으면 되면 데스크톱 앱, 파일을 직접 읽고 다듬는 일이 많으면 VS Code 확장이 정답입니다.
터미널이 무서워도 Claude Code를 쓸 수 있는 이유
Claude Code를 검색하면 대부분 검은 화면에 명령어를 입력하는 장면부터 나옵니다. 비개발자 입장에서는 이 첫인상 때문에 시작도 전에 포기하는 경우가 많네요.
그런데 사실 지금은 터미널을 한 번도 열지 않고 Claude Code를 쓸 수 있습니다. 데스크톱 앱과 VS Code 확장, 두 가지 공식 경로가 있기 때문입니다.
🔍 두 가지 경로, 이렇게 이해하면 됩니다
데스크톱 앱은 카카오톡처럼 아이콘을 더블클릭해서 실행하는 독립 프로그램입니다. 채팅창에 한글로 요청을 입력하면, Claude가 알아서 파일을 읽고 수정해 줍니다.
VS Code 확장은 코드 편집기인 VS Code 안에 Claude Code 채팅 패널을 붙이는 방식입니다. 문서나 코드를 화면 왼쪽에 띄워 놓고, 오른쪽 패널에서 대화하며 작업할 수 있습니다. 편집기와 AI 비서가 한 화면에 나란히 있는 구조라고 생각하면 이해가 빠릅니다.
데스크톱 앱의 설치 과정도 일반 프로그램과 똑같아서, 컴퓨터에 프로그램을 한 번이라도 깔아본 사람이라면 누구나 따라 할 수 있습니다. 실행 후에 보이는 화면도 웹에서 쓰던 Claude 채팅과 거의 비슷해서 낯설지 않네요.
두 방식 모두 내부적으로는 터미널 버전과 같은 엔진을 사용합니다. 그래서 기능 차이 때문에 손해 볼 걱정은 하지 않아도 됩니다. 실제로 Anthropic 공식 문서에서도 세 방식이 동일한 Claude Code 엔진을 공유한다고 안내하고 있습니다.
명령어를 외울 필요가 없다는 점이 가장 큰 장점입니다. 터미널에서 쓰던 슬래시 명령어(slash command)도 버튼과 메뉴로 대부분 대체되어 있습니다. 예를 들어 대화 기록을 지우거나 모델을 바꾸는 기능도 설정 메뉴에서 클릭 몇 번으로 처리됩니다.
💬 직접 써본 소감
제가 직접 써보니 터미널 버전과 데스크톱 앱의 실제 작업 결과물은 사실상 동일했습니다. 다만 터미널에 익숙한 사람에게는 오히려 데스크톱 앱이 답답할 수 있는데, 입문자라면 반대로 진입 장벽이 확 낮아지는 느낌을 받을 겁니다.
"검은 화면 공포증" 때문에 미뤄왔다면, 이 글에서 소개하는 두 방법 중 하나로 오늘 바로 시작해도 됩니다.
데스크톱 앱 다운로드와 첫 실행 과정
먼저 Claude 공식 홈페이지(claude.com)에 접속해서 다운로드 메뉴를 찾습니다. Windows와 Mac 모두 지원하므로, 자신의 운영체제에 맞는 설치 파일을 받으면 됩니다. 파일 용량은 그리 크지 않아서 다운로드는 금방 끝납니다.
설치 파일을 실행하면 일반 프로그램처럼 설치 마법사가 진행됩니다. 다음 버튼 몇 번이면 끝나고, 별도의 복잡한 설정은 나오지 않네요. 설치 위치를 바꾸거나 옵션을 고민할 필요도 없이 기본값 그대로 진행하면 충분합니다.
첫 실행 시 Claude 계정으로 로그인하라는 화면이 나옵니다. 이미 웹에서 Claude를 쓰고 있다면 같은 계정을 그대로 사용하면 됩니다. 계정이 없다면 구글 계정이나 이메일로 몇 분 만에 새로 만들 수 있습니다.
⚠️ 주의할 점이 하나 있습니다
Claude Code 기능은 유료 플랜(Pro 이상)에서 제공되므로, 무료 계정이라면 먼저 구독이 필요합니다. 구독 전에 웹 버전 Claude로 채팅을 먼저 체험해 보고, 쓸 만하다고 판단되면 결제하는 순서를 추천합니다.
로그인이 끝나면 작업할 폴더를 선택하는 화면이 나옵니다. 바탕화면에 연습용 폴더를 하나 만들어서 지정하는 방법을 추천합니다.
💡 팁
Claude Code는 지정한 폴더 안에서만 파일을 만들고 수정하기 때문에, 연습용 폴더를 쓰면 다른 파일이 건드려질 걱정이 없습니다.
폴더를 지정하면 바로 채팅창이 열립니다. 여기에 "이 폴더에 hello.txt 파일을 만들고 자기소개를 써줘"라고 입력해 보면 됩니다. 명령어 문법 같은 건 전혀 몰라도 되고, 친구에게 부탁하듯 평범한 한국어 문장이면 충분합니다.
몇 초 뒤 폴더 안에 실제 파일이 생긴 것을 확인할 수 있습니다. 터미널 버전에서 하던 일과 완전히 같은 작업이 채팅만으로 끝난 겁니다. 이 첫 성공 경험이 생기면, 그다음부터는 요청의 난이도를 조금씩 올려가며 감을 잡으면 됩니다.
파일을 수정하는 작업에서는 승인 버튼이 나타납니다. Claude가 무엇을 바꾸려는지 미리 보여주고, 사용자가 허락해야 실제 변경이 이루어지는 구조입니다. 삭제처럼 위험할 수 있는 작업일수록 확인 절차가 더 꼼꼼하게 들어가 있습니다.
💬 직접 써본 소감
제 경험상 데스크톱 앱의 가장 좋은 점은 실수에 대한 공포가 줄어든다는 것이었습니다. 승인 화면에서 변경 내용을 눈으로 확인하고 거절할 수 있으니, 명령어 오타로 무언가 망가뜨릴 걱정 자체가 사라지네요.
VS Code 확장 설치와 채팅 패널 사용법
🔍 VS Code란?
VS Code는 마이크로소프트가 만든 무료 편집기로, 공식 홈페이지에서 받아 설치하면 됩니다. 코딩용 프로그램이지만 문서 작업에도 널리 쓰이므로 겁먹을 필요는 없습니다.
VS Code를 설치합니다. 설치 자체는 데스크톱 앱과 마찬가지로 다음 버튼 몇 번이면 끝납니다.
VS Code를 실행한 뒤 왼쪽 사이드바에서 네모 블록 모양의 확장(Extensions) 아이콘을 클릭합니다. 검색창에 "Claude Code"를 입력하면 Anthropic 공식 확장이 가장 위에 나옵니다.
⚠️ 주의
비슷한 이름의 비공식 확장도 있으니, 제작자가 Anthropic으로 표시된 것을 고르는 게 안전합니다.
설치(Install) 버튼 한 번이면 확장 설치가 끝납니다. 설치 후 사이드바에 Claude 아이콘이 새로 생기는 것을 확인하면 됩니다.
Claude 아이콘을 누르면 화면 옆에 채팅 패널이 열립니다. 처음 한 번은 데스크톱 앱과 마찬가지로 계정 로그인을 요구합니다. 로그인은 브라우저 창이 열리면서 진행되고, 승인만 누르면 자동으로 VS Code로 돌아옵니다.
⚠️ 이 순서만은 꼭 기억하세요
VS Code에서는 상단 메뉴의 "폴더 열기"로 작업 폴더를 먼저 열어야 합니다. Claude Code는 현재 열려 있는 폴더를 작업 대상으로 인식하기 때문입니다. 폴더를 열지 않은 상태에서는 Claude가 어디에 파일을 만들어야 할지 몰라 제대로 동작하지 않으니, 이 순서만은 꼭 기억해 두면 좋습니다.
이 방식의 강점은 결과를 즉시 눈으로 본다는 점입니다. 왼쪽 편집기에 파일이 열려 있으면, Claude가 수정한 부분이 색깔로 표시되어 바로 비교할 수 있습니다. 어떤 문장이 지워지고 어떤 문장이 새로 들어왔는지 한눈에 들어오니, 결과물을 검토하는 시간이 크게 줄어듭니다.
수정 제안이 마음에 들지 않으면 거절 버튼으로 되돌리면 됩니다. 채팅 패널에서 "방금 바꾼 부분을 더 쉽게 다시 써줘"처럼 이어서 요청할 수도 있구요. 대화가 이어지는 동안 앞의 맥락을 기억하고 있어서, 매번 처음부터 설명할 필요가 없습니다.
💬 직접 써본 소감
제가 직접 써보니 VS Code 확장은 "대화 따로, 결과 확인 따로"였던 흐름을 한 화면으로 합쳐준다는 점이 확실히 편했습니다. 다만 VS Code 자체가 처음이라면 화면 구성에 적응하는 시간이 하루 이틀은 필요하니, 그 부분은 감안하는 게 좋습니다.
데스크톱 앱과 VS Code 확장 선택 기준
두 가지를 모두 설치할 필요는 없습니다. 자신의 사용 목적에 따라 하나를 고르면 충분합니다. 어차피 계정과 사용량은 공유되기 때문에, 나중에 다른 쪽으로 옮겨도 추가 비용이 들지 않습니다.
| 구분 | 데스크톱 앱 | VS Code 확장 |
|---|---|---|
| 잘 맞는 사람 | 파일 내용을 자주 들여다보지 않는 사람 | 문서·코드를 직접 읽고 다듬는 일이 많은 사람 |
| 대표 작업 | 보고서 초안 생성, 폴더 정리, 데이터 파일 변환 | 수정 전후 비교, 여러 파일을 오가는 작업 |
| 강점 | 단순한 화면 구성, 낮은 진입 장벽 | 한 화면에서 결과를 즉시 확인, 파일 탐색 기능 |
파일 내용을 자주 들여다보지 않는다면 데스크톱 앱이 정답입니다. 보고서 초안 생성, 폴더 정리, 데이터 파일 변환처럼 결과물만 받으면 되는 작업에 잘 맞습니다. 화면 구성이 단순해서 "지금 뭘 눌러야 하지"라는 고민 자체가 생기지 않는다는 것도 입문자에게는 큰 장점입니다.
반대로 문서나 코드를 직접 읽고 다듬는 일이 많다면 VS Code 확장이 낫습니다. 수정 전후를 한 화면에서 비교하는 경험은 데스크톱 앱이 따라오기 어렵네요. 특히 여러 파일을 오가며 작업하는 경우에는 편집기의 파일 탐색 기능이 큰 도움이 됩니다.
과제로 파이썬 코드를 만져야 하는 공대생이라면 VS Code 확장을 추천합니다. 코드가 왜 바뀌었는지 눈으로 따라가는 과정 자체가 공부가 되기 때문입니다. Claude에게 "이 줄이 왜 필요한지 설명해줘"라고 물으면서 진행하면, 과제 해결과 학습을 동시에 챙길 수 있습니다.
나중에 터미널 버전으로 갈아탈 때도 손해가 없습니다. 세 방식 모두 CLAUDE.md 같은 설정 파일과 작업 방식을 공유하므로, 쌓아둔 사용 경험이 그대로 이어집니다. 지금 어떤 방식으로 시작하든, 그 시간이 낭비되지 않는다는 뜻입니다.
시작 순서를 정리하면 이렇습니다. 데스크톱 앱으로 채팅 방식에 익숙해지고, 필요해지면 VS Code 확장으로 넘어가는 흐름이 가장 자연스러울 겁니다.
💡 현실적인 조언 하나
어떤 방식을 쓰든 첫 일주일은 중요한 파일이 아닌 연습용 폴더에서 시험해 보는 습관이 안전합니다. 중요한 과제 파일이나 회사 문서는 사용법에 충분히 익숙해진 뒤에 맡기는 편이 마음도 편합니다.
💬 제 경우에는
처음에는 데스크톱 앱만 쓰다가, 블로그 글을 직접 다듬는 일이 늘면서 VS Code 확장으로 옮겼습니다. 도구를 바꾸는 데 걸린 적응 시간은 반나절 정도였으니, 처음 선택이 틀릴까 봐 너무 오래 고민하지 않아도 됩니다.
✍️ 마치며
검은 화면이 무서워서 Claude Code를 미뤄왔다면, 이제 그 이유는 사라졌습니다. 데스크톱 앱이든 VS Code 확장이든 터미널 버전과 같은 엔진을 쓰기 때문에, 어느 쪽으로 시작해도 손해가 없습니다. 오늘 연습용 폴더 하나 만들고, 채팅창에 첫 요청을 입력해 보세요. 그 작은 성공 경험이 다음 단계로 가는 가장 확실한 출발점이 됩니다.
'AI 툴 문제 해결' 카테고리의 다른 글
| Claude Sonnet 5 달라진 점과 상위 모델 선택 기준 (0) | 2026.07.21 |
|---|---|
| MCP 서버 연결로 Claude Code에 깃허브·DB·브라우저 붙이는 법 (0) | 2026.07.21 |
| Claude Code 응답이 느리거나 멈출 때 해결법 (0) | 2026.04.13 |
| Claude Code에서 같은 오류가 반복될 때 탈출하는 방법 (0) | 2026.04.12 |
| Claude Code 설치 후 명령어가 인식 안 될 때 PATH 오류 해결법 (0) | 2026.04.12 |
