VS Code용 Looker 확장 프로그램 시작하기

VS Code용 Looker 확장 프로그램을 사용하면 로컬 데스크톱 환경에서 직접 LookML을 개발할 수 있습니다. 풍부한 구문 강조 표시, Looker 인스턴스와의 양방향 파일 동기화, '바이브 코딩'을 위한 AI 코딩 에이전트와의 통합을 제공합니다.

이 확장 프로그램은 Visual Studio Code (VS Code) 프레임워크를 사용하여 빌드되며 다음과 같은 IDE 및 코딩 도구와 같은 VS Code IDE를 기반으로 하는 IDE를 지원합니다.

Claude Code
Codex
커서
Kiro
VS Code
Windsurf
Zed

IntelliJ 및 Eclipse와 같이 VS Code의 포크가 아닌 IDE는 VS Code용 Looker 확장 프로그램에서 지원되지 않습니다.

이 가이드에서는 확장 프로그램을 설정하고 인증하는 방법을 설명합니다.

AI 지원 워크플로

VS Code용 Looker 확장 프로그램은 LookML 파일을 수정하고 만들기 위한 AI 지원 에이전트 개발 워크플로의 일부입니다. 이 워크플로를 사용 설정하려면 다음 도구를 구성하세요.

VS Code용 Looker 확장 프로그램.
VS Code를 기반으로 하는 로컬 IDE. IDE에는 기본 제공 AI 에이전트 (예: 커서)가 포함되어 있거나, IDE에 기본 제공 AI 에이전트 (예: 기본 VS Code)가 포함되어 있지 않은 경우 IDE가 독립형 에이전트 도구 (예: Gemini CLI 또는 Claude Code)와 통합되어야 합니다. IDE를 에이전트에 연결하는 방법은 로컬 IDE의 문서를 참고하세요.
MCP 서버(예: 데이터베이스용 MCP 도구 상자)

AI 지원 워크플로에 대한 자세한 내용은 Looker를 사용한 AI 지원 개발 (바이브 코딩) 문서 페이지를 참고하세요.

시작하기 전에

확장 프로그램을 설치하기 전에 다음 요구사항을 충족해야 합니다.

AI 도구에 연결: AI 지원 개발을 사용하려는 경우 IDE와 AI 에이전트를 데이터베이스용 MCP 도구 상자에 연결합니다. 예를 들어 MCP 도구 상자를 Gemini CLI에 연결하기 위한 샘플 구성은 MCP, Gemini CLI, 기타 에이전트와 함께 Looker 사용 문서에 나와 있습니다. 자세한 내용은 도구의 문서를 참고하세요.
Looker 권한: 수정하려는 모든 모델에 대해 develop Looker 권한이 있어야 합니다.
Looker 인스턴스: 인스턴스에서 Looker 26.6 이상을 실행해야 합니다.
Git 설치: LookML 저장소를 클론하고 관리하려면 로컬 머신에 Git가 설치되어 있어야 합니다.
프로젝트 구성: LookML 프로젝트가 Git용으로 구성되어 있어야 합니다.
OAuth 클라이언트 ID: OAuth 인증 (권장)을 사용하는 경우 Looker 관리자로부터 OAuth 클라이언트 ID를 가져와야 합니다.

관리자 설정

조직에서 인증에 OAuth를 사용하는 경우 Looker 관리자는 Looker 관리 UI에서 VS Code용 Looker 확장 프로그램을 OAuth 클라이언트로 등록해야 합니다.

Looker API 탐색기를 사용하여 OAuth 통합을 설정합니다. 다음 방법 중 하나를 사용하여 API 탐색기에 액세스할 수 있습니다.

Looker 인스턴스에 API 탐색기가 이미 설치되어 있으면 다음 URL 형식을 사용하여 액세스할 수 있습니다.
```
https://LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/
```
Looker 인스턴스에 API 탐색기가 없는 경우 Looker Marketplace에서 설치할 수 있습니다. 자세한 내용은 API 탐색기 사용 페이지를 참고하세요.

확장 프로그램을 등록하려면 다음 단계를 완료하세요.

