외부 도구 연결
사용 중인 AI 도구에 게이트웨이 연결하기
도구가 사용하는 Messages, Responses 또는 Chat Completions 형식을 구분하고, 모델과 기본 URL, 인증 키의 도구별 설정 안내를 찾습니다.
페이지 목차
사용 중인 도구 선택하기
사용 중인 도구의 가이드를 열어 설정합니다. 도구마다 사용하는 API 형식이 다르므로, 선택한 모델이 그 형식을 지원하는지 함께 확인합니다.
| 도구별 설정 가이드 | 사용하는 API 형식 | 기본 URL |
|---|---|---|
| Claude Code | Anthropic Messages | https://gw.letsur.ai |
| Claude Desktop | Anthropic Messages | https://gw.letsur.ai |
| Codex CLI | Responses | https://gw.letsur.ai/v1 |
| opencode | Chat Completions(가이드 예제 기준) | https://gw.letsur.ai/v1 |
| ZeroClaw | Chat Completions(가이드 예제 기준) | https://gw.letsur.ai/v1 |
도구에서 모델의 텍스트 응답을 받으면 모델 연결이 성공한 것입니다. 실제 작업에 필요한 도구 호출, 파일 접근과 승인 동작은 각 도구의 가이드에서 별도로 확인하세요.
연결 전 확인 사항
AI 게이트웨이 API 키를 준비하고 에셋에서 정확한 모델 코드와 지원 API를 확인합니다. 도구가 요구하는 API 형식을 모델이 지원해야 합니다.
OpenAI 호환 형식과 Anthropic Messages 형식의 기본 URL은 서로 다릅니다. 형식별 값은 인증과 기본 URL에서 확인합니다. 주소를 입력하는 필드와 경로 조합은 도구마다 다르므로 앞의 표에 있는 도구별 가이드를 따르세요. API 키는 공개되는 설정 파일이나 저장소에 저장하지 마세요.
목록에 없는 도구 연결하기
먼저 그 도구의 문서에서 사용자 지정 base URL과 인증 헤더를 지원하는지 확인합니다. OpenAI 호환이라는 표기만으로 Responses, Chat Completions와 도구 기능이 모두 동작한다고 판단하지 마세요. 선택한 모델의 지원 API는 에셋에서 확인합니다.
도구에는 모델이 지원하는 API 형식에 맞는 기본 URL과 인증 헤더를 지정합니다. 다음 표의 값은 인증과 기본 URL의 표와 같습니다.
| API 형식 | SDK 기본 URL | 인증 헤더 |
|---|---|---|
| OpenAI 호환 | https://gw.letsur.ai/v1 | Authorization: Bearer <API_KEY> |
| Anthropic Messages | https://gw.letsur.ai | x-api-key: <API_KEY> 권장(Authorization도 가능), anthropic-version 함께 전송 |
Anthropic Messages 형식의 기본 URL에는 /v1을 추가하지 않습니다. Anthropic SDK는 /v1/messages를 내부에서 추가합니다. 기본 URL에 /v1을 다시 지정하면 요청 경로가 /v1/v1/messages가 되어 호출이 실패합니다.
도구별 설정과 지원 범위는 도구 업데이트에 따라 달라질 수 있습니다. 사용 중인 버전과 그 도구의 공식 문서를 함께 확인하세요.