사용자 지정 프로바이더로 ZCode에서 Claude 사용하기

AI in IDE를 Z.ai의 ZCode 데스크톱 앱에 사용자 지정 프로바이더로 추가해 내장 GLM 모델과 함께 Claude Opus 5.5, Sonnet 5.5, Haiku 4.5를 사용합니다.

이 페이지는 ZCode의 모델 연결 가이드를 따릅니다. ZCode에서 처음부터 끝까지 실행해 보지는 않았습니다. 베이스 URL 값은 ZCode가 DeepSeek용으로 문서화한 규칙을 따랐고, 같은 값을 다른 클라이언트에서 AI in IDE로 테스트했습니다.

빠른 설정

API 키 만들기. API Keys를 열어 키를 만들고 AWSQ 또는 CCMAX 채널을 선택합니다.
프로바이더 추가. Model settings(모델 설정)를 열고 프로바이더 목록 아래쪽의 Add provider(프로바이더 추가)를 클릭합니다.
필드 입력.
- Name: AI in IDE
- Anthropic endpoint: https://api.aiinide.com
- OpenAI endpoint: https://api.aiinide.com/v1
- API key: 대시보드에서 만든 키
모델 추가. Add model(모델 추가)을 클릭하고 ID를 직접 입력합니다: claude-sonnet-5-5, claude-opus-5-5, claude-haiku-4-5-20251001.
활성화. 프로바이더 스위치를 켜고 Claude 모델을 골라 짧은 프롬프트를 보냅니다. 요청은 Usage에 나타납니다.

두 엔드포인트가 다른 이유

ZCode의 DeepSeek 예시는 Anthropic에 https://api.deepseek.com/anthropic, OpenAI에 https://api.deepseek.com/v1을 씁니다. https://api.deepseek.com/anthropic은 DeepSeek가 Claude Code용으로 안내하는 값이기도 하며, Claude Code는 여기에 /v1/messages를 붙입니다. 따라서 ZCode의 Anthropic 필드에는 /v1이 없는 API 루트가 들어갑니다. AI in IDE에서는 그 루트가 호스트 이름 자체입니다. OpenAI 값은 버전을 포함하므로 https://api.aiinide.com/v1입니다.

요청이 404로 실패하면 Anthropic 엔드포인트가 /v1로 끝나지 않는지 확인하세요. 400 This endpoint requires a CODEX API key로 실패하면 OpenAI 엔드포인트에 /v1이 빠진 것입니다.

설정 파일

ZCode는 프로바이더를 ~/.zcode/v2/config.json에 저장합니다. 프로바이더의 options는 apiKey, baseURL, apiKeyRequired, headers만 받으며, 다른 필드는 오류 없이 무시됩니다. 설정을 다른 컴퓨터로 복사해야 하는 경우가 아니면 설정 패널을 사용하세요.

지원 모델

모델 ID	채널	적합한 용도
`claude-opus-5-5`	AWSQ, CCMAX	어려운 리팩터링, 긴 에이전트 실행
`claude-sonnet-5-5`	AWSQ, CCMAX	일상 코딩
`claude-haiku-4-5-20251001`	AWSQ, CCMAX	빠른 수정, 저렴한 확인

ZCode에서는 사용자 지정 프로바이더 모델의 컨텍스트 윈도우를 바꿀 수 있으며, 변경 사항은 새 세션에 적용됩니다. 요율은 모델과 요금에 있습니다.

자주 묻는 질문

ZCode에서 AI in IDE를 쓰려면 어떤 베이스 URL이 필요한가요?

Anthropic endpoint 필드에는 https://api.aiinide.com, OpenAI endpoint 필드에는 https://api.aiinide.com/v1입니다.

GLM Coding Plan을 대체하나요?

아닙니다. GLM 모델은 계속 Z.ai 또는 BigModel 계정을 사용합니다. AI in IDE 요청은 AI in IDE 키에만 과금됩니다.

추론 수준을 바꾼 뒤 400 오류가 나는 이유는 무엇인가요?

ZCode 문서에 따르면 서드파티 배포는 공식 엔드포인트와 다른 추론 수준을 받을 수 있습니다. 해당 모델의 추론 수준을 낮추거나 끈 뒤 다시 시도하세요.