← KAIROS AI STUDIO 홈 AX Workshop · Onboarding Guide
AX 워크숍 · 사전 준비

웹 AI만 써 봤어도 괜찮습니다.
에이전틱 도구 설치, 5단계로 끝내기

ChatGPT·Gemini·Claude를 브라우저 채팅으로만 써 온 분을 기준으로 썼습니다. 프로그램 설치가 낯설어도 마우스 클릭과 복사·붙여넣기로 끝까지 따라올 수 있습니다. Windows 10/11 · macOS 13 이상 모두 지원합니다.

소요 시간약 30~45분 (재부팅 1회 포함)
대상 OSWindows 10/11 · macOS 13+
버전v3.1 · 2026-09-17
설치 경로Git · AI 앱 또는 VS Code+확장 · 뷰어

VS Code에서 쓰고 싶다면 → VS Code 설치 + Claude Code · Codex · Antigravity · GitHub Copilot 확장 안내

설치가 잘 되었는지 확인하는 실습은 이 페이지에 없습니다. 워크숍 현장에서 강사와 함께 진행합니다. 여기서는 설치와 로그인까지만 마치면 됩니다.

0인사이트 — 웹 AI와 에이전틱 도구는 무엇이 다른가

웹에서 대화하던 AI를 내 작업 공간에서도 쓸 수 있습니다. 선택한 도구에 맞는 계정과 이용 권한을 준비합니다.

웹 AI는 브라우저 채팅창에서 질문하고 답을 받습니다. 결과는 화면에 글로 남고, 파일로 쓰려면 내가 복사해 옮깁니다.
에이전틱 도구는 내 컴퓨터에 설치하는 프로그램입니다. 내가 지정한 폴더 안의 파일을 AI가 직접 읽고, 만들고, 고칩니다. 말로 시키면 결과가 파일로 남습니다. 예: 회의록 정리, 보고서 초안, 여러 문서 비교표, 폴더 속 파일 일괄 정리.
비교 항목웹 AI (ChatGPT · Gemini · Claude 채팅)에이전틱 도구 (내 컴퓨터에 설치)
결과물채팅 화면의 글 · 파일로 쓰려면 복사해 옮김내 폴더에 실제 파일로 저장 · 다음 날 바로 업무에 사용
여러 문서 다루기첨부 개수·용량 제한 · 문서 간 교차 참조가 약함폴더 전체를 보고 여러 파일을 한 번에 일관되게 처리
내 PC의 프로그램 활용불가 (결과를 내가 옮겨 붙임)Git·엑셀·문서 프로그램을 AI가 직접 호출 · 여러 단계를 한 번에 진행
준비 부담없음 · 브라우저만 있으면 시작설치 30~45분 · 회사 노트북은 보안 정책 확인 필요
보안 주의붙여 넣은 내용만 전송지정한 폴더의 파일 내용이 전송 · 폴더에 넣는 자료를 가려야 함
익히기이미 익숙대화 방식은 같음 · 다른 것은 "폴더를 열어 준다"와 "파일 변경을 승인한다" 두 동작
요금Claude·Codex·Antigravity는 각 서비스의 구독·이용 권한으로 사용할 수 있습니다. GitHub Copilot은 GitHub 계정과 Copilot 플랜을 사용합니다. API 인증은 별도 과금 경로이며, 무료 등급·구독별 사용 한도는 계정 화면에서 확인합니다.

고르는 법 — 3초

이미 유료로 쓰는 웹 AI가 있으면 그 회사의 앱을 고릅니다. 추가 결제가 없고, 로그인도 그 계정 그대로입니다.

클로드 Pro → Claude 앱 · ChatGPT Plus → ChatGPT 앱(Codex) · Google AI Pro → Antigravity. 무엇을 골라도 워크숍 실습에는 충분하며, 강사가 도구 간 차이를 시연합니다.

회사 노트북이면 먼저 확인

  1. 프로그램 설치 권한이 있나요?
  2. 방화벽·SSO가 다운로드나 로그인을 막지 않나요?
  3. 보안 프로그램(MDM)이 설치를 제한하지 않나요?

하나라도 막히면 워크숍 1주 전 사내 IT에 예외 요청하세요. 당일 막히면 시간 손실이 큽니다.

🔒 보안·데이터 주의 — 에이전틱 도구는 열어 준 폴더의 파일 내용을 클라우드로 보냅니다. 실습 폴더에는 개인정보·고객정보·대외비·계약서 원문·소스코드·내부 재무자료를 넣지 마세요. 실습용 샘플 또는 비식별 자료만 사용합니다.

1Git 설치 — Windows는 설치 후 재부팅

