OpenCode API 키 설정

OpenCode API 키 설정: Base URL, 프로바이더 및 모델

서드파티 API와 함께 OpenCode를 사용하려면 API 키, base_url, 프로바이더 구성 세 가지가 필요합니다.

Claude, Kimi, GLM 등에 대해 종량제로 사용하세요: API 키를 발급받고 opencode.json에 base_url과 provider를 설정한 다음, 테스트 메시지로 확인하세요.

OpenCode가 설치되어 있습니다: 구성하세요 아직 설치되지 않았습니다: 설치부터 시작하세요

opencode.json 예시JSON

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "aicodewith-anthropic/claude-opus-5-5",
  "provider": {
    "aicodewith-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "AI Code With Anthropic",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "your-aicodewith-api-key"
      },
      "models": {
        "claude-opus-5-5": {
          "name": "Claude Opus 5.5"
        }
      }
    }
  }
}

OpenCode not installed?

This page configures the OpenCode terminal CLI. If opencode --version already prints a version, skip ahead to the quick setup.

Open the official OpenCode download page Already installed: continue

기본 설치 명령

curl -fsSL https://opencode.ai/install | bash

Or install globally with npm (this exact command is commonly searched)

npm install -g opencode-ai@latest

Installation succeeds when opencode --version prints a version number.

Continue with AI Code With Read the official installation docs

안전한 빠른 설정

모델을 선택하고, 구성을 복사하고, 파일을 저장한 뒤 약 3분 안에 연결을 검증하세요.

1. 모델 선택

현재 카탈로그에는 47개의 모델이 있습니다.

2. 구성 복사

프로바이더: aicodewith-anthropic
npm 어댑터: @ai-sdk/anthropic
Base URL: https://api.aicodewith.ai/v1
Model ID: claude-opus-5-5

{
  "$schema": "https://opencode.ai/config.json",
  "model": "aicodewith-anthropic/claude-opus-5-5",
  "provider": {
    "aicodewith-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "AI Code With Anthropic",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "your-aicodewith-api-key"
      },
      "models": {
        "claude-opus-5-5": {
          "name": "Claude Opus 5.5"
        }
      }
    }
  }
}

다음: 구성 저장

3. opencode.json 저장 및 API 키 설정

기존 opencode.json을 백업한 다음, 생성된 내용에서 모델과 프로바이더를 모두 병합하세요. 다른 프로바이더는 유지하고 실제 키는 로컬 환경 변수에만 저장하세요.

API 키 페이지 열기

구성 파일 저장

1. 시스템 터미널을 여세요
2. 아래 명령을 실행하여 구성 파일을 여세요(없으면 자동 생성됨):
```
notepad "$env:USERPROFILE\.config\opencode\opencode.json"
```
3. 2단계에서 복사한 구성을 붙여넣고 저장하세요
Windows/Linux에서는 Ctrl+S, macOS에서는 Cmd+S를 누르세요.

API 키 설정(your-key를 실제 키로 바꾸세요)

새 터미널을 열거나 셸 구성을 다시 로드한 다음 OpenCode를 재시작하세요.

4. 재시작 및 검증

시스템 터미널에서 실행opencode
OpenCode 내부에서 입력/models 프로바이더와 Model ID가 페이지 선택과 일치하는지 확인하세요
채팅에서 전송Reply with exactly: connection successful
OpenCode가 응답을 표시하는지 확인하고, AI Code With 사용 기록에서 해당 시간과 모델을 대조하세요

사용 기록은 요청이 AI Code With에 도달했음을 확인해 줍니다. 상태, 응답 내용, 실제로 OpenCode에 표시된 응답을 기준으로 성공 여부를 판단하세요.

구성이 로드되지 않았나요? 문제 해결

OpenCode는 서드파티 API에 어떻게 연결하나요?

OpenCode는 사용자 지정 Provider를 사용해 선택한 API 서비스로 요청을 보냅니다. Provider는 OpenCode에 어떤 서비스를 호출할지 알려주는 네임스페이스이고, API 키는 인증을 담당하며, Base URL은 서드파티 API 엔드포인트이고, Model ID는 실제 모델을 선택합니다.

저장한 뒤에는 요청이 OpenCode → Provider → Base URL → 모델 API 순서로 흐릅니다. /models 확인과 짧은 테스트 메시지 후, 시간과 모델을 기준으로 사용 기록에서 요청을 대조할 수 있습니다.

설정이 실패하면 먼저 이 4가지를 확인하세요

각 항목은 자세한 단계가 있는 전용 문제 해결 문서로 연결됩니다.

401 Unauthorized
자세한 문제 해결 보기 →
일반적으로 API 키가 유효하지 않거나, 잘못 입력되었거나, 올바르게 읽히지 않은 경우입니다. AICODEWITH_API_KEY가 여분의 공백 없이 설정되어 있고 OpenCode가 같은 터미널에서 시작되는지 확인하세요.
Model Not Found
자세한 문제 해결 보기 →
Model ID가 Provider 구성과 일치하지 않거나, 채널이 해당 모델을 지원하지 않습니다. 생성된 Model ID와 Provider 쌍을 문자 단위로 비교하세요.
Base URL / 404
자세한 문제 해결 보기 →
일반적으로 Base URL이 잘못되었습니다. 이 페이지에서 생성된 값을 복사하고 /v1, /v1beta를 덧붙이거나 엔드포인트 경로를 임의로 만들지 마세요.
구성이 적용되지 않음 / Provider 누락
자세한 문제 해결 보기 →
구성 파일 경로, JSON이 유효한지, OpenCode가 파일을 다시 로드했는지 확인하세요. 저장 후 OpenCode를 다시 열고 /models를 실행하세요.

자주 묻는 질문

Base URL은 무엇이어야 하나요?

위 빠른 설정에서 생성된 Base URL을 복사하세요. /v1 또는 /v1beta를 수동으로 덧붙이지 마세요.

OpenCode 구성 파일은 어디에 있나요?

이 페이지는 ~/.config/opencode/opencode.json을 생성합니다. 경로는 설치 방법과 버전에 따라 달라질 수 있으므로 현재 OpenCode 문서와 비교하세요.

설정이 작동하는지 어떻게 확인하나요?

/models를 실행해 모델을 선택하고, 짧은 메시지를 보낸 뒤 AI Code With 사용 기록에서 시간과 모델로 요청을 대조하세요.

어떤 모델이 지원되나요?

Claude, GPT, Gemini, DeepSeek, GLM, Kimi, Grok 등을 지원합니다. "모든 모델 보기"를 클릭해 전체 카탈로그를 찾아보세요.

전체 설치 또는 문제 해결 문서가 필요한가요?

전체 설치 가이드, 모든 구성 파라미터, 전체 모델 목록, 문제 해결은 OpenCode 설정 문서를 참조하세요.

OpenCode 설정 문서 열기