Visual Studio Code 확장 프로그램 설치

watsonx Code Assistant

API 키를 생성하고 Microsoft Visual Studio Code 편집기에 watsonx Code Assistant 확장자를 추가합니다.

호환성

확장 프로그램은 Node.js 버전 22.15 이상을 사용하여 Visual Studio Code 1.101 이상과 호환됩니다.

Visual Studio Code 에서 Node.js 버전을 확인하려면 코드 메뉴를 클릭한 다음 정보 Visual Studio Code 를 선택합니다. Node.js 버전이 22.15 이상인지 확인하세요.

개발 컨테이너에 확장 프로그램을 설치하는 것은 지원되지 않습니다.

운영 체제:

macOS
Windows 11
Fedora Linux 41
Red Hat Enterprise Linux 8
Ubuntu 20.04

IBM Cloud API 키를 만듭니다

각 개발자는 사용자 이름과 비밀번호 대신 개인 API 키를 사용하여 로그인합니다.

API 키를 만들려면 다음과 같이 하세요:

IBM Cloud API 키 에 로그인하세요.

조직의 watsonx Code Assistant 인스턴스가 프로비저닝된 IBM Cloud 계정을 사용하고 있는지 확인하십시오.
작성을 클릭하십시오.
API 키의 이름으로 ' IBM watsonx Code Assistant API key '을 입력합니다. 선택적으로 설명을 입력하십시오.
작성을 클릭하십시오.
다운로드 또는 복사를 클릭하고 API 키를 안전한 위치에 저장합니다.

키는 296초 동안만 사용할 수 있습니다. 나중에 찾을 수 있는 곳에 보관하십시오.

확장 설치

사용 중인 요금제에 맞는 설치를 선택합니다.

플랜 설명
계획	설명	확장기능 이름	디스플레이 언어 지원
평가 계획	코드용 통합 생성 AI 채팅이 포함된 무료 평가판이 제한적으로 제공됩니다.	watsonx Code Assistant	영어 (`en`), 일본어 (`ja`), 한국어 (`ko`)
Essentials 플랜	코드 제안, 코드 설명, 코드 문서화 및 단위 테스트를 위한 통합 생성 AI를 제공합니다.	watsonx Code Assistant	영어 (`en`), 일본어 (`ja`), 한국어 (`ko`)
Standard 플랜	Essentials 요금제의 모든 기능에 엔터프라이즈 Java 현대화 기능, 향상된 코드 설명, 향상된 단위 테스트 생성 및 검색 증강 생성(RAG)이 추가됩니다. 표준 요금제 설치의 경우 Visual Studio Code 확장 프로그램 패널에 두 개의 항목이 나타납니다 watsonx Code Assistant 와 watsonx Code Assistant for Enterprise Java Applications. 두 개의 확장 프로그램은 이 설치에 대한 종속성입니다. watsonx Code Assistant 버전 1.6.2 이상 및 1.1.0 버전 watsonx Code Assistant for Enterprise Java Applications 이상이 필요합니다.	watsonx Code Assistant for Enterprise Java Applications	영어 (`en`) 전용

전체 요금제에 대한 자세한 내용은 다음을 참조하세요:

Visual Studio 마켓플레이스에서

Visual Studio 마켓플레이스에서 설치하려면

사용 중인 요금제에 맞는 설치를 선택합니다.
- [체험판]플랜{: tag-magenta}[에센셜]플랜{: tag-green} 체험판 및 에센셜 플랜에 설치하려면 Visual Studio 마켓플레이스에서watsonx Code Assistant 페이지를 엽니다.
- 표준 플랜 표준 플랜으로 설치하려면 Visual Studio 마켓플레이스에서watsonx Code Assistant for Enterprise Java Applications 페이지를 엽니다.
마켓플레이스 페이지에서 설치를 클릭합니다.
Visual Studio Code 확장 프로그램 설치를 클릭합니다.

Visual Studio Code 에디터에서

