CoreCode문서

연결

Claude Desktop 연결하기

Claude Desktop을 연결하는 방법은 두 가지이며, 어느 쪽도 Anthropic 공식 계정이 필요 없습니다. Magpie를 권장합니다. 앱을 설치한 뒤 Magpie에서 몇 번 클릭하면 모든 설정이 끝나며, 개발자 모드도 게이트웨이 주소 입력도 필요 없습니다. 약 10분이면 됩니다. Magpie를 설치하고 싶지 않다면 서드파티 추론 직접 구성하기를 따르세요.

Magpie로 연결하기 (권장)

아래 스크린샷은 중국어 인터페이스이며, 영어 인터페이스도 레이아웃은 같습니다.

  1. Claude Desktop 설치

    Claude Desktop 다운로드 페이지에서 내려받아 설치하세요. Windows 설치 프로그램에서 Download failed가 나오면 아래 설치를 참고하세요.

    실행한 뒤 시작 화면에 그대로 두세요. Get started를 누르지 말고 Claude 계정에도 로그인하지 마세요. 설정은 Magpie가 해 줍니다.

  2. auto 그룹에서 키 만들기

    API 키 페이지에서 Create API key를 누르고, 이름은 아무거나 정한 뒤 기본 그룹인 auto를 그대로 두세요. Magpie가 전달하는 요청은 Claude Code에서 직접 보낸 것이 아니므로 仅限CC 그룹은 고르지 마세요. auto에서는 Claude가 可外接 가격으로 과금됩니다. 자동 라우팅을 참고하세요.

    auto 그룹에서 API 키 만들기

  3. Magpie 설치

    Magpie 다운로드 페이지에서 내려받으세요. macOS, Windows, Linux에서 실행됩니다. Magpie는 CoreCode의 모델을 Claude Desktop에 설정해 주는 로컬 게이트웨이입니다.

  4. Magpie에 CoreCode 추가

    API 키 페이지로 돌아가 방금 만든 키의 Connect client를 열고, Claude Code 아래에서 Magpie를 선택한 뒤 Add to Magpie를 누르고, Magpie가 여는 창에서 확인하세요.

    Connect client의 Add to Magpie 버튼

    Magpie의 공급자 설정에서 쓰고 싶은 Claude 모델(Fable, Opus, Sonnet, Haiku)만 체크하세요.

    Magpie에서 Claude 모델 체크하기

    컨텍스트 윈도우를 512K, 압축 임계값을 500K로 설정하고 Save를 누르세요. 컨텍스트는 1M까지 늘릴 수 있지만, 대화가 길어질수록 매 턴 다시 보내는 양이 늘어 비용이 커지고 답변 품질도 떨어집니다.

    컨텍스트 윈도우 512K, 압축 임계값 500K

  5. Magpie에서 Claude Desktop 연결

    Magpie 상단의 Agent 탭으로 전환하고 Quick start → Connect an agent에서 Claude Desktop을 누르세요. Details에 방금 체크한 모델이 표시됩니다.

    Magpie 빠른 시작의 Claude Desktop

    Restart를 누르면 Claude Desktop이 다시 열리면서 곧바로 메인 화면으로 들어갑니다.

    연결된 Claude Desktop과 Restart 버튼
    Claude 계정에 로그인하지 마세요Magpie 설정이 끝나면 Claude Desktop은 로그인 없이 동작합니다.

  6. 모델을 고르고 대화 시작

    입력창 오른쪽 아래에서 모델을 바꿀 수 있습니다. Fable이 가장 강력하지만 가장 비싸고, 일상 작업에는 Opus나 Sonnet이 적당합니다. 메시지를 보낸 뒤 콘솔의 사용 로그에 요청이 나타나면 연결된 것입니다.

    Claude Desktop의 모델 선택기

Code 모드

왼쪽 위의 스위치로 Cowork와 Code를 전환합니다. Code 모드는 컴퓨터의 파일을 읽고 쓰며 명령을 실행하고, 모델 선택 방법은 Cowork와 같습니다.

Code 모드는 각 동작을 허용하기 전에 검토하는 Auto 권한 모드로 시작합니다. 설정에 따라서는 검토마다 별도 요청이 발생해 토큰이 듭니다. auto 모드의 비용을 참고하세요. Bypass permissions는 검토와 그 비용을 건너뛰지만, 그러면 Claude가 묻지 않고 모두 실행하므로 신뢰할 수 있는 프로젝트에서만 쓰세요. 켜는 방법은 다음과 같습니다.

  1. 왼쪽 아래의 아바타를 눌러 Settings를 엽니다.
  2. 왼쪽의 Claude Code 아래 Sessions에서 Allow bypass permissions mode를 켭니다. 설정의 Allow bypass permissions mode
  3. Code 모드로 돌아와 입력창 아래 권한 메뉴에서 Bypass permissions를 고르고, 대화상자에서 Bypass permissions로 확인합니다.

명령줄의 Claude Code

명령줄용 Claude Code를 설치했다면 Magpie의 Agent 탭에서 Claude Code를 찾아 스위치를 켜고 모델을 고르세요. 자세한 내용은 Magpie를 참고하세요.

