03-2. Claude Code 사용하기

참고: 이 워크샵(Track C)에서는 Genie Code를 주력으로 사용합니다. Claude Code는 “이런 도구도 있다”는 소개 차원이며, 직접 설치하지 않아도 Section 4 핸즈온 진행에 문제 없습니다. AI Gateway를 통해 비용을 통제할 수 있는 환경이 갖춰졌으니, 이제 Claude Code를 설치하고 사용합니다.

​

Claude Code란?

💡 핵심: Genie Code는 “Databricks 안에서”, Claude Code는 “Databricks 밖에서” 사용합니다. 둘 다 AI Gateway를 통해 비용이 관리됩니다.

​

Step 1: 설치

사전 확인: Node.js 18 이상이 필요합니다. 터미널에서 node --version으로 확인하세요. 없거나 버전이 낮으면 nodejs.org에서 LTS 버전을 설치하세요.

# Node.js 18+ 필요
npm install -g @anthropic-ai/claude-code

claude --version

📸 [스크린샷]: claude --version 실행 결과

​

Step 2: Databricks 연결 (AI Gateway 경유)

# Databricks CLI 인증 확인
databricks auth login --host https://<your-workspace-url>
databricks current-user me

📸 [스크린샷]: Databricks CLI 인증 성공 화면

​

Step 3: AI Dev Kit 설치

설치 방법과 상세 구성은 **AI Dev Kit 설치 & 구성**을 참조하세요.

claude
# → "Databricks AI Dev Kit already set up." 메시지가 나오면 성공

📸 [스크린샷]: AI Dev Kit 설치 완료 메시지

​

Step 4: Claude Code 사용 예시

​

예시 1: 테이블 탐색

lge_smart_tv 카탈로그에 어떤 테이블이 있는지 보여줘

​

예시 2: 데이터 분석

lge_smart_tv.gold.daily_viewing_summary에서 
지역별 평균 시청 시간을 분석해줘

​

예시 3: 크로스 프로덕트 작업 (AI Dev Kit 기능)

gold 스키마 테이블로 Genie Space를 만들고,
매출 추이 대시보드도 만들어줘.
매일 6시에 리프레시하는 Job도 설정해줘.

이 크로스 프로덕트 작업은 Claude Code + AI Dev Kit에서만 가능합니다. Genie Code 단독으로는 불가.

📸 [스크린샷]: Claude Code에서 크로스 프로덕트 작업 실행 모습

​

Genie Code vs Claude Code — 언제 무엇을?

💡 워크샵에서는 주로 Genie Code를 사용합니다. Claude Code는 “이런 것도 된다”를 보여주는 데모용입니다.

​

비용 관리 확인

-- AI Gateway를 통한 Claude Code 사용량
SELECT
  user_identity.email,
  DATE(request_time) AS date,
  COUNT(*) AS requests,
  SUM(usage.total_tokens) AS tokens
FROM system.serving.served_entities_usage
WHERE request_time >= CURRENT_DATE - INTERVAL 1 DAY
GROUP BY 1, 2
ORDER BY tokens DESC

📸 [스크린샷]: 사용량 조회 결과

​

주요 문서 링크

​

다음 단계

• AI Dev Kit 설치 상세 — MCP 서버 앱 배포, Skills 워크스페이스 배포