OAuth 클라이언트 애플리케이션 등록 문서의 안내에 따라 확장 프로그램을 등록합니다.
client_guid 필드에서 다음 단계를 완료합니다.
- 전역적으로 고유한 ID를 사용합니다.
- 확장 프로그램을 사용하려는 모든 LookML 개발자에게 ID를 배포할 준비를 합니다.

redirect_uri의 경우 다음을 사용합니다.

vscode://google.vscode-looker-official/oauth_callback

display_name 및 description을(를) OAuth 클라이언트 애플리케이션 등록 문서에 설명된 대로 작성합니다.

앱이 등록되면 API 탐색기가 등록 요약이 포함된 응답을 반환합니다. client_guid와 함께 OAuth 클라이언트 앱 가져오기 엔드포인트를 사용하여 등록 세부정보를 검토할 수 있습니다.

생성된 client_guid를 개발자에게 제공합니다. 개발자는 확장 프로그램을 구성할 때 이 ID를 사용합니다.

확장 프로그램 설치

확장 프로그램을 설치하려면 다음 단계를 완료하세요.

Visual Studio Marketplace에서 VS Code용 Looker 확장 프로그램을 설치합니다.
VS Code 또는 커서와 같은 IDE를 엽니다.
작업 표시줄에서 확장 프로그램 아이콘을 클릭합니다.
VS Code용 Looker 확장 프로그램 을 찾아 설치 를 클릭합니다.
확장 프로그램이 설치되면 작업 표시줄에 Looker 아이콘이 표시됩니다.

확장 프로그램 구성

작업공간의 settings.json 파일에서 Looker 인스턴스 세부정보로 확장 프로그램을 구성해야 합니다.

작업공간이 열린 상태에서 명령어 팔레트(Command-Shift-P(Mac) 또는 Ctrl+Shift+P(Windows/Linux))를 엽니다.
기본 설정: 작업공간 설정 열기 (JSON) 를 검색하여 선택합니다.
설정에 구성 변수를 추가합니다. 구성 변수는 인증 방법이 OAuth인지 API 사용자 인증 정보인지에 따라 다릅니다.

OAuth로 인증 (권장)

OAuth 2.1은 권장되는 인증 흐름입니다. 작업공간 settings.json 파일에 이러한 설정을 붙여넣습니다.

{
  "looker.instanceUrl": "https://YOUR_INSTANCE_URL",
  "looker.oauthClientId": "YOUR_OAUTH_CLIENT_ID",
  "looker.projectId": "YOUR_PROJECT_ID"
}

다음을 바꿉니다.

https://YOUR_INSTANCE_URL: Looker 인스턴스의 URL입니다.
YOUR_OAUTH_CLIENT_ID: Looker 관리자로부터 받은 OAuth 클라이언트 ID (client_guid)입니다.
YOUR_PROJECT_ID: 수정하려는 프로젝트의 이름입니다. Looker 인스턴스 내에서 LookML 프로젝트 페이지를 열어 찾습니다. 프로젝트 ID는 프로젝트 열에 있습니다.

API 사용자 인증 정보로 인증

Looker API 키를 사용하려면 문서를 따라 API 사용자 인증 정보를 만드세요. 프로젝트 ID도 제공해야 합니다.

{
  "looker.instanceUrl": "https://YOUR_INSTANCE_URL",
  "looker.clientId": "YOUR_CLIENT_ID",
  "looker.clientSecret": "YOUR_CLIENT_SECRET",
  "looker.projectId": "YOUR_PROJECT_ID"
}

다음을 바꿉니다.

https://YOUR_INSTANCE_URL: Looker 인스턴스의 URL입니다.
YOUR_CLIENT_ID 및 YOUR_CLIENT_SECRET: 인증에 사용하는 API 사용자 인증 정보의 클라이언트 ID 및 클라이언트 보안 비밀번호입니다. 이러한 사용자 인증 정보를 찾으려면 Looker 인스턴스 내에서 계정 페이지를 열고 API 키 섹션에서 관리 버튼을 클릭합니다. 그러면 클라이언트 ID와 보안 비밀번호를 볼 수 있는 API 키 페이지가 열립니다.
YOUR_PROJECT_ID: 수정하려는 프로젝트의 이름입니다. 프로젝트 이름을 찾으려면 Looker 인스턴스 내에서 LookML 프로젝트 페이지를 엽니다. 프로젝트 ID는 프로젝트 열에 있습니다.

