AI 제공자 설정 가이드

OpenCode 설정 가이드

OpenCode는 오픈소스 터미널 AI 코딩 어시스턴트입니다. 프로젝트 디렉터리 내에서 코드 질의응답, 파일 수정 및 모델 전환에 적합합니다. 초보자라면 처음에 전체 JSON을 수동으로 작성하지 마시고, 내장된 연결 마법사를 먼저 사용하는 것을 권장합니다.

공식 정보 다운로드 및 문서는 공식 사이트를 기준으로 합니다.

OpenCode 공식 웹사이트 오픈소스 터미널 AI 코딩 어시스턴트 문서 설치, 인증 및 명령어 안내 AI 제공자(중간 사이트) 설정 참고 opencode.json 설정 방식 참고

도구 소개 및 용도

설정 파일 위치

운영체제	설정 파일 위치	설명
Windows	`C: \Users\YourUsername\. config\opencode\opencode.json`	파일이 없으면 새로 생성하세요
macOS / Linux	`~/. config/opencode/opencode.json`	파일이 없으면 새로 생성하세요

연결 마법사로 시작하기

OpenCode 연결 마법사

cd YOUR_TEST_PROJECT opencode /connect

OpenCode 모델 확인

cd YOUR_TEST_PROJECT opencode /models

수동 설정 시 주의사항

이용 중인 제공자(중간 사이트) 문서에서 OpenCode Provider 필드, Base URL 및 Key의 입력 위치를 명확히 안내하는 경우에만 설정 파일을 직접 수정하세요. 버전별로 필드가 다를 수 있으므로 다른 도구의 JSON 예시를 OpenCode에 그대로 복사해 넣지 마세요.

확인 항목	설명
Provider 유형	OpenAI, Claude, Gemini 등의 프로토콜을 혼용하지 마세요
Base URL	제공자가 OpenCode 또는 해당 프로토콜용으로 안내한 전체 주소를 입력하세요
Key	현재 Provider에 해당하는 API 키를 입력하세요
모델 이름	제공자 백엔드 대시보드에 나와 있는 모델 목록을 복사하세요

저장 후 테스트 방법

테스트 프로젝트 디렉터리로 이동한 후 opencode를 실행합니다.
먼저 /models를 실행하여 방금 설정한 모델이 정상적으로 표시되는지 확인합니다.
모델을 선택한 후 '다음 문장만 그대로 답해주세요: OpenCode 설정 성공'이라고 전송합니다.
처음에는 파일 수정을 맡기지 말고, 현재 디렉터리나 특정 파일을 설명해 보라고만 요청하세요.
실패할 경우 먼저 /connect로 돌아가거나 제공자 문서를 참고하여 provider, base URL, key, 모델 이름을 다시 확인하세요.

증상	우선 점검 사항	해결 방법
`/models`에 모델이 없음	제공자가 정상적으로 저장되었는지, 모델 목록 조회가 가능한지 확인	제공자 백엔드의 모델 ID / 모델 이름을 직접 수동 입력
연결 실패	Base URL이 현재 Provider 프로토콜에 맞는지 확인	Claude, Gemini, OpenAI 등의 엔드포인트 주소를 혼동하여 사용하지 마세요
설정 파일 오류	JSON 문법, 쉼표, 큰따옴표 확인	연결 마법사로 기본 설정을 먼저 생성한 후 소소하게 수동 수정하세요.

OpenCode 공식 웹사이트 설치, 인증 및 명령어 안내 보기

OpenCode AI 제공자 설정 참고 opencode.json 설정 방식 참고