---
title: "OpenCode Claude API 연결"
description: "OpenCode에서 1折AI Claude API 중계 주소, 키, 모델을 구성하는 튜토리얼. 프로토콜 선택, 구성 예제, 검증 단계 및 일반적인 오류를 포함합니다."
headingIds: {"OpenCode v1 구성":"section-1","OpenCode v2 구성":"section-2","연결 검증 및 문제 해결":"section-3","비용 및 기타 연결 방법":"section-4"}
---
OpenCode의 사용자 지정 공급자 기능을 사용하여 1折AI에 연결합니다. 먼저 [API 키 생성](/ko/docs/api-keys/)을 하고 [현재 사용 가능한 모델](/ko/docs/models/)을 확인하세요. 아래 모델 ID는 예시이므로 키 권한에 맞게 조정하세요.
공식 구성 확인 날짜: 2026-10-15. 아래 구성은 공식 문서에 따라 정리되었으며, 이 사이트의 엔드투엔드 검증은 아직 완료되지 않았습니다. 긴 작업에 사용하기 전에 짧은 질의응답 및 도구 호출 검증을 먼저 완료하세요. OpenAI / GPT 모델이 출시되었으며, 모델 목록과 가격은 [모델 설명](/ko/docs/models/)을 참조하세요.
## OpenCode v1 구성
[공식 v1 Providers](https://opencode.ai/docs/providers/)에 따라: `/connect`을 실행하고 Other를 선택한 다음, provider ID에 `onezhe`을 입력하고 이 사이트의 API Key를 작성하세요. 프로젝트 `opencode.json`에 병합:
```json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"onezhe": {
"npm": "@ai-sdk/openai-compatible",
"name": "1折AI",
"options": { "baseURL": "https://1zheai.com/v1" },
"models": {
"claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
}
}
}
}
```
이후 `/models`에서 해당 provider의 모델을 선택하세요. `/connect`은 자격 증명만 저장하며 provider 구성을 대체하지 않습니다. 여기서는 Chat Completions용 SDK를 명시적으로 선택합니다. Responses용 `@ai-sdk/openai`로 잘못 교체할 수 없습니다. 공식적으로는 `options.apiKey: "{env:ONEZHE_API_KEY}"`을 통해 환경 변수를 참조하는 것도 허용됩니다.
## OpenCode v2 구성
[공식 v2 Providers](https://opencode.ai/v2/docs/providers)에 따라, 네이티브 v2 필드를 사용하며 위의 v1과 혼합해서는 안 됩니다. 프로젝트 `opencode.jsonc`에 병합:
```json
{
"$schema": "https://opencode.ai/config.json",
"providers": {
"onezhe": {
"name": "1折AI",
"env": ["ONEZHE_API_KEY"],
"package": "@opencode/ai/providers/openai-compatible",
"settings": { "baseURL": "https://1zheai.com/v1" },
"models": {
"claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
}
}
}
}
```
OpenCode를 시작하는 프로세스 환경에서 `ONEZHE_API_KEY`을 제공한 다음, `/models`에서 `onezhe/claude-sonnet-4-6`을 선택하세요. v2의 주요 차이는 `providers`, `package`, `settings`이며, v1의 `provider`, `npm`, `options`이 아닙니다. 사용 중인 메이저 버전은 먼저 `opencode --version`으로 확인하세요.
네이티브 Anthropic을 사용하려는 경우, v1 공식적으로는 `provider.anthropic.options.baseURL`을 재정의하는 것을 허용하며, 예제에는 `/v1`이 포함됩니다. v2는 `@opencode/ai/providers/anthropic-compatible`을 나열합니다. 이 튜토리얼은 명시적인 OpenAI 호환 구성을 따르므로, 모델 이름만으로 프로토콜을 임의로 교체하거나 캐싱 및 도구 호출이 모두 검증되었다고 주장할 수 없습니다.
## 연결 검증 및 문제 해결
1. 구성을 저장하고 다시 로드한 후, 현재 선택된 것이 `onezhe` 공급자 또는 추가한 사용자 지정 모델인지 확인하세요.
2. 짧은 질문 하나를 보내 응답이 반환되는지 확인한 다음, 되돌릴 수 있는 작은 작업을 시도하여 도구 호출과 다중 턴 대화를 별도로 확인하세요.
3. [호출 로그](/ko/docs/usage-logs/)를 열어 요청 시간, 모델, 상태 및 사용량을 확인하세요. 텍스트 응답이 한 번 성공했다고 해서 모든 Agent 기능이 호환된 것은 아닙니다.
4. 404가 발생하면 이 문서의 주소와 프로토콜이 맞는지 확인하세요. 401이 발생하면 키의 출처와 프로세스가 환경 변수를 읽었는지 확인하세요. 429가 발생하면 속도 제한 정보를 확인한 후 재시도하세요. 자세한 내용은 [오류 코드 및 문제 해결](/ko/docs/troubleshooting/)을 참조하세요.
키는 로컬 환경 또는 도구의 자격 증명 저장소에만 저장하며, 코드 저장소, 스크린샷 또는 공개 로그에 커밋하지 마세요. 백그라운드 서비스는 터미널 환경 변수를 상속하지 않을 수 있습니다. 보조 모델, 검색 및 기타 도구에는 별도의 공급자 설정이 있을 수 있으므로 각각 확인해야 합니다.
## 비용 및 기타 연결 방법
[Claude API 실시간 가격](https://1zheai.com/en/pricing/)과 [과금 규칙](/ko/docs/pricing-explained/)을 확인하세요. 다른 클라이언트가 필요하면 [도구 연결 디렉터리](/ko/docs/integrations/)로 돌아가세요. 직접 프로그램을 작성하려면 [SDK 및 개발 가이드](/ko/docs/guides/)를 사용하세요.