설정

IDE 작업공간에서 다음 MCP 설정을 구성할 수 있습니다.

설정	설명	기본값
`looker.instanceURL`	Looker 인스턴스의 기본 URL (예: `https://mycompany.looker.com`)	-
`looker.authURL`	OAuth 인증에 사용할 URL입니다. 인스턴스 URL과 다른 경우에만 설정합니다.	`looker.instanceURL`
`looker.sdkURL`	API 요청에 사용할 URL입니다. 인스턴스 URL과 다른 경우에만 설정합니다.	`looker.instanceURL`
`looker.oauthClientId`	Looker OAuth 클라이언트 ID입니다. OAuth에 필요합니다.	-
`looker.clientId`	Looker API 클라이언트 ID입니다. API 키 인증에 필요합니다.	-
`looker.clientSecret`	Looker API 클라이언트 보안 비밀번호입니다. API 키 인증에 필요합니다.	-
`looker.projectId`	Looker 프로젝트 ID입니다.	-
`looker.mcpServerUrl`	프록시할 외부 MCP 서버의 URL (예: `http://localhost:5000/mcp`)	-
`looker.acceptSelfSignedCertificates`	SSL 인증서 오류 (예: 자체 서명된 인증서)를 무시합니다. 경고: 이 옵션을 사용 설정하는 것은 권장되지 않습니다.	`false`
`looker.askBeforeOverwritingRemote`	충돌이 감지되면 원격 파일을 덮어쓰기 전에 항상 묻습니다.	`false`

Looker를 통해 인증

OAuth 인증을 사용하는 경우 로컬 IDE를 Looker 계정에 연결하려면 로그인해야 합니다.

명령어 팔레트를 엽니다.
Looker: 로그인 (OAuth) 명령어를 실행합니다.
브라우저를 열라는 메시지를 확인합니다.
브라우저에서 확장 프로그램이 Looker 계정에 액세스하도록 승인합니다.
승인 후 브라우저가 IDE로 다시 리디렉션됩니다. Looker에 로그인했습니다! 라는 알림이 표시됩니다.

LookML 프로젝트 클론

개발을 시작하려면 LookML 저장소를 로컬 머신에 클론해야 합니다.

VS Code에서 새 창을 엽니다.
명령어 팔레트를 열고 Git: 클론 을 선택합니다.
원격 Git 저장소의 URL (예: GitHub 또는 GitLab)을 입력하고 로컬 폴더를 선택합니다.
IDE에서 클론된 폴더를 엽니다.

확장 프로그램이 LookML 파일을 자동으로 감지하고 Looker 인스턴스의 개발 모드에서 체크아웃된 브랜치와 동기화를 시작합니다.

문제 해결

IDE의 출력 패널에서 확장 프로그램 로그를 볼 수 있습니다. 로그를 보려면 Looker 채널을 선택합니다. 자세한 로그를 보려면 명령어 팔레트를 열고 개발자: 로그 수준 설정 명령어를 실행한 후 디버그 또는 추적 을 선택합니다.

인증 오류: looker.instanceUrl 및 looker.oauthClientId가 올바른지 확인합니다. Looker의 리디렉션 URI가 정확히 일치하는지 확인합니다.
동기화 문제: 확장 프로그램 로그를 확인하여 동기화 문제를 해결합니다. 로그를 보려면 출력 패널을 열고 드롭다운 메뉴에서 Looker 를 선택합니다.
OAuth 중 잘못된 요청 응답: 로컬 네트워크에서 Looker 인스턴스에 액세스할 수 있고 인터넷 연결이 유효한지 확인합니다.

확장 프로그램에 문제가 발생하면 명령어 팔레트에서 개발자: 창 새로고침 명령어를 실행하여 문제를 해결할 수 있습니다.