GitHub Copilot 설정

VS Code 확장 프로그램 OAI Compatible Provider for Copilot을 사용하여 OfoxAI를 GitHub Copilot Chat에 연동하면, 익숙한 에디터에서 Claude, GPT-4o, Gemini 등 100개 이상의 모델을 사용할 수 있습니다.

이 확장 프로그램은 GitHub Copilot 개인용(Individual) 구독이 필요하며, Copilot Business 및 Enterprise 사용자는 지원되지 않습니다. Copilot 구독이 없다면 Cursor 또는 Cherry Studio 사용을 권장합니다.

사전 요구 사항

OfoxAI 계정 등록 및 API Key 발급 완료（여기서 발급받기 ）
VS Code 설치 완료
유효한 GitHub Copilot 개인용(Individual) 구독（Business / Enterprise 미지원）

설정 단계

1단계: 확장 프로그램 설치

VS Code 확장 프로그램 마켓플레이스에서 OAI Compatible Provider for Copilot（작성자: Johnny Zhao）을 검색하고 Install을 클릭하여 설치합니다.

OAI Compatible Provider for Copilot 확장 프로그램 설치

2단계: 설정 UI 열기

Cmd+Shift+P（macOS）/ Ctrl+Shift+P（Windows/Linux）를 눌러 명령 팔레트를 열고 다음을 입력한 후 실행합니다:


OAICopilot: Open Configuration UI

명령 팔레트를 통해 설정 UI 열기

3단계: 전역 설정 입력

Global Configuration 섹션에 다음 내용을 입력한 후 Save Global Configuration을 클릭하여 저장합니다:

설정 항목	값
Global Base URL	`https://api.ofox.ai/v1`
Global API Key	발급받은 OfoxAI API Key

Global Base URL과 API Key 입력 후 저장

4단계: Provider 추가

Provider Management 섹션에서 Add Provider（① 표시）를 클릭하고, 새로 생긴 행에 다음 필드를 입력한 후 Save（⑥ 표시）를 클릭합니다:

필드	값
Provider ID（② 표시）	`ofox`
Base URL（③ 표시）	`https://api.ofox.ai/v1`
API Key（④ 표시）	발급받은 OfoxAI API Key
API Mode（⑤ 표시）	`Anthropic`

OfoxAI Provider 추가

5단계: 모델 추가

Model Management 섹션에서 Add Model（① 표시）을 클릭하고, 다음 필드를 입력한 후 Save Model（④ 표시）을 클릭합니다:

필드	값
Provider ID（② 표시）	`ofox`
Model ID（③ 표시）	모델 이름（예: `anthropic/claude-opus-4.5`）

커스텀 모델 추가

이 단계를 반복하여 여러 모델을 추가할 수 있습니다:


anthropic/claude-sonnet-4.6
anthropic/claude-opus-4.6
openai/gpt-4o
openai/gpt-4o-mini
google/gemini-3.1-flash-lite-preview

6단계: 채팅 패널에서 모델 선택

Copilot Chat 패널을 열고 모델 선택 영역을 클릭한 후 Auto 모드를 끄고, Other Models 아래에서 방금 추가한 OfoxAI 모델을 찾아 선택합니다.

모델이 보이지 않으면 **Manage Models…**를 클릭하여 모델 목록 페이지로 이동하세요.

채팅 패널에서 OfoxAI 모델로 전환

7단계: 모델 확인 후 사용 시작

Language Models 패널의 OAI Compatible 그룹 아래에 추가한 OfoxAI 모델이 표시됩니다. 우측 하단 채팅창에서 모델을 선택하면 대화를 시작할 수 있습니다.

OAI Compatible 그룹 아래에 모델이 표시되는지 확인

자주 묻는 질문

Q: 마켓플레이스에서 확장 프로그램을 찾을 수 없습니다

전체 이름 OAI Compatible Provider for Copilot으로 검색하거나, 작성자 이름 Johnny Zhao로 직접 검색해 보세요.

Q: 명령 팔레트에서 OAICopilot: Open Configuration UI를 찾을 수 없습니다

확장 프로그램이 설치되어 있고 활성화되어 있는지 확인하세요. 설치 후 VS Code 창을 다시 로드해야 할 수 있습니다（Cmd+Shift+P → Reload Window）.

Q: 추가한 모델이 채팅 패널에 표시되지 않습니다

모델 선택 드롭다운에서 Auto 모드를 끄고 Other Models 카테고리에서 확인하거나, **Manage Models…**를 클릭하여 모델이 올바르게 추가되었는지 확인하세요.

Q: 「Invalid API Key」 오류 또는 요청 실패

다음 사항을 확인하세요:

Global Base URL이 https://api.ofox.ai/v1인지（끝에 슬래시 없음）
API Key가 OfoxAI 콘솔 에서 완전히 복사되었는지（앞뒤 공백 없음）
Provider의 API Mode가 Anthropic로 설정되어 있는지

Q: 코드 자동 완성（Tab 완성）이 여전히 Copilot 공식 모델을 사용합니다

이는 정상적인 동작입니다. OAI Compatible Provider는 현재 Copilot Chat 대화 기능에만 영향을 미칩니다. Tab 코드 자동 완성은 GitHub Copilot이 공식적으로 제어합니다.

Q: Copilot Business / Enterprise 사용자도 사용할 수 있나요?

현재는 지원되지 않습니다. 이 확장 프로그램은 현재 GitHub Copilot 개인용(Individual) 사용자만 지원합니다. Business 및 Enterprise 사용자는 향후 버전의 지원을 기다려 주세요.

모델 ID	적합한 사용 사례
`anthropic/claude-sonnet-4.6`	코드 생성 및 리팩토링, 종합 능력 우수
`anthropic/claude-opus-4.6`	복잡한 아키텍처 분석, 최고 수준의 능력
`openai/gpt-4o`	범용 프로그래밍 어시스턴트
`openai/gpt-4o-mini`	빠른 응답, 일상적인 Q&A에 적합
`google/gemini-3.1-flash-lite-preview`	고빈도 사용, 빠른 속도