---
title: "Claude 및 GPT 도구 연동 튜토리얼"
description: "Claude Code, Codex CLI, OpenCode, OpenClaw, WorkBuddy, Hermes Agent, Cursor, Cline, Cherry Studio 및 CC Switch의 API 구성 튜토리얼과 지원 범위."
headingIds: {"프로그래밍 도구":"section-1","데스크톱 어시스턴트":"section-2","추가 클라이언트 및 가져오기 방식":"section-3","Agent 플랫폼":"section-4","구성 관리":"section-5","기타 사용자 지정 API를 지원하는 도구":"section-6","구성 성공 확인 방법":"section-7"}
---

<aside className="docs-publication" data-pagefind-ignore>

[1ZheAI](https://1zheai.com/en/editorial/#publisher)가 관리하는 문서입니다. [출처 및 수정 사항](https://1zheai.com/en/editorial/).

오류를 발견하셨나요? 페이지 주소와 설명을 첨부하여 [고객 지원](mailto:support@1zheai.com)으로 문의해 주세요. API 키나 계정 정보는 보내지 마세요.

</aside>
사용 중인 도구에 해당하는 튜토리얼로 이동하세요. 아래 상태는 기존 연동 문서를 정리한 것으로, 모든 도구 버전이 엔드투엔드로 검증되었다는 의미는 아닙니다. 도구를 업그레이드한 후에는 페이지의 호출 검증을 다시 완료하세요.

## 프로그래밍 도구

<CardGroup cols={2}>
 <Card title="Claude Code" href="/ko/docs/quickstart-claude-code/">Anthropic 네이티브 연동. 환경 변수, 구성 파일 및 자주 묻는 질문. </Card>
 <Card title="Codex CLI" href="/ko/docs/quickstart-codex/">Responses 인터페이스를 통해 OpenAI / GPT 모델 호출. </Card>
 <Card title="OpenCode" href="/ko/docs/quickstart-opencode/">v1과 v2 구성을 구분하고, OpenAI 호환 공급자를 사용자 지정. </Card>
 <Card title="Cursor · 사용 제한 있음" href="/ko/docs/quickstart-cursor/">OpenAI 호환 연동. 사용자 지정 키의 적용 범위와 인터페이스 차이를 먼저 확인하세요. </Card>
 <Card title="Cline" href="/ko/docs/quickstart-cline/">Anthropic 모드를 우선 사용하며, OpenAI Compatible 구성도 제공. </Card>
</CardGroup>

## 데스크톱 어시스턴트

<CardGroup cols={2}>
 <Card title="Cherry Studio" href="/ko/docs/quickstart-cherry-studio/">채팅 클라이언트에 사용자 지정 공급자 추가. </Card>
 <Card title="WorkBuddy" href="/ko/docs/quickstart-workbuddy/">모델 설정에서 사용자 지정 주소 추가, 전체 URL과 프로토콜 토글에 주의. </Card>
</CardGroup>

## 추가 클라이언트 및 가져오기 방식

<CardGroup cols={2}>
 <Card title="Chatbox · 원클릭 가져오기" href="/ko/docs/quickstart-chatbox/">가져오기 링크 또는 클립보드 JSON, 수동 백업 구성 지원. </Card>
 <Card title="RikkaHub · QR 코드 가져오기" href="/ko/docs/quickstart-rikkahub/">Android 공급자 QR 코드, 키 내용은 기본적으로 숨김. </Card>
 <Card title="ChatWise" href="/ko/docs/quickstart-chatwise/">사용자 지정 공급자 필드 및 모델 구성. </Card>
 <Card title="LibreChat" href="/ko/docs/quickstart-librechat/">관리자 YAML 엔드포인트 및 사용자별 독립 키. </Card>
 <Card title="CC Provider" href="/ko/docs/quickstart-cc-provider/">VS Code 확장의 Anthropic 구성. </Card>
</CardGroup>

원클릭 프로토콜은 클라이언트가 공개적으로 지원하는 작업에만 사용됩니다. ChatWise의 대화 열기 프로토콜은 키 가져오기와 같지 않으며, LibreChat은 관리자 구성이 필요합니다. 모든 도구를 동일한 가져오기 링크로 취급하지 마세요.

## Agent 플랫폼

<CardGroup cols={2}>
 <Card title="OpenClaw" href="/ko/docs/quickstart-openclaw/">사용자 지정 Anthropic 제공자 및 기본 Agent 모델 구성. </Card>
 <Card title="Hermes Agent" href="/ko/docs/quickstart-hermes/">모델 마법사 또는 명명된 provider를 통해 Chat Completions 구성. </Card>
</CardGroup>

<Note>OpenCode, OpenClaw, WorkBuddy 및 Hermes Agent 튜토리얼은 공식 구성을 확인했으나, 본 사이트의 엔드투엔드 검증은 완료되지 않았습니다. 튜토리얼에 따라 실제 버전을 확인하고 호출을 검증하세요. </Note>

## 구성 관리

<Card title="CC Switch" href="/ko/docs/quickstart-cc-switch/">Claude Code의 공급자 구성을 관리하여 수동 전환을 줄임. </Card>

## 기타 사용자 지정 API를 지원하는 도구

도구가 API 주소, 키 및 모델 ID를 설정할 수 있는지 먼저 확인한 다음, 프로토콜에 따라 구성을 선택하세요:

| 도구가 지원하는 프로토콜 | 본 사이트 인터페이스 | 다음 단계 |
| --- | --- | --- |
| Anthropic Messages | `/v1/messages` | 클라이언트가 `/v1`을 자동으로 추가하는지 확인하고, [주소 설명](/ko/docs/base-url/) 참조 |
| OpenAI Chat Completions | `/v1/chat/completions` | 일반적으로 Base URL에 `https://1zheai.com/v1` 입력; 전체 엔드포인트 필드는 예외 |
| OpenAI Responses | `/v1/responses` | Base URL에 `https://1zheai.com/v1` 입력, [Codex CLI](/ko/docs/quickstart-codex/) 참조 |
| 공식 계정 로그인만 지원 | 본 사이트 API 키 미사용 | 도구에 별도의 사용자 지정 공급자 설정이 있는지 확인 |

## 구성 성공 확인 방법

1. 튜토리얼에 따라 프로토콜과 Base URL을 선택합니다. 각 도구가 `/v1`을 필요로 하는지는 [주소 대조표](/ko/docs/base-url/) 참조.
2. [지원 모델](/ko/docs/models/)에서 현재 사용 가능한 모델을 선택합니다.
3. 짧은 요청을 하나 실행하여 도구가 정상적으로 응답하는지 확인합니다.
4. [호출 로그](/ko/docs/usage-logs/)에서 해당 호출을 확인합니다. 응답 내용만으로 요청이 어느 공급자를 거쳤는지 판단하지 마세요.

문제가 발생하면 먼저 [오류 코드 및 문제 해결](/ko/docs/troubleshooting/)을 확인하세요. 직접 프로그램을 작성할 때는 [개발 가이드](/ko/docs/guides/)으로 이동하세요.
