외부 도구를 OpenDesign Cloud API에 연결하기

필요한 연결 선택하기

제공업체 키를 OpenDesign로 가져오려면 BYOK 설정을 따르세요. 이 가이드에서는 반대 방향, 즉 Claude Code 또는 Codex 같은 외부 도구에서 OpenDesign Cloud 모델 API를 사용하는 방법을 설명합니다.

시작하기 전에

OpenDesign Cloud API는 Go, Plus, Pro 및 Max 플랜에서 이용할 수 있습니다. Free 플랜은 지원되지 않습니다. 계정의 Model 목록에 따라 사용할 수 있는 텍스트 모델이 결정됩니다. 스크린샷에 표시된 모델은 예시이며 모든 플랜에 제공되는 것은 아닙니다.

지원되는 에이전트는 Claude Code, Codex, Grok Build, OpenCode, OpenClaw, Hermes Agent입니다. 먼저 사용할 에이전트를 설치하세요. CC Switch가 이미 설치되어 있다면 설치 단계를 건너뛸 수 있습니다.

웹에서 API keys 열기

웹에서 OpenDesign 계정 관리에 로그인하고 사이드바에서 API keys를 선택하세요. 오른쪽 상단에서 One-click agent setup을 선택합니다. 기존 키가 없어도 시작할 수 있습니다.

수동으로 설정하려면 Connection setup(연결 설정)을 열고 도구에 필요한 API 형식(Chat Completions, Responses 또는 Messages)을 선택한 다음 해당 API base URL을 복사하세요. 엔드포인트와 프로토콜이 서로 일치해야 합니다. 아래 단계에서는 원클릭 가져오기 방법을 설명합니다.

1단계: CC Switch 설치 및 열기

1. One-click agent setup에서 Download for Mac 또는 Download for Windows를 선택하세요.
2. CC Switch를 설치하고 여세요. 이미 설치되어 있다면 이 단계를 건너뛰세요.

2단계: 에이전트와 모델 선택하기

1. 대상 에이전트를 선택하세요. 기본적으로 Claude Code가 선택되어 있습니다.
2. 요금제의 Model 목록에서 텍스트 모델을 선택하세요. 사용할 수 있는 모델이 없다면 다른 에이전트를 선택하거나 요금제를 확인하세요. 스크린샷에서 모델 이름을 복사해도 해당 모델에 대한 액세스 권한이 부여되지는 않습니다.

3단계: 가져오기 및 다시 시작하기

1. Import into CC Switch를 선택하세요. 그러면 Claude Code · Mac처럼 에이전트와 시스템의 이름을 딴 새 키가 생성되고 CC Switch가 열립니다.
2. 브라우저 메시지에서 Open CC Switch를 허용하세요. CC Switch에서 API Endpoint, 키, 모델을 검토한 다음 Import를 선택합니다.
3. 웹페이지로 돌아가 Done을 선택하거나, 다른 연결을 설정하려면 Set up another agent를 선택하세요.
4. 대상 에이전트를 다시 시작하세요. Claude Code의 경우 현재 세션을 종료하고 새 터미널에서 claude를 실행합니다.

원클릭 설정을 실행할 때마다 새 키가 생성되며 기존 키는 재사용할 수 없습니다. 기존 키에는 영향을 주지 않습니다. 이전 에이전트 구성은 CC Switch에서 계속 사용할 수 있습니다.

활성 연결 확인하기

1. 다시 시작한 에이전트에서 짧은 메시지를 보내고 응답하는지 확인하세요.
2. Claude Code에서는 /status를 실행하고 표시된 모델을 선택한 모델과 비교하세요. 다른 에이전트에서는 이에 해당하는 상태 보기를 사용합니다.
3. 웹의 API keys 페이지에서 새 키의 Last used 시간이 업데이트되는지 확인하세요.

이전 모델이 여전히 활성 상태라면 이전 세션을 닫고 에이전트를 다시 시작하세요. 브라우저에서 CC Switch가 열리지 않았다면 주소 표시줄 근처의 확인 메시지를 확인하고 CC Switch를 연 다음 Open을 다시 선택하세요. 이후에는 설정을 반복하지 않고 CC Switch에서 모델을 변경할 수 있습니다.

이전 설정으로 전환하거나 액세스 취소하기

CC Switch에서 에이전트의 이전 구성을 찾아 활성화하면 이전 설정으로 전환할 수 있습니다. CC Switch 구성을 제거해도 API 키가 비활성화되지는 않습니다. 키가 더 이상 작동하지 않게 하려면 웹의 API keys 페이지에서 키를 취소하세요.

현재 요금제와 모델 이용 가능 여부는 계정 페이지에서 확인하세요. 전체 녹화 영상과 스크린샷은 원클릭 에이전트 설정 튜토리얼을, 계정 설정은 구독 및 결제를 참조하세요.

API 호출은 앱 크레딧을 공유하나요?

예. 일반 API 호출은 앱과 요금제 허용량 및 사용량 기간을 공유합니다. 키를 추가로 생성하거나 에이전트를 전환해도 초기화되지 않습니다. 프로모션 크레딧에는 별도의 API 사용 자격 조건이 적용될 수 있습니다. 크레딧 및 사용량을 참조하세요.

키와 사용량을 관리하려면 Cloud 콘솔을 여세요. 사용자 지정 모델 엔드포인트와 키를 지원하는 Zcode 같은 도구는 일치하는 API 프로토콜에 맞게 구성할 수 있습니다. 그렇다고 해서 OpenDesign에서 해당 도구를 기본 제공 로컬 에이전트로 실행할 수 있다는 의미는 아닙니다.

이미지가 포함된 요청이 크기 제한을 초과하는 경우

현재 지원 지침에 명시된 API 요청 본문 제한은 50 MiB입니다. 이 제한은 이미지 각각이 아니라 전체 본문에 적용되며, 이미지를 인코딩하면 크기도 증가합니다. 이미지 수나 크기를 줄인 후 작은 요청으로 다시 시도하세요. 그래도 실패하면 키를 노출하지 말고 응답 상태, 요청 시간, 모델 정보를 지원팀에 제공하세요.