본인 OS 열만 따라가세요. 한 번 설치하면 이후엔 도구가 알아서 사용하므로 명령어를 외울 필요가 없습니다.

Git이 뭔가요? — AI가 내 폴더의 파일을 만들거나 고칠 때 변경 이력을 남겨 되돌릴 수 있게 해 주는 안전장치입니다. Claude 앱의 Code 탭 등 대부분의 에이전틱 도구가 이것을 필요로 합니다.
단계WindowsWindows 10 / 11macOSmacOS 13 이상
① 설치 파일 받기 git-scm.com/download/win 접속 → 자동 다운로드 → 받은 Git-x.xx.x-64-bit.exe 더블클릭"PC 보호" 경고가 뜨면 추가 정보 → 실행. Spotlight(Cmd + Space) → "터미널" 검색 → 실행 → 아래 한 줄을 붙여 넣고 Enter
xcode-select --install
② 설치 진행 설치 마법사의 모든 화면을 기본값 그대로 "Next" → 마지막 "Install" → 약 1~2분 팝업이 뜨면 "설치" 클릭 → 약 3~5분. 이미 설치되어 있다는 안내가 나오면 그대로 완료입니다.
③ 마무리 반드시 Windows 재부팅 1회. 재부팅을 안 하면 다음 단계의 도구가 Git을 인식하지 못합니다. 재부팅 불필요. 터미널 창은 닫아도 됩니다.

2에이전틱 도구 1개 설치 — 많이 쓰는 순서로

세 가지 경로 중 한 탭을 고릅니다. 기본·China 탭은 앱 하나를, VS Code 탭은 VS Code와 사용할 AI 확장을 설치합니다. 처음에는 확장도 하나만 골라도 됩니다. 앱 탭의 도구는 2026년 9월 기준 사용 규모 순입니다.

1순위
옵션 A · Anthropic
Claude 데스크탑 앱
앱 하나에 Chat · Cowork · Code 세 탭. 워크숍은 Code 탭을 씁니다. 긴 문서·여러 파일을 일관되게 다루는 데 강하고, 개발자 만족도 1위.
💳 웹 클로드와 같은 클로드 Pro에 포함 · 별도 결제 없음 · Cowork·Code 탭은 유료 계정 필요
2순위
옵션 B · OpenAI
ChatGPT 데스크탑 앱의 Codex
2026-07-09부터 Codex가 ChatGPT 앱 안으로 들어왔습니다. 앱 안의 Chat · Work · Codex 중 Codex를 고릅니다. 평소 ChatGPT를 쓰던 분은 계정 그대로.
💳 웹 ChatGPT와 같은 ChatGPT Plus에 포함 · 별도 결제 없음 · 무료 계정도 열리지만 한도가 낮음
3순위
옵션 C · Google
Antigravity 데스크탑 앱
여러 단계 작업을 한 번 지시로 처리하는 에이전트 작업대. Gemini 모델. 제미나이를 유료로 쓰는 분에게 맞습니다.
💳 제미나이 유료 요금제 Google AI Pro에 포함 · 별도 결제 없음 · 무료 등급은 한도가 낮아 실습 중 막힘(현장 확인)
왜 이 순서인가 — 사용 규모 근거 (2026-09-13 확인)
  • Claude Code ↔ Codex는 근소한 1·2위입니다. 설치 패키지(npm) 다운로드는 2026-07-24~08-22 한 달간 Claude Code 6,910만 · Codex 6,630만 · Gemini CLI 170만. OpenAI는 2026-08-21 Codex 활성 사용자 2,000만 명을 발표했습니다.
  • JetBrains 2026년 4월 개발자 설문에서 "가장 좋아하는 도구" Claude Code 46%, Cursor 19%, Copilot 9%.
  • GitHub 저장소 별 수(2026-09-13): claude-code 14.5만 · codex 12.4만 · gemini-cli 10.7만.
  • Google은 2026-06-18 개인 계정의 Gemini CLI 제공을 끝내고 Antigravity로 통합했습니다. 이 탭은 데스크탑 앱 경로이며, VS Code 탭에서는 공식 Antigravity 확장 설치를 안내합니다.

출처: OpenAI 공지 · JetBrains Developer Ecosystem Survey 2026 · npm 다운로드 통계 · GitHub API. 숫자는 확인일 기준이며 바뀔 수 있습니다.

