OpenCode 설정 튜토리얼: NextHub API 연동

OpenCode는 멀티 모델 연동을 지원하는 터미널 AI 프로그래밍 도구입니다. 아래에서 NextHub의 Claude 채널에 연동하는 방법을 안내합니다.

연동 단계

1. OpenCode 설치

Node.js가 설치되어 있는지 확인한 뒤 OpenCode를 전역으로 설치하세요:

npm i -g opencode-ai

설치가 끝나면 먼저 한 번 실행하여 기본 설정 폴더를 생성하게 하세요:

opencode

2. OpenCode 설정 폴더 열기

Windows (CMD)

start "" "%USERPROFILE%\.config\opencode"

macOS (Terminal)

open "$HOME/.config/opencode"

3. opencode.json 편집 — Claude 설정 입력

설정 폴더에서 opencode.json을 찾아(없으면 새로 생성) OpenCode 공식 schema에 따라 provider.anthropic.options에 ApiKey와 NextHub 연동 주소를 입력하세요:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "당신의 NextHub ApiKey",
        "baseURL": "https://api.nexthub.cc"
      }
    }
  }
}

Base URL에는 /v1을 붙이지 마세요

OpenCode는 baseURL 뒤에 자동으로 /v1/messages를 붙이므로, 여기에는 루트 도메인인 https://api.nexthub.cc만 입력하면 되고 끝에 /v1을 추가하지 마세요.

4. 설정 성공 여부 확인

opencode를 실행하고 /models 명령어를 입력했을 때 목록에 Claude 모델이 나타나면 성공입니다:

opencode
# 대화형 인터페이스로 진입한 뒤 실행
# /models

GPT 채널에도 연동할 수 있습니다

같은 opencode.json에 openai 공급자를 추가하면 GPT / Codex 시리즈 모델을 사용할 수 있습니다:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "당신의 NextHub ApiKey",
        "baseURL": "https://api.nexthub.cc"
      }
    },
    "openai": {
      "options": {
        "apiKey": "당신의 NextHub ApiKey",
        "baseURL": "https://api.nexthub.cc/v1"
      }
    }
  }
}

두 주소의 규칙이 다릅니다

anthropic은 Anthropic 프로토콜을 사용하므로 baseURL에 루트 도메인 https://api.nexthub.cc를 입력하고(/v1/messages가 자동으로 붙습니다), openai는 OpenAI 호환 프로토콜을 사용하므로 baseURL에 /v1을 포함해야 합니다. 두 ApiKey는 각각 해당하는 그룹(Claude 시리즈 그룹과 GPT-Azure / GPT-Pro 그룹)을 선택하며, 같은 ApiKey를 사용할 수도 있습니다. 하지만 그룹이 사용 가능한 모델을 결정하므로, 일반적으로 분리하여 설정하는 편이 더 명확합니다.