연결

OpenCode

최종 업데이트: 2026년 10월 28일

OpenCode는 OpenAI 호환 공급자라면 무엇과도 함께 동작하는 오픈소스 터미널 코딩 에이전트입니다. 설정에 CoreCode 공급자를 추가하면 하나의 OpenCode에서 Claude, GPT, Grok, Gemini를 오가며 쓸 수 있습니다. 설정 내용은 OpenCode의 공급자 문서를 따릅니다.

설치

npm install -g opencode-ai

설치 후 opencode --version을 실행하세요. 버전 번호가 나오면 설치된 것입니다.

키 만들기

API 키 페이지에서 auto 그룹으로 키를 만드세요. OpenCode는 Claude Code가 아니므로 仅限CC 그룹은 요청을 거부합니다. Claude만 쓴다면 「Claude 满血（可外接）」도 사용할 수 있습니다.

설정

~/.config/opencode/opencode.json을 편집하고, 없으면 만드세요(프로젝트 디렉터리에 두면 그 프로젝트에만 적용됩니다).

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "corecode": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CoreCode",
      "options": {
        "baseURL": "https://corecode.live/v1",
        "apiKey": "{env:CORECODE_API_KEY}"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "claude-opus-5-5": { "name": "Claude Opus 5.5" },
        "gpt-6.1-sol": { "name": "GPT-6.1 Sol" },
        "grok-4.7": { "name": "Grok 4.7" },
        "gemini-3.8-flash-high": { "name": "Gemini 3.8 Flash" }
      }
    }
  }
}

models 아래의 이름은 요금 페이지와 일치해야 하며, 필요에 따라 추가하거나 빼도 됩니다. 그다음 키를 환경 변수에 넣으세요.

export CORECODE_API_KEY=sk-your-key

$env:CORECODE_API_KEY = "sk-your-key"

계속 유지하려면 이 줄을 ~/.zshrc나 ~/.bashrc에 추가하세요. Windows에서는 setx CORECODE_API_KEY sk-your-key를 실행하고 새 터미널을 여세요.

동작 확인

opencode run -m corecode/claude-sonnet-5-5 "reply ok"

ok가 출력되면 연결된 것입니다. OpenCode에서 /models를 입력하면 CoreCode의 모델이 보이고 서로 전환할 수 있습니다.

FAQ