본문 바로가기
AI 코딩/클로드 코드

코딩 몰라도 됩니다 — 클로드 코드 설치와 첫 실행 (터미널 없이)

by 아트스탁 2026. 8. 19.

클로드로 프로그램을 만들기 시작했을 때, 저는 한동안 이렇게 했습니다.

  1. 채팅창에 원하는 걸 말한다
  2. 나온 코드를 전부 복사한다
  3. 메모장에 붙여넣고 저장한다
  4. 실행한다
  5. 오류가 나면 그 오류를 복사해서 다시 채팅창에 붙여넣는다
  6. 1번으로 돌아간다

이걸 몇 주 동안 했습니다. 파일이 하나일 때는 그럭저럭 견딜 만했는데, 파일이 서너 개로 늘어나니까 감당이 안 되더군요. 어느 파일의 몇 번째 줄을 고쳐야 하는지 제가 찾아서 알려줘야 했으니까요.

그러다 클로드 코드라는 걸 알게 됐습니다. 이 노가다가 통째로 사라졌습니다.

클로드 코드가 뭔가

쉽게 말하면 클로드가 내 컴퓨터의 파일을 직접 읽고 고치는 것입니다.

항목 채팅창 클로드 코드
내 파일 읽기 내가 복사해서 붙여넣어야 함 직접 읽음
코드 수정 내가 복사해서 저장 직접 고침
오류 확인 내가 복사해서 전달 직접 실행해서 확인
여러 파일 작업 사실상 불가능 가능

복사·붙여넣기가 없어진다는 것 하나가 생각보다 훨씬 큽니다. 특히 오류가 났을 때, 제가 오류 메시지를 옮기지 않아도 알아서 보고 알아서 고칩니다.

준비물

공식 문서 기준으로 필요한 건 세 가지입니다.

  • 윈도우 또는 맥 컴퓨터
  • 작업할 프로젝트 폴더
  • Claude 구독(Pro, Max, Team, Enterprise) 또는 Console 계정

구독은 처음 시작이라면 Pro로도 충분합니다. 터미널이나 프로그래밍 지식은 필요 없습니다.

설치하기

솔직히 말하면, 저는 이 부분을 제대로 몰랐습니다.

터미널이 뭔지, 명령어를 어디에 쳐야 하는지 하나도 몰랐습니다. 그래서 그냥 클로드한테 물어봤습니다.

클로드 코드를 쓰고 싶은데 뭘 어떻게 해야 하는지 모르겠어.
윈도우 쓰고 있고, 컴퓨터는 잘 몰라.
처음부터 하나씩 알려줘.

그때 알게 된 게, 설치 방법이 두 가지라는 것이었습니다. 그리고 저 같은 사람은 둘 중 하나만 알면 된다는 것도요.

방법 1. 데스크톱 앱 — 저는 이걸 씁니다

결론부터 말씀드리면 컴퓨터를 잘 모르시면 무조건 이쪽입니다. 터미널을 쓸 일이 아예 없습니다.

  1. claude.com/download 에서 설치 파일을 받아 설치합니다
  2. 앱을 실행하고 왼쪽 사이드바에서 Code 탭을 켭니다
  3. 작업할 폴더를 선택합니다 (저는 C:\claude)
  4. 하고 싶은 일을 채팅창에 그냥 씁니다

끝입니다. 명령어를 외울 필요도, 검은 화면을 열 필요도 없습니다. 평소 클로드랑 대화하던 것과 똑같은데 내 컴퓨터 파일을 만질 수 있다는 것만 다릅니다.

윈도우라면 Git for Windows도 같이 깔아두시길 권합니다.
없어도 동작은 합니다. 다만 Git for Windows가 없으면 클로드 코드가 셸로 PowerShell을 대신 쓰고, 깔아두면 Bash를 쓸 수 있어 할 수 있는 일이 더 많아집니다.
설치 후 앱을 한 번 재시작하세요.

한 가지 알아두실 점은 데스크톱 앱은 윈도우와 맥만 지원한다는 것입니다. 리눅스는 아직 안 됩니다.

방법 2. 터미널 설치 — 나중에 필요해지면

개발자들이 주로 쓰는 방식입니다. 저도 지금은 가끔 씁니다.

예전 자료를 보면 npm install -g @anthropic-ai/claude-code 로 설치하라고 나오는데, 지금은 네이티브 설치가 권장 방식입니다. Node.js를 따로 깔 필요가 없습니다.

Windows PowerShell

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

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

macOS / Linux

