메인 콘텐츠로 건너뛰기
OpenCode는 터미널용 AI 코딩 에이전트입니다. Venice는 OpenAI 호환 어댑터와 사용자 지정 base URL을 사용하여 OpenCode의 사용자 지정 제공자 구성을 통해 작동합니다.

사용자 지정 제공자

opencode.json에 Venice를 제공자로 추가

OpenAI 호환

Venice의 /chat/completions 엔드포인트 사용

환경 키

VENICE_API_KEY에서 API 키를 읽음

​
사전 요구 사항

​
설정

1

Venice API 키 설정

OpenCode를 실행하는 셸에서 Venice API 키를 내보냅니다:
export VENICE_API_KEY="your-api-key"
2

OpenCode 구성 파일 생성

프로젝트별 설정의 경우 프로젝트 루트에 opencode.json을 만듭니다.전역 설정의 경우 ~/.config/opencode/opencode.json을 대신 사용하세요.
3

Venice 제공자 추가

이 구성을 opencode.json에 붙여넣으세요:
{
  "$schema": "https://opencode.ai/config.json",
  "model": "venice/zai-org-glm-5-1",
  "small_model": "venice/zai-org-glm-5-1",
  "provider": {
    "venice": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Venice AI",
      "options": {
        "baseURL": "https://api.venice.ai/api/v1",
        "apiKey": "{env:VENICE_API_KEY}"
      },
      "models": {
        "zai-org-glm-5-1": {
          "name": "GLM 5.1"
        },
        "kimi-k2-5": {
          "name": "Kimi K2.5"
        },
        "minimax-m25": {
          "name": "MiniMax M2.5"
        }
      }
    }
  }
}
4

OpenCode 실행

동일한 프로젝트 디렉터리에서 OpenCode를 시작합니다:
opencode
OpenCode는 opencode.json을 로드하고, VENICE_API_KEY를 사용하며, 선택한 Venice 모델을 https://api.venice.ai/api/v1을 통해 라우팅합니다.

​
설정 확인

OpenCode 내에서 다음을 실행합니다: 
/models
구성의 Venice 모델이 표시됩니다. 하나를 선택한 다음 작은 테스트 프롬프트를 보내세요. 위와 같이 "model": "venice/zai-org-glm-5-1"을 설정했다면 OpenCode는 기본적으로 해당 Venice 모델을 사용해야 합니다. zai-org-glm-5-1을 텍스트 모델 카탈로그의 모델 ID로 바꾸고 models 맵에 추가하여 기본값을 변경할 수 있습니다.

​
구성 참고 사항

  • baseURL을 https://api.venice.ai/api/v1로 유지하세요. OpenCode의 OpenAI 호환 어댑터는 chat completions에 이 base URL을 사용합니다.
  • Venice의 OpenAI 호환 chat 엔드포인트를 위해 npm을 @ai-sdk/openai-compatible로 유지하세요.
  • 제공자 ID는 venice이므로 모델 참조는 venice/<model-id> 형식을 사용합니다.
  • OpenCode의 /connect 흐름을 선호하는 경우, Other를 선택하고 제공자 ID로 venice를 사용하며, Venice API 키를 붙여넣고 구성에서 options.apiKey를 제거하세요.
OpenCode는 이미 @ai-sdk/openai-compatible을 통해 사용자 지정 제공자 baseURL 값과 OpenAI 호환 제공자를 지원합니다. Venice를 위해 OpenCode 코어 제공자 변경은 필요하지 않습니다.

​
리소스

Venice 텍스트 모델

사용 가능한 Venice 모델 ID

OpenCode 제공자 문서

사용자 지정 제공자 및 base URL 참조