ℹ️ 앱 이름·다운로드 페이지·요금제는 자주 바뀝니다. 설치 직전 각 공식 다운로드 페이지와 본인 계정 화면에서 다시 확인하세요. 아래 표는 2026-09-13 공식 문서 기준입니다.
설치 항목AClaude 앱BChatGPT 앱 (Codex)CAntigravity
다운로드 페이지 claude.com/download openai.com/chatgpt/download이미 ChatGPT 데스크탑 앱이 있으면 최신 버전으로 업데이트만 하면 Codex가 들어 있습니다. antigravity.google/download
Windows 설치 "Windows" 버튼 → 받은 .exe 더블클릭 → 자동 설치일반 PC는 x64 · Snapdragon/Surface 계열만 ARM64 선택 "Windows" 버튼 → 받은 설치 파일 더블클릭 → 자동 설치Microsoft Store 경로가 보이면 그것으로 설치해도 됩니다. "Windows" 버튼 → 받은 .exe 더블클릭 → 자동 설치
macOS 설치 받은 .dmg 더블클릭 → 앱 아이콘을 Applications 폴더로 드래그Universal 빌드 하나로 Apple Silicon·Intel 모두 받은 .dmg 더블클릭 → 앱 아이콘을 Applications 폴더로 드래그Mac App Store 경로가 보이면 그것으로 설치해도 됩니다. 받은 .dmg 더블클릭 → 앱 아이콘을 Applications 폴더로 드래그Apple Silicon(M1~M4)과 Intel 빌드가 다르면 본인 칩에 맞게 선택
첫 실행 시 Windows: "PC 보호" 창 → 추가 정보 → 실행 · macOS: "확인되지 않은 개발자" 경고 → 시스템 설정 → 개인정보 보호 및 보안 → '확인 없이 열기' (한 번만)
에이전틱 화면 찾기 앱 위쪽의 Chat · Cowork · Code 탭 중 Code 클릭 → 입력창 위에서 프로젝트 폴더 선택Cowork는 코드 없이 문서 작업만 하는 탭. 워크숍은 Code 탭을 씁니다. 앱 안의 Chat · Work · Codex 중 Codex 클릭 → 폴더 열기로 작업 폴더 지정 앱 자체가 에이전트 작업대 → 시작 화면 "Open Workspace"로 작업 폴더 지정
회사 방화벽이 막을 때 claude.com · claude.ai · anthropic.com 화이트리스트 요청 chatgpt.com · openai.com 화이트리스트 요청 antigravity.google · google.com 화이트리스트 요청

3로그인(인증) — 평소 쓰던 계정 그대로

에이전틱 도구에 따로 가입하지 않습니다. 웹 채팅에 쓰던 계정으로 로그인하면 요금제도 그대로 적용됩니다.

인증 항목AClaude 앱BChatGPT 앱 (Codex)CAntigravity
로그인 계정Anthropic 계정 — 웹 클로드(claude.ai)에 쓰던 Google 로그인 또는 이메일ChatGPT 계정 — 웹 ChatGPT에 쓰던 이메일·Google·Apple·Microsoft 로그인Google 계정 (Gmail · Workspace) — Google 계정 필수
로그인 방법앱 첫 화면 "로그인" → 브라우저가 열림 → 웹에서 로그인 → 앱으로 자동 복귀앱 첫 화면 "로그인" → 브라우저가 열림 → 웹에서 로그인 → 앱으로 자동 복귀앱 첫 화면에서 Google 계정 선택 → 작업 폴더 접근 동의
포함 요금제웹 클로드와 같은 클로드 Pro(월 $20 수준)에 포함 · 별도 결제 없음Code·Cowork 탭은 무료 계정에서 열리지 않습니다. 이미 Pro면 추가 비용 없음.웹 ChatGPT와 같은 ChatGPT Plus(월 $20 수준)에 포함 · 별도 결제 없음무료·Go 계정도 Codex가 열리지만 한도가 낮아 2시간 실습 중 막힐 수 있습니다.제미나이 유료 요금제 Google AI Pro(월 $20 수준)에 포함 · 별도 결제 없음무료 개인 등급은 한도가 낮아 실습 중 막힘이 현장에서 확인되었습니다.
로그인 됐는지 확인Code 탭이 열리고 입력창 위에 폴더 선택·모델 선택이 보이면 정상Codex 화면이 열리고 폴더 열기 버튼이 보이면 정상시작 화면에 본인 Google 계정 이름이 보이면 정상
회사 SSO가 막을 때워크숍 한정으로 개인 계정(개인 Gmail 등)으로 가입·로그인 → 본격 업무 적용은 IT와 SSO 연동 협의

요금제·한도는 변경될 수 있습니다. 가입·결제 전 각 서비스의 요금 화면에서 확인하세요. 워크숍 후 쓰지 않으면 다음 결제일 전에 구독을 취소할 수 있습니다.