Magpie Agent 탭의 Claude Code 스위치

서드파티 추론 직접 구성하기

Claude Desktop의 서드파티 추론은 요청을 사용자 지정 게이트웨이로 보낼 수 있습니다. Magpie를 쓰지 않는다면 아래 단계에 따라 CoreCode를 가리키도록 설정하세요.

게이트웨이 URL
https://corecode.live
API Key
콘솔의 API 키 페이지에서 Claude 满血（仅限CC） 그룹으로 만든 sk- 키
모델
요금 페이지를 참고하세요. 예: claude-opus-5-5, claude-sonnet-5-5

다운로드

Claude Desktop 다운로드 페이지를 열고 Desktop 열에서 사용 중인 시스템용 설치 프로그램을 내려받으세요.

다운로드 페이지의 Desktop 열

설치

Windows 설치 프로그램은 Anthropic 서버에 접속해야 합니다. 프록시를 전역(TUN) 모드로 실행하지 않으면 설치가 실패합니다.

설치 프로그램이 Download failed를 표시함

전역 모드를 쓰고 싶지 않다면 명령줄에서 설치 프로그램이 프록시를 거치도록 하세요.

  1. 프록시의 로컬 포트를 확인하세요. Clash Verge의 기본값은 7897입니다. Clash Verge 설정의 혼합 프록시 포트
  2. Claude Desktop 설치 프로그램이 있는 폴더에서 cmd를 엽니다.
  3. 다음 명령을 순서대로 실행하면(포트는 본인 것으로) 설치 프로그램이 정상적으로 시작됩니다.
set HTTP_PROXY=http://127.0.0.1:7897
set HTTPS_PROXY=http://127.0.0.1:7897
"Claude Setup.exe"
명령줄에서 프록시를 설정한 뒤 설치 프로그램 실행 설치 프로그램이 정상적으로 다운로드하고 설치하는 모습

개발자 모드 켜기

앱을 열면 로그인 화면이 나타납니다. 공식 계정으로 로그인할 필요는 없으며, 아래의 서드파티 추론 설정이 로그인을 우회합니다.

Claude Desktop 로그인 화면
메뉴 언어Claude Desktop은 시스템 언어로 메뉴를 표시하며 위치는 같습니다. 영어에서는 Help → Troubleshooting → Enable developer mode, 중국어에서는 帮助 → 故障排查 → 启用开发者模式입니다.
  1. 로그인 화면의 이메일 입력란을 누른 뒤 Tab을 눌러 왼쪽 위 메뉴로 이동합니다.
  2. Enter를 누르고 Help → Troubleshooting → Enable developer mode로 갑니다. Windows 메뉴의 Enable developer mode
  3. 대화상자에서 Enable을 누르면 앱이 다시 시작됩니다. Enable developer mode 확인 대화상자

서드파티 추론 설정

같은 방법으로 메뉴를 열어 Developer → Configure third-party inference…로 가서 아래 표대로 입력하세요.

Developer 메뉴의 Configure third-party inference
설정값
Gateway base URLhttps://corecode.live
Gateway API key본인의 sk- 키 (없으면 API 키 페이지에서 만드세요)
Credential kind기본값 Static API key 유지
Gateway auth scheme기본값 bearer 유지
CoreCode 주소와 키를 입력한 게이트웨이 설정
Test connection은 건너뛰세요仅限CC 그룹은 Claude Code가 보낸 요청만 받는데, 이 테스트 버튼의 요청은 그렇지 않아서 항상 Claude Code의 요청만 허용된다는 403이 돌아옵니다. 설정이 틀린 것이 아니므로 건너뛰세요. 중요한 것은 마지막에 대화가 되는지입니다.
Test connection이 403을 반환함

다음으로 모델 목록을 설정합니다. MODELS 카드 오른쪽 위의 Test model discovery를 누르세요.

MODELS 카드와 Test model discovery 버튼

마지막으로 오른쪽 아래의 Save changes를 누른 뒤 Apply changes를 눌러 설정을 저장하고 적용하세요.

대화 시작

  1. 대화 화면으로 돌아갑니다. 상단에 Couldn't sign in to Gateway 같은 경고가 나올 수 있지만 무시해도 되며 사용에는 영향이 없습니다. Couldn't sign in to Gateway 경고
  2. 모델 선택기를 열어 CoreCode의 모델이 있는지 확인합니다. 모델 선택기
  3. 아무 메시지나 보내 보세요. 정상적으로 답하면 설정이 된 것이며, 요청과 과금 내역이 콘솔의 사용 로그에 나타납니다. 답변을 받은 대화
동작 여부를 아는 방법이 설정은 Anthropic 공식 계정 확인 없이 서드파티 게이트웨이를 거치므로 "연결됨"이나 "테스트 통과" 같은 메시지는 나오지 않습니다. 답변이 오면 설정이 된 것이며, 테스트 버튼의 오류는 관계가 없습니다.

새 대화에서 첫 메시지를 보낸 뒤 사용 로그에 선택한 모델과 다른 모델의 작은 호출이 하나 더 보일 수 있습니다. Claude Desktop이 대화 제목을 만드는 호출이며 정상입니다.