터미널 없이 클로드 코드 세팅하는 법 (전체 가이드)

안녕하세요, 낭만빌더 김스듴입니다.

클로드 코드로 앱을 만들어 보고 싶은데, 튜토리얼마다 첫 줄이 “터미널을 여세요”로 시작하죠. 그 까만 화면이 뜨는 순간 대부분 창을 닫습니다. 실력 문제가 아니라 시작하는 방법이 잘못 안내된 것입니다.

까만 화면 한 번도 안 열고 세팅하는 법입니다. 5분이면 됩니다.

---

⚠️ 시작 전에 꼭 알아야 할 것

💳 안티그래비티는 무료지만, 클로드 코드는 클로드 유료 플랜이 있어야 돌아갑니다. 공식 문서 기준으로 클로드 코드 확장은 Pro, Max, Team, Enterprise 중 하나의 유료 구독 또는 Claude Console(사용량 과금) 계정으로 로그인해야 씁니다. API 키를 따로 발급받을 필요는 없습니다. 무료 계정만 있으면 프로그램은 깔리는데 실제로 쓰려는 순간 로그인 벽에서 막힙니다. 이 부분을 빼놓고 안내하는 글이 많아서 먼저 적어 둡니다.

필요한 것은 두 가지입니다.

• 구글 계정 (안티그래비티 로그인용)
• 클로드 유료 플랜 계정 (클로드 코드 로그인용)

---

1단계 · 안티그래비티 받기

구글에 antigravity 를 검색하거나 antigravity.google 로 바로 들어갑니다. 다운로드 버튼을 누르면 운영체제를 알아서 잡아 줍니다.

설치가 되는 환경인지 먼저 확인하세요. 공식 최소 사양입니다.

운영체제	최소 사양
macOS	macOS 12 (몬터레이) 이상. 인텔 맥 중 X86 구형은 지원하지 않습니다. 애플 실리콘용과 인텔용 파일이 따로 있으니 내 맥에 맞는 것을 받으세요.
Windows	Windows 10 64비트 이상
Linux	glibc 2.28 이상 (우분투 20, 데비안 10, 페도라 36, RHEL 8 계열)

받은 파일을 실행해서 설치하고, 구글 계정으로 로그인합니다.

---

2단계 · 작업할 폴더 열기

새 폴더를 하나 만들고 프로젝트 이름을 붙입니다. 예를 들어 my-first-app 처럼요. 그리고 안티그래비티에서 그 폴더를 엽니다.

📁 폴더를 먼저 여는 이유가 있습니다. 클로드 코드는 “지금 열려 있는 폴더”를 작업 공간으로 잡습니다. 폴더 없이 그냥 켜면 파일을 어디에 만들어야 할지 몰라 헤맵니다.

---

3단계 · 클로드 코드 확장 설치

왼쪽 사이드바에서 확장 프로그램(Extensions) 아이콘을 누릅니다. 검색창에 Claude Code 를 치고 Install 을 누릅니다.

안티그래비티는 VS Code 계열이라 클로드 코드 확장이 그대로 설치됩니다. 공식 문서도 VS Code 계열 편집기에서 확장이 설치된다고 명시하고 있습니다.

🔧 검색해도 안 나오면 Open VSX 레지스트리에서 직접 받으세요. open-vsx.org 에서 Anthropic 의 claude-code 를 찾아 파일로 받은 뒤, 확장 화면의 점 세 개 메뉴에서 파일로 설치하면 됩니다. 그래도 안 되면 그 편집기는 포기하고 터미널에서 CLI 로 쓰는 방법이 있는데, 그건 이 가이드의 취지와 반대니 다음 편에서 다루겠습니다.

설치 후 확장이 안 보이면 창을 다시 불러오세요. 명령 팔레트를 열고(맥 Cmd+Shift+P, 윈도우 Ctrl+Shift+P) Developer: Reload Window 를 실행하면 됩니다.

---

4단계 · 로그인 (영상에서 생략된 단계)

확장을 처음 열면 로그인 화면이 뜹니다. Sign in 을 누르면 브라우저가 열리고, 거기서 클로드 계정으로 승인하면 됩니다.

🚨 여기가 실제로 제일 많이 막히는 자리입니다. 나중에 “Not logged in · Please run /login” 이 뜨면 로그인이 풀린 겁니다. 보통 로그인 화면이 자동으로 다시 뜨는데, 안 뜨면 Developer: Reload Window 를 한 번 실행하세요.