Visual Studio Code 편집기에서 설치하려면

Visual Studio Code 편집기에서 확장 프로그램 아이콘을 클릭합니다.
사용 중인 요금제에 맞는 설치를 선택합니다:
- 평가판 요금제 [에센셜 요금]제{: tag-green} ' 평가판 및 에센셜 요금제에 설치하려면 ' watsonx Code Assistant'을 검색하세요.
- 표준 플랜 표준 플랜을 설치하려면 watsonx Code Assistant for Enterprise Java Applications 를 검색하십시오.
필요한 확장 프로그램을 선택한 다음 설치를 클릭합니다.

확장 프로그램 열기

watsonx Code Assistant 열려면:

아이콘을 클릭합니다 watsonx Code Assistant 클릭합니다.
API 키로 로그인을 클릭한 다음 IBM watsonx Code Assistant API 키를 입력합니다.

계정이 두 개 이상의 IBM Cloud 데이터 센터와 연결되어 있는 경우 위치도 선택하세요.

엔터프라이즈 Java 환경 설정

표준 요금제 표준 요금제를 사용 중이고 엔터프라이즈 Java 애플리케이션으로 작업하려면 환경을 설정해야 합니다. 자세한 내용은 엔터프라이즈 Java 환경 설정하기를 참조하세요.

HTTP 프록시 설정 업데이트

조직에서 HTTP 프록시 서버를 사용하는 경우, 올바르게 연결할 수 있도록 Visual Studio Code 설정을 업데이트해야 합니다. 연결을 시도할 때 콘솔 오류가 발생할 수 있으며 이 설정이 누락되었습니다.

Visual Studio Code 의 설정에서 http.proxy 설정을 엽니다.
HTTP 프록시 서버의 URL 을 https://proxy_server:port 형식으로 입력합니다. http://user:pass@proxy_server:port 와 같은 인증 정보를 포함해야 할 수도 있습니다.

사용자 지정 인증서에 대한 확인 설정

프록시 서버에서 사용자 지정 인증서를 사용하는 경우 Visual Studio Code 에 대한 확인을 구성해야 합니다. 다음 단계를 수행하십시오.

서버 SSL 인증서를 내보내려면:

Google Chrome 를 사용하여 IBM Cloud 에서 watsonx Code Assistant 인스턴스를 엽니다.
브라우저에서 웹 주소 옆에 있는 사이트 정보 보기 아이콘을 클릭합니다.
연결이 안전합니다를 클릭한 다음 인증서가 유효합니다를 클릭하여 인증서 뷰어를 엽니다.
세부 정보를 클릭하고 프록시의 인증서를 선택한 다음 내보내기를 클릭합니다.

설정하려면 MacOS:

Spotlight를 사용하여 키체인 액세스를 검색하고 엽니다.
시스템을 클릭한 다음 인증서 탭을 클릭합니다.
인증서 파일을 인증서 탭으로 끌어다 놓습니다.
인증서를 마우스 오른쪽 버튼으로 클릭한 다음 정보 받기를 클릭합니다.
신뢰 섹션에서 이 인증서를 사용할 때를 Always Trust 로 설정합니다.
확장 프로그램을 다시 시작하여 변경 사항을 적용합니다. API 키를 사용하여 로그인할 수 있어야 합니다.

Windows용으로 설정하려면

Microsoft Management Console을 여십시오.
인증서(로컬 컴퓨터) > 신뢰할 수 있는 루트 인증 기관 > 인증서를 엽니다.
인증서를 마우스 오른쪽 버튼으로 클릭하고 모든 작업을 클릭한 다음 가져오기를 선택합니다.
세부 정보를 클릭하고 프록시의 인증서를 선택한 다음 내보내기를 클릭합니다.
Visual Studio Code 및 watsonx Code Assistant 확장자를 다시 시작하여 변경 사항을 적용합니다. API 키를 사용하여 로그인할 수 있어야 합니다.

