화면 설정
AI 서비스 연결
관련 STEP: STEP 01 버전 관리의 세 영역 · 환경 변수와 비밀 정보 부록
OpenCode에서 쓰던 모델의 사용량이 부족하거나 응답이 느릴 때 NVIDIA NIM의 무료 엔드포인트를 대체 모델로 붙일 수 있다. 이 부록은 build.nvidia.com에서 키를 받아 OpenCode의 /connect로 Nvidia를 연결하고, /models에서 모델을 고르는 순서를 정리한다.
ChatGPT와 GitHub
- ChatGPT에서 가입 또는 로그인한다. 계정과 요금제에 따른 제공 범위는 가입 화면에서 확인한다.
- 설정의 앱 또는 연결 메뉴에서 GitHub를 찾아 연결한다. GitHub 인증 화면에서 계정과 저장소 접근 범위를 확인하고 필요한 저장소만 허용한다. 메뉴와 제공 여부는 계정에 따라 다를 수 있다.
- 연결 후 허용한 저장소에 대해 질문할 수 있다. 연동을 중단하려면 ChatGPT 연결 설정과 GitHub의 애플리케이션 권한에서 접근을 해제한다.
코드가 외부 서비스에 전달될 수 있으므로 비밀 값, 개인정보와 공개 권한이 없는 자료를 입력하지 않는다. 조직 저장소는 관리자 정책과 데이터 처리 조건을 먼저 확인한다. 이슈는 GitHub 웹에서도 작성하고 관리할 수 있다.
학습 목표
- NVIDIA NIM을 대체 모델로 쓰는 상황을 설명할 수 있다.
- build.nvidia.com에서 API 키를 발급할 수 있다.
- OpenCode
/connect에서 Nvidia를 선택하고 키를 입력해 연결할 수 있다. /models에서 Nemotron 모델을 골라 응답을 확인할 수 있다.- 무료 엔드포인트의 사용량과 데이터 주의를 확인할 수 있다.
왜 필요한가
기본 모델만으로는 사용량이 부족하거나 응답이 느릴 수 있다. NVIDIA NIM은 OpenAI 호환 API를 제공하므로 OpenCode의 /connect 목록에서 연결할 수 있다. 다만 무료 엔드포인트는 속도·요청 한도가 있고 학습용 체험판 약관이 적용되므로, 상시 운영용이 아니라 필요할 때 쓰는 대체 수단으로 본다.
NVIDIA NIM이란
NIM은 NVIDIA Inference Microservices의 줄임말이다. NVIDIA가 호스팅하는 추론 엔드포인트이며, build.nvidia.com의 모델 페이지에서 무료 API를 제공한다. OpenAI 호환 경로는 https://integrate.api.nvidia.com/v1이다. 이 부록의 예시 모델은 NVIDIA 모델 ID가 nvidia/nemotron-3.5-lightning-30b-a3b인 Nemotron 3.5 Lightning 30B A3B다. 모델 페이지 기준 30B A3B MoE 모델이며 텍스트 입력·출력을 다루고 무료 엔드포인트가 제공된다.
가입과 API 키
- build.nvidia.com에서 계정을 만든다. 가입과 키 발급에는 휴대폰 인증이 필요하고 결제 카드는 필요 없다.
- 모델 페이지의
Prototype영역에서 API 키를 발급한다.Generate API Key를 누르거나 기존 키를 쓴다. - 키는 OpenCode의 자격 증명 입력 화면에 넣는다. 채팅·코드·설정 파일·Git 저장소에는 남기지 않는다.
OpenCode 연결
- OpenCode에서
/connect를 입력한다. - 공급자 목록에서
Nvidia를 고른다. - API 키를 붙여 넣는다. OpenCode가 자격 증명으로 저장한다.
/models를 입력하고 목록에서Nvidia공급자의Nemotron 3.5 Lightning 30B A3B를 고른다.- 짧은 질문을 보내 응답이 오는지 확인한다.
키를 따로 내보내거나 설정 파일에 공급자를 적을 필요가 없다. 연결과 모델 선택은 OpenCode 화면에서 끝낸다.
OpenCode V2 사용
작업할 폴더의 터미널에서 opencode를 실행한다. 공급자를 연결한 뒤 모델과 추론 수준을 고르고, 작업 권한을 확인한 다음 작은 요청부터 보낸다.
ChatGPT Plus·Pro는 /connect에서 OpenAI를 고르고 Sign in with ChatGPT로 로그인해 구독 사용량 안에서 이용할 수 있다. 사용 한도와 제공 여부는 계정에 따라 다르며 API 사용은 별도 과금이다. Claude 구독 인증은 Anthropic의 인증 정책에 따라 OpenCode 같은 외부 앱에 연결할 수 없으므로, Claude 모델을 쓰려면 /connect에서 Anthropic을 선택해 별도 과금되는 API 키를 연결한다. 메뉴와 명령은 버전에 따라 달라질 수 있으므로 아래 기본 키와 명령 목록, 공식 문서를 함께 확인한다.
| 입력 또는 키 | 하는 일 |
|---|---|
/connect | 공급자를 연결한다. |
/models | 현재 세션에서 사용할 모델을 고른다. |
Ctrl+T | 모델이 제공하는 추론 수준 variant를 순서대로 바꾼다. |
Ctrl+P | 명령 목록을 연다. |
Esc | 진행 중인 세션 작업을 중단한다. |
추론 수준은 모델마다 지원 여부와 선택지가 다르다. Ctrl+T는 기본 키이며 설정에 따라 달라질 수 있다. 권한 규칙은 V2 권한 문서에서 확인한다. 기본 설정은 많은 작업을 허용할 수 있으므로 파일 수정과 명령 실행 범위를 살피고, 승인 요청이 나오면 내용을 확인한 뒤 필요한 작업만 허용한다.
예를 들어 index.html 파일의 제목만 간단히 바꾸고 다른 파일은 수정하지 마처럼 범위를 좁혀 요청한다. 작업 뒤 터미널에서 git diff로 변경 내용을 확인한다. 이미 있던 변경도 함께 표시될 수 있으므로 요청 전 상태도 확인한다. API 키와 로그인 비밀은 대화나 교안에 적지 않고 공급자 인증 화면에만 입력한다.
모델 선택
/models목록에는 공급자 이름과 모델 표시 이름이 나온다.Nvidia공급자의Nemotron 3.5 Lightning 30B A3B를 고르면 모델 ID를 직접 입력하지 않아도 된다.- 고른 모델은 현재 세션에 적용된다. 설정 파일의 기본 모델은 바뀌지 않는다.
- 다른 NVIDIA 모델을 쓰려면 같은 목록에서 다른 모델을 고른다. 목록에 NVIDIA 모델이 없으면
/connect에서 Nvidia 연결을 확인한 뒤/models를 다시 연다. - 모델을 바꾼 뒤에는 짧은 질문으로 응답을 확인한다. 파일 읽기처럼 가벼운 작업부터 시험한다.
사용량과 데이터
- NVIDIA 모델 페이지 기준 무료 엔드포인트는 최대 40 rpm·하루 10,000 요청이다. 모델·트래픽에 따라 제한이 달라질 수 있고, 다른 사용자의 트래픽으로 느려질 수 있다. 상시 운영에는 전용 NIM 엔드포인트를 검토한다.
- 무료 체험은 NVIDIA API Trial Terms of Service가 적용된다. 모델 라이선스는 OpenMDW 1.1이다.
- NVIDIA는 체험 제공과 제품·모델 개선을 위해 입력·출력을 기록할 수 있다. 비밀 정보·개인정보·회사 내부 자료를 입력하지 않는다. 자세한 내용은 NVIDIA 개인정보 처리방침을 참고한다.
- 무료 한도·약관·데이터 정책은 바뀔 수 있으므로 사용 전에 모델 페이지와 약관을 다시 확인한다.
체크리스트
- build.nvidia.com 계정을 만들고 API 키를 발급했다.
- OpenCode
/connect에서Nvidia를 골라 키를 입력했다. -
/models에서Nemotron 3.5 Lightning 30B A3B를 골랐다. - 짧은 질문으로 응답을 확인했다.
- 키를 채팅·코드·설정 파일·저장소에 남기지 않았다.
주의할 점
- API 키를 채팅·코드·설정 파일·Git 저장소에 적지 않는다. OpenCode의 자격 증명 화면에만 넣는다.
- 무료 엔드포인트는 학습·체험용이다. 개인정보·비밀정보·회사 내부 자료를 입력하지 않는다.
- 무료 한도(40 rpm·10,000/일)와 약관은 바뀔 수 있다. 오류가 나면
/connect의 Nvidia 연결과/models의 모델 선택을 먼저 확인한다. - 모델 목록과 표시 이름은 카탈로그가 갱신되면 달라질 수 있다. 목록에서 NVIDIA 모델을 찾아 고른다.
복습 퀴즈
- OpenCode에서 공급자 계정을 연결하는 명령은 이다.
- 연결한 공급자의 모델을 고르는 명령은 이다.
/models에서 고른 모델이 적용되는 범위는 이다.