WorkBuddy Claude API 연결

WorkBuddy에서 1折AI Claude API 중계 주소, 키, 모델을 구성하는 튜토리얼로, 프로토콜 선택, 구성 예제, 검증 단계 및 일반적인 오류를 포함합니다.

WorkBuddy의 사용자 지정 공급자 기능을 사용하여 1折AI에 연결합니다. 먼저 API 키 생성을 하고 현재 사용 가능한 모델을 확인하세요. 아래의 모델 ID는 예제이므로 키 권한에 맞게 조정하세요.

공식 구성 확인 날짜: 2026-10-15. 아래 구성은 공식 문서에 따라 정리되었으며, 이 사이트의 엔드투엔드 검증은 아직 완료되지 않았습니다. 긴 작업에 사용하기 전에 짧은 질문-답변 및 도구 호출 검증을 완료하세요. OpenAI / GPT 모델이 출시되었으며, 모델 목록과 가격은 모델 설명을 참조하세요.

공식 모델 구성에 따라: 설정 → 모델 → 모델 추가 → 사용자 지정/Custom. 이 사이트의 키와 모델 claude-sonnet-4-6을 입력합니다.

전체 요청 주소 구성 방식 사용: 고급 설정에서 「사용자 지정 프로토콜」을 켜고, URL에 https://1zheai.com/v1/chat/completions을 입력한 후 저장하고 대화 모델 선택기에서 해당 모델을 선택합니다. 공식 설명에 따르면 이 스위치를 켜면 입력한 URL을 그대로 사용하며, 경로 검증 및 자동 완성을 하지 않습니다. 끌 때는 표준 /chat/completions에 따라 완성됩니다. 따라서 전체 URL과 스위치는 반드시 함께 설명되어야 합니다.

여기서의 「사용자 지정 프로토콜」은 OpenAI 요청을 Anthropic 요청으로 자동 변환할 수 있다는 의미가 아니며, /v1/messages을 입력한 후 네이티브 Claude 프로토콜이 연결되었다고 주장할 수 없습니다. UI를 우선 사용하며, 검증되지 않은 models.json 수동 형식은 제공하지 않습니다. 공식 페이지에는 현재 로컬 구성 경로와 이전 ~/.codebuddy/models.json 마이그레이션 설명이 함께 표시되므로, 이를 근거로 이전 경로를 일반적인 현재 경로로 작성하지 마세요. 화면의 도구 기능 표시도 이 사이트의 엔드투엔드 검증을 대체할 수 없습니다.

연결 검증 및 문제 해결

구성 저장 후 다시 로드하여 현재 선택된 것이 onezhe 공급자 또는 추가한 사용자 지정 모델인지 확인합니다.
짧은 질문 하나를 보내 응답이 반환되는지 확인한 후, 되돌릴 수 있는 작은 작업을 시도하여 도구 호출과 다중 대화를 별도로 확인합니다.
호출 로그를 열어 요청 시간, 모델, 상태 및 사용량을 확인합니다. 텍스트 응답이 한 번 성공했다고 해서 모든 Agent 기능이 호환된 것은 아닙니다.
404가 발생하면 본 문서의 주소와 프로토콜이 맞는지 확인하고, 401이 발생하면 키 출처와 프로세스가 환경 변수를 읽었는지 확인하며, 429가 발생하면 속도 제한 정보를 확인한 후 재시도합니다. 자세한 내용은 오류 코드 및 문제 해결을 참조하세요.

키는 로컬 환경 또는 도구의 자격 증명 저장소에만 저장하고, 코드 저장소, 스크린샷 또는 공개 로그에 커밋하지 마세요. 백그라운드 서비스는 터미널 환경 변수를 상속하지 않을 수 있습니다. 보조 모델, 검색 및 기타 도구에는 별도의 공급자 구성이 있을 수 있으므로 각각 확인해야 합니다.

비용 및 기타 연결 방식

Claude API 실시간 가격과 과금 규칙을 확인하세요. 다른 클라이언트가 필요하면 도구 연결 디렉터리로 돌아가세요. 직접 프로그램을 작성하려면 SDK 및 개발 가이드를 사용하세요.