Source: https://aiprimetech.io/ko/learn/use-claude-api-with-github-copilot/ [홈](/ko/) / [학습](/ko/learn/) / 게이트웨이를 통해 GitHub Copilot Chat에서 Claude 사용하기: 사용자 지정 엔드포인트 설정, 에이전트 모드 및 문제 해결 # 게이트웨이를 통해 Claude와 함께 사용하는 GitHub Copilot Chat: Custom Endpoint 설정, 에이전트 모드 및 문제 해결 VS Code의 채팅은 직접 연결한 모델로 실행할 수 있습니다. 내장 Anthropic 공급자는 API 키만 입력할 수 있고 다른 주소를 지정하는 필드가 없으므로, 사용자 지정 엔드포인트 공급자를 통해 게이트웨이를 추가합니다. Messages API 유형을 선택하고 다음 파일에 모델을 나열하세요 chatLanguageModels.json. 이 기능은 버전 1.122부터 VS Code 안정 버전에 포함되어 있습니다. ## 자체 키 사용이 지원하는 범위 | 기능 | 자신의 모델 사용 시 | 채팅, 질문 및 계획 | 예 | 에이전트 모드, 내장 도구 및 MCP 서버 | 예, 모델에 다음 표시가 있는 경우 toolCalling: true | 인라인 제안(코드 완성) 및 다음 편집 제안 | 아니요. 이 기능은 여전히 GitHub Copilot에서 제공됩니다 | 의미 기반 검색 및 기타 임베딩 기반 기능 | 아니요. 이 기능은 여전히 GitHub 계정이 필요합니다 VS Code 1.122부터는 GitHub에 로그인하거나 Copilot 요금제에 가입하지 않아도 이 모델들을 사용할 수 있습니다. Copilot Business와 Enterprise에서는 BYOK이 기본적으로 켜져 있으며, 관리자는 **자체 언어 모델 키 사용** 정책으로 이를 끌 수 있습니다. ## 게이트웨이를 사용자 지정 엔드포인트로 추가 - 채팅 뷰를 열고 모델 선택기를 연 다음 **언어 모델 관리**를 선택하거나, 명령 팔레트에서 **채팅: 언어 모델 관리**를 실행하세요. - **모델 추가**를 선택한 다음 **사용자 지정 엔드포인트** 공급자를 선택하세요. - 표시 이름과 게이트웨이 API 키를 입력하세요. - API 유형으로 **Messages**를 선택하세요. 그러면 VS Code가 다음 파일을 엽니다. chatLanguageModels.json 모델 목록을 설정하는 파일입니다. ## chatLanguageModels.json chatLanguageModels.json복사 ``` [ { "name": "AI Prime Tech", "vendor": "customendpoint", "apiKey": "${input:aiprimeApiKey}", "apiType": "messages", "models": [ { "id": "claude-sonnet-5", "name": "Claude Sonnet 5", "url": "https://aiprimetech.io/v1/messages", "toolCalling": true, "vision": true, "maxInputTokens": 200000, "maxOutputTokens": 32000 }, { "id": "claude-opus-5-5", "name": "Claude Opus 5.5", "url": "https://aiprimetech.io/v1/messages", "toolCalling": true, "vision": true, "maxInputTokens": 200000, "maxOutputTokens": 32000 }, { "id": "claude-haiku-4-5", "name": "Claude Haiku 4.5", "url": "https://aiprimetech.io/v1/messages", "toolCalling": true, "vision": true, "maxInputTokens": 168000, "maxOutputTokens": 32000 } ] } ] ``` | 항목 | 이유 | id | 게이트웨이로 전송되는 모델 ID | url | 전체 엔드포인트입니다. VS Code는 다음으로 끝나는 URL을 /messages 그대로 사용합니다. 경로를 추측할 필요가 없도록 전체 경로를 지정하세요. | toolCalling: true | 에이전트 모드에 필요합니다. 이 기능이 없는 모델은 에이전트용 목록에 표시되지 않습니다. | maxInputTokens + maxOutputTokens | 두 값의 합이 모델의 컨텍스트 윈도우를 초과해서는 안 됩니다. | apiKey: ${input:...} | VS Code는 키를 한 번 요청한 뒤 저장하므로 파일에 키가 기록되지 않습니다. Messages 유형을 사용하면 VS Code는 키를 다음 헤더로 전송합니다. x-api-key 이 헤더는 게이트웨이가 기대하는 형식입니다. 모델 ID는 게이트웨이의 ID와 정확히 일치해야 합니다. ## 동일한 키로 사용하는 GPT 모델 Custom Endpoint 공급자는 OpenAI 형식도 지원합니다. 게이트웨이의 Codex 그룹에 속한 키로 GPT 모델을 추가하려면, 다음 설정으로 두 번째 공급자를 추가하세요. "apiType": "chat-completions" 모델 URL은 다음으로 설정하세요. https://aiprimetech.io/v1/chat/completions. 키는 자신이 속한 그룹의 모델에만 접근할 수 있으므로, Claude와 GPT에는 보통 별도의 키를 사용하는 별도 항목이 필요합니다. 기존의 github.copilot.chat.customOAIModels 설정과 **OpenAI Compatible** 공급자는 Custom Endpoint로 대체되어 사용이 중단될 예정입니다. 기존 항목을 다음으로 옮기세요. chatLanguageModels.json. ## 문제 해결 | 표시되는 내용 | 원인 | 해결 방법 | 모델이 선택 목록에 표시되지 않음 | 다시 로드해야 하거나, 다음 값이 toolCalling false이거나, 작업 영역이 제한 모드임 | VS Code를 다시 시작하고 다음을 설정하세요. toolCalling: true, 작업 영역을 신뢰하도록 설정하세요. | 공급자 목록에 Custom Endpoint가 없음 | VS Code 버전이 1.122보다 이전이거나, 조직에서 BYOK을 비활성화함 | VS Code를 업데이트하고 관리자에게 BYOK 정책에 대해 문의하세요. | 401 / 유효하지 않은 API 키 | 저장된 키가 잘못되었거나 다른 엔드포인트에 속함 | 공급자 옆의 톱니바퀴 아이콘을 클릭한 다음 **API 키 업데이트**를 선택하세요. | 지원되지 않는 모델 | 이 id 게이트웨이 모델 ID와 일치하지 않음 | 아래 표의 ID를 사용하세요. | 컨텍스트 또는 토큰 오류 | maxInputTokens 그리고 maxOutputTokens 컨텍스트 윈도우를 초과함 | 다음 값을 낮추세요. maxInputTokens | Concurrency limit exceeded | 하나의 키로 여러 에이전트나 창을 동시에 실행 중 | 병렬로 실행하는 수를 줄이세요. 자세한 내용을 확인하려면 **개발자: 로그 수준 설정**을 실행하고 **추적**을 선택한 다음, **출력**을 열고 **GitHub Copilot Chat**을 선택하세요. 채팅 디버그 보기에 정확한 요청이 표시됩니다. 정책에서 허용하지 않아 BYOK 공급자의 등록이 해제되었다는 로그 줄이 있다면 조직 정책이 원인입니다. | 모델 ID | 권장 용도 | claude-sonnet-5 | 코딩과 에이전트 작업의 기본 선택: 빠르고 성능이 뛰어나며 가격은 중간 수준입니다. | claude-opus-5-5 | 더 어려운 추론, 대규모 리팩터링, 장시간 에이전트 실행. | claude-fable-5-1 | 성능이 가장 뛰어나고 가격도 가장 높습니다. 가장 어려운 작업에 사용하세요. | claude-haiku-4-5 | 저렴하고 빠름: 제목, 요약, 분류, 간단한 단계. 터미널을 선호하시나요? 같은 키로 다음을 실행할 수 있습니다. [VS Code에서 Claude Code 사용](/ko/claude-code/vscode/) 전용 확장 기능을 통해 사용할 수 있습니다. ## 자주 묻는 질문 GitHub Copilot에서 제 Claude API 키를 사용할 수 있나요? 네. VS Code의 채팅에서 언어 모델 관리, 모델 추가를 차례로 선택한 다음, Anthropic 자체 API를 사용하려면 Anthropic 공급자를 선택하고, 게이트웨이를 사용하려면 Custom Endpoint를 선택해 API 유형을 Messages로 설정하세요. Copilot에서 Anthropic 기본 URL을 변경할 수 있나요? 키만 입력할 수 있는 기본 제공 Anthropic 공급자에서는 변경할 수 없습니다. Custom Endpoint 공급자를 사용하고 각 모델의 url을 게이트웨이의 /v1/messages 엔드포인트로 설정하세요. BYOK 모델은 Copilot 에이전트 모드에서 작동하나요? 네. 모델에 toolCalling: true가 설정되어 있으면 작동합니다. 기본 제공 도구와 MCP 서버는 계속 작동하며, 인라인 코드 완성은 여전히 Copilot에서 제공됩니다. 제 모델을 사용하려면 Copilot 구독이 필요한가요? VS Code 1.122부터는 필요하지 않습니다. BYOK 모델은 GitHub 로그인이나 Copilot 요금제 없이 작동합니다. Business 및 Enterprise 조직에서는 정책으로 이 기능을 비활성화할 수 있습니다. 몇 분 만에 Claude 사용 시작하기 API 키를 발급받으세요 — Anthropic 계정이나 대기자 명단 등록이 필요하지 않습니다.[API 키 발급받기](/register) AI Prime Tech는 독립적인 API 게이트웨이입니다. Anthropic과 제휴 관계가 없으며, Anthropic의 보증을 받거나 Anthropic의 리셀러로 활동하지 않습니다. Claude 및 관련 모델 이름은 각 소유자의 상표입니다. ## 더 많은 Claude API 가이드 [Claude API 키 발급 방법](/ko/learn/how-to-get-a-claude-api-key/)[Claude API 요금 해설](/ko/learn/claude-api-pricing-explained/)[Claude API를 가장 저렴하게 사용하는 방법](/ko/learn/cheapest-way-to-use-claude-api/)[Claude API로 Cursor 무제한 사용](/learn/use-claude-api-with-cursor/)[Claude Code 무제한 이용](/ko/learn/use-claude-api-with-claude-code/)[Claude API 게이트웨이와 Anthropic 직접 이용 비교](/ko/learn/claude-api-vs-anthropic-direct/)[OpenAI SDK로 Claude 사용하기: OpenAI 호환 엔드포인트, 스트리밍, 도구 및 제한](/ko/learn/openai-compatible-claude-api/)[Claude 모델 해설: Claude Opus, Sonnet, Haiku, Fable 비교 — 모든 Claude API 모델, Anthropic 모델 이름 및 가격 (2026)](/ko/learn/claude-api-models-compared/)[암호화폐로 Claude API 요금 결제하기](/ko/learn/claude-api-with-crypto-payment/)[대기 명단 없이 Claude API 이용하기](/ko/learn/claude-api-without-waitlist/)[Claude 토큰 사용량을 줄이는 방법](/ko/learn/how-to-reduce-claude-token-usage/)[Claude API로 Cline 무제한 사용](/ko/learn/use-claude-api-with-cline/)[Claude API로 Roo Code 무제한 사용](/ko/learn/use-claude-api-with-roo-code/)[JetBrains IDE에서 Claude 무제한 사용](/ko/learn/use-claude-api-with-jetbrains/)[게이트웨이를 통해 Claude와 함께 사용하는 Aider: ANTHROPIC_API_BASE, 구성 파일, architect 모드 및 문제 해결](/ko/learn/use-claude-api-with-aider/)[VS Code에서 Claude 무제한 사용](/ko/learn/use-claude-api-with-vscode/)[Claude용 OpenCode 구성: opencode.json 설정, 모델 및 일반적인 오류](/ko/learn/use-claude-api-with-opencode/)[게이트웨이를 통해 Claude와 함께 사용하는 Hermes Agent: 사용자 지정 제공업체 설정, 비용 관리 및 문제 해결](/ko/learn/run-hermes-agent-with-claude-api/)[Claude에서 OpenClaw 무제한 실행하기](/ko/learn/run-openclaw-with-claude-api/)[Anthropic 호환 API의 의미](/ko/learn/anthropic-compatible-api/)[Claude Code API 키 — ANTHROPIC_API_KEY: 발급 및 설정 방법과 대신 claude setup-token을 사용해야 하는 경우](/ko/learn/claude-code-api-key-setup/)[Claude Code API 비용 — 요금과 절감 방법](/ko/learn/claude-code-api-costs/)[Claude API 오류 설명: 서버 오류 500, 과부하 529, 사용량 제한 429, 잘못된 요청 400 — 각 오류의 해결 방법](/ko/learn/claude-api-errors-troubleshooting/)[Claude API 크레딧 구매 방법 — 그리고 Claude 크레딧이 어떤 "Claude 계정 구매" 상품보다 나은 이유](/ko/learn/buy-claude-api-credits/)[Claude 무료 API: 무료 Claude API 키가 있나요? 2026년에 실제로 무료인 것은 무엇인가요?](/ko/learn/claude-api-free-trial/)[Claude API와 Claude Pro/Max 구독 — 어떤 것을 선택할까요](/ko/learn/claude-api-vs-subscription/)[사용자 지정 제공업체와 함께 사용하는 Codex CLI: config.toml, GPT 및 Claude 모델, IDE 확장 프로그램 및 문제 해결](/ko/learn/use-claude-api-with-codex/)[Claude를 n8n에 연결하기](/ko/learn/use-claude-api-with-n8n/)[LiteLLM을 Claude로 라우팅하기](/ko/learn/use-claude-api-with-litellm/)[Kilo Code에서 Claude 사용하기](/ko/learn/use-claude-api-with-kilo-code/)[게이트웨이를 통해 Zed를 Claude에 연결하기](/ko/learn/use-claude-api-with-zed/)[Cherry Studio를 Claude에 연결하기](/ko/learn/use-claude-api-with-cherry-studio/)[LangChain의 ChatAnthropic: 가져오기, base_url, 스트리밍, 도구 및 오류](/ko/learn/use-claude-api-with-langchain/)[Anthropic Python SDK: 설치, base_url 설정, 스트리밍 및 오류 처리](/ko/learn/anthropic-python-sdk/)[Vercel AI SDK로 Claude 사용하기: createAnthropic baseURL, 스트리밍 및 문제 해결](/ko/learn/use-claude-api-with-vercel-ai-sdk/)[Claude로 Factory Droid 실행하기](/ko/learn/use-claude-api-with-factory-droid/)[Claude Code API 이해하기](/ko/learn/claude-code-api/)[애플리케이션에 Claude API 통합하기](/ko/learn/claude-api-integration/)[Claude를 무제한으로 사용하는 방법 — 그리고 "Claude Code 크랙 버전"이 없는 이유](/ko/learn/get-unlimited-claude-usage/)