4마크다운 뷰어 설치 — MarkText (이미 VS Code·Obsidian·Typora를 쓰면 생략)

에이전틱 도구가 만드는 결과 파일은 대부분 .md(마크다운)입니다. 메모장으로 열면 **굵게**·# 기호가 그대로 보여, 워드처럼 보기 좋게 열어 주는 무료 뷰어를 설치합니다.

마크다운(.md)이 뭔가요? — 제목·굵게·목록 서식을 담는 가벼운 문서 형식입니다. ChatGPT·Gemini·Claude가 답변을 내려받기 파일로 줄 때도 이 형식입니다. 설치만 하면 .md 더블클릭으로 열립니다.
단계WindowsWindows 10 / 11macOSmacOS 13 이상
① 설치 파일 받기 ⬇ Windows용 내려받기 (일반 64비트)대부분의 윈도우 PC. Snapdragon/Surface 계열이면 ARM64용. ⬇ macOS용 내려받기 (Apple Silicon · M1~M4)2020년 이전 인텔 맥이면 Intel용. 칩 확인: 좌상단 메뉴 → "이 Mac에 관하여".
② 설치 받은 .exe 더블클릭 → "PC 보호" 경고는 추가 정보 → 실행 → 기본값 그대로 "Next" → "Install" 받은 .dmg 더블클릭 → MarkText 아이콘을 Applications 폴더로 드래그 → 첫 실행 시 경고가 뜨면 시스템 설정 → 개인정보 보호 및 보안 → '확인 없이 열기'
③ 한국어 설정 실행 → File → Preferences → General → Language → "한국어" → 앱 재시작 실행 → MarkText → Preferences(Cmd + ,) → General → Language → "한국어" → 앱 재시작

대안 — VS Code가 이미 있으면 .md 파일을 열고 Ctrl/Cmd + Shift + V로 미리보기를 띄워도 같습니다. 위 링크가 열리지 않으면 MarkText 릴리스 페이지에서 받으세요.

✅ 여기까지 하면 사전 준비 완료입니다. ① Git 설치(Windows 재부팅) · ② AI 앱 1개 또는 VS Code+AI 확장 설치 · ③ 선택한 도구에 로그인 · ④ 마크다운 뷰어(VS Code로 대체 가능). 실제로 파일을 만들어 보는 확인 실습은 워크숍 현장에서 강사와 함께 합니다.
🛠 설치·로그인이 막혔을 때 (필요한 분만 펼치기)
Windows: "Windows의 PC 보호" 창이 설치를 막음처음 보는 설치 파일은 Microsoft SmartScreen이 일단 막습니다. 회색 창 좌측 하단 "추가 정보" → 우측 아래 "실행". 이 페이지의 공식 다운로드 페이지에서 받은 파일은 안전합니다.
macOS: "확인되지 않은 개발자" 경고로 앱이 안 열림시스템 설정 → 개인정보 보호 및 보안 아래쪽 "<앱이름>이(가) 차단되었습니다" → "확인 없이 열기". 한 번만 허용하면 이후 더블클릭으로 열립니다.
macOS: 내 Mac이 Apple Silicon인지 Intel인지 모름좌상단 메뉴 → "이 Mac에 관하여" → 첫 줄에 "Apple M1~M4" 또는 "Intel Core i…". Apple Silicon이면 arm64·Universal, Intel이면 x64 파일을 받습니다.
다운로드 페이지가 열리지 않음회사 방화벽이 도메인을 막는 경우입니다. IT에 화이트리스트 요청 또는 개인 핫스팟으로 다운로드 후 USB로 옮기세요.
도구가 "git not found" 또는 Git을 인식 못함Windows는 재부팅 미실행이 가장 흔한 원인 → 재부팅 후 앱 재실행. macOS는 터미널에서 xcode-select --install을 다시 실행하고 앱을 완전 종료(Cmd + Q) 후 재실행.
로그인 시 회사 SSO가 막음워크숍 한정으로 개인 계정(개인 Gmail 등)으로 가입 후 로그인. 본격 업무 적용은 IT와 SSO 연동 협의.
관리자 권한이 없는 회사 노트북Windows: 대부분 일반 사용자 권한으로도 설치됩니다. macOS: 앱을 ~/Applications(홈 폴더 안)에 드래그하면 관리자 권한 없이 설치됩니다. 거부되면 IT에 워크숍 1주 전 사전 설치 요청.
로그인은 됐는데 유료 기능(Code·Cowork 탭 등)이 안 열림무료 계정으로 로그인된 경우입니다. 웹 채팅에 쓰는 유료 계정과 같은 계정인지 확인하고, 다른 계정이면 로그아웃 후 다시 로그인.