---

5단계 · 클로드 코드 열기

파일을 하나 열어 두면 오른쪽 위 편집기 툴바에 별 모양 아이콘이 생깁니다. 그걸 누르면 클로드 코드 채팅이 열립니다.

⭐ 아이콘이 안 보인다면 폴더만 열고 파일은 안 연 상태입니다. 이 아이콘은 파일이 열려 있어야 나타납니다. 영상만 보고 따라 하다가 “아이콘이 없는데요” 하는 지점이 여기입니다. 파일을 열기 싫으면 다른 길이 두 개 있습니다.

• 오른쪽 아래 상태 바의 ✱ Claude Code 를 클릭 (파일 안 열려 있어도 됩니다)
• 왼쪽 액티비티 바의 별 아이콘을 클릭 (항상 보입니다)

---

6단계 · /init 으로 프로젝트 기억 만들기

채팅창에 이렇게 칩니다.

/init

클로드가 폴더를 훑어보고 CLAUDE.md 라는 파일을 만듭니다. 이게 이 프로젝트의 기억 파일입니다. 앞으로 대화할 때마다 클로드가 이 파일을 먼저 읽고 시작하기 때문에, 매번 “이 프로젝트는 뭐고 어떤 규칙이 있고” 를 다시 설명하지 않아도 됩니다.

빈 폴더에서 돌리면 쓸 내용이 없어서 얄팍하게 나옵니다. 그래도 괜찮습니다. 만들면서 채워집니다.

---

7단계 · 플랜 모드로 시키기

입력창 아래의 모드 표시를 눌러 Plan 으로 바꿉니다. 그리고 만들고 싶은 것을 그냥 한국어로 말하면 됩니다.

운동 기록하는 간단한 웹앱 만들어 줘.
날짜랑 운동 종목이랑 횟수 적을 수 있고, 지난 기록을 목록으로 볼 수 있게.

🧭 왜 플랜 모드부터인가. 플랜 모드에서는 클로드가 바로 파일을 건드리지 않고 “이렇게 만들겠다”는 계획을 먼저 문서로 보여 줍니다. 읽어 보고 승인해야 실제 작업이 시작됩니다. 처음 쓰는 사람일수록 이게 중요합니다. 엉뚱한 방향으로 파일 스무 개를 만들어 놓고 나서 되돌리는 것보다, 계획 단계에서 “아니 그거 말고” 하는 게 훨씬 빠릅니다.

모드는 세 가지입니다.

• Manual — 파일을 고치기 전에 매번 물어봅니다
• Plan — 계획을 먼저 보여 주고 승인을 기다립니다 (처음엔 이걸로)
• Edit automatically — 안 묻고 바로 고칩니다 (익숙해진 뒤에)

---

🧯 자주 막히는 곳

증상	원인과 해결
확장을 깔았는데 안 보인다	창을 다시 불러오세요. 명령 팔레트에서 Developer: Reload Window.
별 아이콘이 없다	파일이 열려 있어야 편집기 툴바에 뜹니다. 아니면 오른쪽 아래 상태 바의 ✱ Claude Code 를 쓰세요.
로그인하라는 말만 반복된다	클로드 유료 플랜 계정인지 확인하세요. 무료 계정으로는 로그인이 통과되지 않습니다.
다른 AI 확장과 충돌하는 것 같다	다른 AI 코딩 확장을 잠시 끄고 창을 다시 불러오세요.
답이 아예 안 온다	인터넷 연결을 확인하고 새 대화를 시작해 보세요.

---

✅ 5분 체크리스트

• 안티그래비티 다운로드하고 구글 계정으로 로그인
• 프로젝트 폴더 만들고 열기
• 확장 프로그램에서 Claude Code 설치
• 클로드 계정으로 로그인 (유료 플랜 필요)
• 파일 하나 열고 별 아이콘 클릭
• /init 쳐서 CLAUDE.md 만들기
• Plan 모드로 바꾸고 만들고 싶은 것 말하기

---

✳️ 도움이 됐다면 낭만빌더 김스듴 팔로우해 주세요. 일은 AI가, 낭만은 제가 합니다.

원안 참고: @liamjohnston.ai 의 릴스. 한국어로 다시 쓰면서 공식 문서 기준으로 누락된 단계(로그인, 유료 플랜 조건, 아이콘이 안 보이는 경우)를 채웠습니다.