설정 보안

IBM watsonx Code Assistant 추가적인 보안 제어를 제공하지 않습니다. 다음 단계에 따라 설정을 올바르게 보호하세요.

Visual Studio Code 환경

Visual Studio Code 의 모든 업데이트를 적용하여 최신 보안 및 버그 수정을 받을 수 있도록 하십시오. 자세한 내용은 Microsoft 설명서를 참조하세요.

watsonx Code Assistant 확장 로그는 ' <your home directory>/.wca' 아래의 *.log 파일에 저장됩니다. 이러한 파일은 파일 시스템에서 제공하는 암호화 외에는 암호화되지 않습니다. 부적절한 액세스로부터 로그를 보호하세요.

채팅 대화 저장소

IBM watsonx Code Assistant <your home directory>/.wca/chat.db 의 파일 시스템에 모든 채팅 대화 내역을 로컬로 저장합니다 SQLiteIBM watsonx Code Assistant 는 이러한 대화를 누구와도 공유하지 않습니다. 이 파일은 파일 시스템에서 제공하는 암호화 외에는 암호화되지 않습니다. 부적절한 액세스로부터 이 파일을 보호하세요.

원격 측정 데이터

IBM watsonx Code Assistant 원격 측정 데이터를 수집하지 않습니다. 일반적으로 watsonx Code Assistant 처리하는 데이터를 제3자에게 보내지 않으며, 여기에는 IBM 포함됩니다.

API 키 로그아웃하기

필요한 경우 API 키에서 로그아웃할 수 있습니다. 로그아웃 후 API 키를 다시 입력하면 인증 관련 문제를 해결하는 데 도움이 될 수 있습니다.

로그아웃하려면:

Visual Studio Code 계정 아이콘을 클릭합니다.
사용자 이름(WCA API 키) 설정을 클릭한 다음 로그아웃을 클릭합니다.

출력 보기를 사용하여 활동 세부 정보 보기

Visual Studio Code 출력 보기를 사용하여 확장 프로그램이 수행 중인 작업 및 로깅에 대한 세부 정보를 확인하고 오류를 확인할 수 있습니다.

출력 보기를 열려면 다음과 같이 하세요:

Visual Studio Code 보기를 클릭한 다음 출력을 클릭합니다.
출력 보기에서 드롭다운 목록을 사용하여 WCA 또는 WCA 언어 서버를 선택합니다. 둘 다 확장 기능이 수행하는 작업에 대한 자세한 내용을 제공합니다.

Visual Studio Code 확장에 대한 출력 보기 및 로깅을 조정합니다:

Visual Studio Code watsonx Code Assistant 확장 설정을 엽니다.
Wca: 로그 수준에서 기본값인 INFO 에서 WARN 과 같은 다른 설정으로 전환합니다.

확장 프로그램 비활성화 또는 제거하기

필요한 경우 확장 프로그램을 비활성화하고 설치한 상태로 유지하거나 완전히 제거할 수 있습니다.

확장 프로그램을 비활성화하거나 제거하려면 다음과 같이 하세요:

Visual Studio Code 확장 아이콘을 클릭하여 패널을 엽니다.
watsonx Code Assistant 확장자를 클릭합니다.
사용 안 함 또는 제거를 클릭합니다.

표시 언어 변경하기

watsonx Code Assistant 확장자는 영어(en), 일본어(ja), 한국어(ko)로 제공됩니다.

watsonx Code Assistant for Enterprise Java Applications 확장자는 영어로만 제공됩니다(en).

표시 언어를 변경하려면 다음과 같이 하세요:

Visual Studio Code 에서 보기를 클릭한 다음 명령 팔레트를 클릭합니다.
display 을 검색한 다음 표시 언어 구성을 클릭합니다.
영어(en), 일본어(ja) 또는 한국어(ko) 중 하나를 선택하세요.

자세한 내용은 Visual Studio Code 문서에서 언어 표시를 참조하세요.