curl -fsSL https://claude.ai/install.sh | bash
내가 PowerShell인지 CMD인지 모르겠다면
프롬프트가 PS C:\ 로 시작하면 PowerShell, C:\ 만 있으면 CMD입니다.

네이티브 설치는 백그라운드에서 자동 업데이트되기 때문에, 한 번 깔아두면 신경 쓸 일이 없습니다.

둘 중 뭘 골라야 하나

데스크톱 앱과 터미널 비교 - 난이도, 성능, 지원 OS, 추천 대상
  데스크톱 앱 터미널
난이도 클릭만 하면 됨 명령어를 알아야 함
성능 차이 없음 차이 없음
지원 OS 윈도우, 맥 윈도우, 맥, 리눅스
추천 대상 비개발자, 처음 시작 개발자, 익숙해진 뒤

성능은 같습니다. 그러니 처음이라면 고민할 필요 없이 데스크톱 앱으로 시작하세요. 쓰다 보면 터미널이 필요한 순간이 오고, 그때 깔아도 늦지 않습니다.

첫 실행

어느 방식으로 설치했든, 작업할 폴더를 정하는 게 첫 단계입니다. 이게 중요합니다. 폴더를 잘못 잡으면 클로드가 엉뚱한 파일들을 보게 됩니다.

데스크톱 앱이라면 Code 탭에서 폴더를 선택하는 화면이 나옵니다. 프로그램이 들어있는 폴더를 고르면 됩니다. 저는 C:\claude 를 지정해뒀습니다.

터미널이라면 폴더로 이동한 뒤 실행합니다.

cd C:\claude\내프로젝트
claude

처음 실행하면 로그인하라고 나옵니다. 브라우저가 열리고, 평소 쓰던 Claude 계정으로 로그인하면 끝입니다. 한 번 로그인하면 다시 물어보지 않습니다.

여기까지 오면 시작점입니다.

처음 해볼 것

바로 코드를 고치라고 하지 마시고, 먼저 읽어보게 하는 걸 권합니다. 저는 이렇게 시작했습니다.

이 폴더에 뭐가 들어있는지 설명해줘

breakout.py가 무슨 일을 하는 코드인지 알려줘

제가 짠 코드인데도 몇 달 지나면 뭐가 뭔지 기억이 안 납니다. 이렇게 물어보면 정리해서 알려주니, 그것만으로도 쓸모가 있었습니다.

그다음에 실제 수정을 시켜봅니다.

breakout.py에서 거래량 조건을 20일 평균 기준으로 바꿔줘

바꿀 내용을 먼저 보여주고 승인을 받은 뒤에 고칩니다. 파일을 마음대로 건드리지는 않습니다.

알아두면 편한 것들

초반에 몰라서 헤맸던 것들입니다.

입력 기능
/help 쓸 수 있는 명령 보기
/clear 대화 기록 지우기 (느려졌을 때)
/compact 대화를 요약해서 공간 확보
/exit 종료 (터미널)
claude -c 이전 대화 이어서 시작 (터미널)
↑ 키 이전에 입력한 내용 불러오기
Shift+Tab 권한 모드 바꾸기

/clear는 알아두시면 좋습니다. 대화가 길어지면 클로드가 눈에 띄게 느려지는데, 작업이 하나 끝날 때마다 지워주면 속도가 유지됩니다.

다음에 할 것

설치하고 돌려보는 것까지가 여기까지입니다. 그런데 이대로 쓰면 두 가지가 금방 거슬립니다.

  • 파일 하나 고칠 때마다 승인 창이 뜹니다
  • 요청하지 않은 부분까지 같이 고쳐놓습니다

둘 다 설정으로 해결됩니다. 각각 따로 정리해뒀으니 이어서 보시면 됩니다.

저는 이 둘까지 다 맞춰놓고 나서야 작업 속도가 제대로 붙었습니다. 처음부터 이렇게 시작했으면 몇 주는 아꼈을 것 같습니다.

다시 말씀드리지만, 저는 컴퓨터를 잘 아는 사람이 아닙니다. 이 글에 적힌 것도 전부 모를 때마다 물어보면서 알게 된 것들입니다. 설치하다 막히면 그 화면을 그대로 캡처해서 물어보세요. 그게 제일 빠릅니다.

※ 클로드 코드는 업데이트가 잦아 설치 방법이나 명령이 바뀔 수 있습니다. 설치가 안 되면 공식 문서(code.claude.com/docs)에서 최신 방법을 확인하시기 바랍니다.