메인 콘텐츠로 건너뛰기
Xcode에는 프로젝트에 대한 질문에 답하고, 코드를 작성 및 리팩터링하고, 오류를 수정할 수 있는 코딩 어시스턴트가 포함되어 있습니다. Xcode는 기본 제공 프로바이더 외에도 Chat Completions API를 지원하는 모든 채팅 프로바이더를 허용하므로, Xcode의 Intelligence 설정에서 Venice를 추가하고 코딩 어시스턴트 대화에서 Venice 모델을 사용할 수 있습니다.

코딩 어시스턴트

Venice 모델로 질문하고, 코드를 생성하고, 리팩터링하세요

직접 연결

Xcode가 Mac에서 Venice로 요청을 직접 전송합니다

프라이버시 선택

코드에 필요한 프라이버시 등급의 모델을 선택하세요

​
사전 요구 사항

  • venice.ai/settings/api에서 받은 Venice API 키
  • Xcode 26.3 이상 (이전 Xcode 26 릴리스에서는 Xcode를 다시 실행할 때 사용자 지정 채팅 프로바이더가 사라질 수 있습니다)
  • macOS Tahoe 26 이상 (Xcode 27은 macOS Tahoe 26.6 이상과 Apple silicon Mac이 필요합니다)

​
설정

1

Venice API 키 발급

venice.ai/settings/api에서 키를 생성하세요. Xcode에는 Inference Only 키면 충분합니다.Epoch Consumption Limit이 설정된 전용 키를 만드는 것을 고려하세요. 이렇게 하면 Xcode의 지출 한도를 정할 수 있고, 다른 앱에 영향을 주지 않고 키를 폐기할 수 있습니다. API 키 생성을 참조하세요.
2

Intelligence 설정 열기

Xcode에서 Xcode > Settings를 선택하고 사이드바에서 Intelligence를 선택하세요.
3

Venice를 채팅 프로바이더로 추가

Chat 아래에서 Add a Chat Provider를 클릭하고 Internet Hosted를 선택하세요. 일부 Xcode 26 릴리스에서는 이 버튼의 이름이 Add a Model Provider입니다.다음 값을 입력한 후 Add를 클릭하세요:URL은 /v1이나 후행 슬래시 없이 표시된 그대로 입력하세요. Xcode는 여기에 /v1/models와 /v1/chat/completions를 덧붙이며, 그 결과 https://api.venice.ai/api/v1 아래의 Venice 표준 엔드포인트가 만들어집니다.Xcode는 API Key 필드를 Authorization 헤더의 전체 값으로 전송합니다. your-venice-api-key를 실제 키로 바꾸고 Bearer 접두사는 그대로 유지하세요.
4

모델 선택

Chat 아래에서 Venice 프로바이더를 선택하세요. Xcode가 Venice에서 모델 목록을 가져옵니다. 사용하려는 모델을 켜고, 가장 자주 사용하는 모델에 별표를 표시하면 모델 메뉴 상단에 나타납니다.목록에는 모든 Venice 텍스트 모델이 포함되지만, 코딩 어시스턴트는 도구 호출(tool calling)을 지원하는 모델에서만 작동합니다. 선택하기 전에 모델 요구 사항을 확인하거나, z-ai-glm-5-3-flash로 시작하세요.
5

대화 시작

프로젝트를 연 다음 Coding Assistant 버튼을 클릭하거나 Command-0을 누르세요. New Conversation을 클릭하고 Chat 아래에서 Venice 모델을 선택하세요. 메시지 필드의 자리 표시자 텍스트에 대화에서 사용하는 모델이 표시됩니다.연결을 테스트하려면 짧은 프롬프트를 보내세요:

​
설정 확인

테스트 프롬프트를 보내는 것이 실제 확인 방법입니다. Venice의 GET /models 엔드포인트는 유효한 키 유무와 관계없이 카탈로그를 반환하므로, Xcode에 전체 모델 목록이 표시된다고 해서 키가 작동한다는 의미는 아닙니다. Venice는 메시지를 보낼 때만 키를 확인합니다. 프롬프트가 실패하면 Xcode 외부에서 API 키를 확인하세요:
이 엔드포인트는 유효한 키가 필요하므로, 여기서 401이 반환되면 Xcode 구성이 아니라 키에 문제가 있는 것입니다. 키가 작동한다면 프로바이더 설정을 문제 해결과 비교해 보세요.

​
모델 요구 사항

모델이 도구 호출을 지원해야 합니다. 채팅 대화에서 Xcode는 프로젝트를 검색하고 편집하기 위한 도구를 모델에 제공하므로, 도구 호출을 지원하지 않는 모델은 코딩 어시스턴트의 요청을 처리할 수 없습니다.
텍스트 모델 카탈로그에서는 이 기능을 Function Calling으로 표시하며, 대부분의 Venice 텍스트 모델이 이를 지원합니다. 이상적으로는 모델의 컨텍스트 윈도우가 200K 토큰 이상이어야 합니다. Xcode에는 채팅 프로바이더용 컨텍스트 윈도우 설정이 없으며, Project Context가 켜져 있으면 요청에 Xcode의 도구 정의 외에도 많은 양의 프로젝트 코드가 포함될 수 있습니다. 두 요구 사항을 모두 충족하는 Venice 모델을 나열하려면:

​
모델 선택

다음 모델은 두 요구 사항을 모두 충족합니다: 다른 모델을 비교할 때: Venice는 정기적으로 모델을 지원 종료하고 교체합니다. 모델이 작동을 멈추면 지원 중단을 확인하고 현재 모델로 전환하세요.

​
에이전트

채팅 프로바이더는 채팅 대화에만 사용됩니다. Claude Agent 및 Codex와 같은 Xcode의 기본 제공 에이전트와 Agent Client Protocol(ACP)을 통해 추가한 에이전트는 별도로 구성되며 채팅 프로바이더를 통해 요청을 보내지 않습니다. 또한 에이전트는 앱 빌드 및 테스트 등 채팅보다 더 많은 Xcode 기능을 사용할 수 있습니다. Xcode 프로젝트에 접근할 수 있는 에이전트를 Venice 모델로 실행하려면, 터미널 에이전트를 Venice용으로 구성하고 Xcode 26.3 이상에서 제공하는 Model Context Protocol(MCP) 서버에 연결하세요:
1

외부 에이전트 허용

Xcode의 Intelligence 설정에서 Model Context Protocol 아래의 Allow external agents to use Xcode tools를 켜세요.
2

Venice로 에이전트 설정

Codex CLI 또는 Claude Code 가이드를 따르세요.
3

에이전트를 Xcode에 연결

Xcode의 MCP 서버를 에이전트에 등록하세요:
4

에이전트에 프롬프트 보내기

먼저 Xcode에서 프로젝트를 연 다음, 터미널에서 에이전트에 프롬프트를 보내세요. 에이전트가 연결되면 Xcode가 알림을 표시합니다.

​
프라이버시

Xcode는 Mac에서 Venice로 채팅 요청을 직접 전송합니다. 채팅 대화에서는 Project Context가 기본적으로 켜져 있으므로, Xcode는 각 요청에 프로젝트의 관련 코드와 기타 컨텍스트를 포함합니다. Xcode가 전송하는 내용을 제한하려면 메시지 필드에서 Project Context를 끄고 @를 사용해 파일과 심볼을 명시적으로 참조하세요. Venice는 프록시에서 프롬프트 및 응답 내용을 저장하거나 기록하지 않습니다. 선택한 모델에 따라 런타임 프라이버시 등급이 결정됩니다:
  • Private 모델은 데이터 무보존(zero-data-retention) 인프라를 사용합니다.
  • Anonymized 모델은 업스트림 프로바이더로부터 사용자의 신원을 숨기지만, 해당 프로바이더가 코드를 처리할 수 있습니다.
  • e2ee- 모델 ID를 가진 TEE 모델은 하드웨어 엔클레이브 내부에서 실행됩니다. Xcode는 Mac에서 프롬프트를 암호화할 수 없으므로, Xcode에서 이 모델을 사용할 때는 종단 간 암호화 모드가 아닌 TEE 모드로 실행됩니다.
독점 코드를 보내기 전에 텍스트 모델 카탈로그에서 각 모델의 프라이버시 레이블을 확인하고 Venice 프라이버시를 읽어보세요.

​
문제 해결

API Key가 Bearer 뒤에 venice.ai/settings/api에서 받은 Venice 키가 추가 공백 없이 이어지는 형태인지 확인하세요. 모델 목록은 공개되어 있으므로 Xcode는 잘못된 키로도 모델 목록을 불러오며, 인증 오류는 메시지를 보낼 때만 나타납니다. 설정 확인의 명령으로 키를 테스트하세요.
URL이 정확히 https://api.venice.ai/api인지 확인하세요. URL이 /v1로 끝나면 Xcode가 /api/v1/v1/models를 요청하고, 후행 슬래시가 있으면 /api//v1/models가 됩니다. Venice는 두 경우 모두 404를 반환합니다. 수정된 URL로 프로바이더를 다시 추가하세요.
대화에서 도구 호출을 지원하고, 이상적으로는 컨텍스트 윈도우가 200K 토큰 이상인 모델을 사용하는지 확인하세요. Xcode는 각 요청에 도구 정의와 프로젝트 컨텍스트를 함께 보냅니다. 도구 호출을 지원하지 않는 모델은 이를 처리할 수 없으며, 큰 프로젝트는 작은 컨텍스트 윈도우를 초과할 수 있습니다. 모델 요구 사항을 충족하는 모델을 켠 다음 해당 모델로 새 대화를 시작하세요.
Venice는 두 가지 경우에 402를 반환합니다:
  • 요청이 Authorization 헤더 없이 Venice에 도달한 경우. Venice는 x-api-key 같은 다른 헤더를 무시하고 x402 결제 챌린지로 응답합니다. API Key Header를 Authorization으로 설정하세요.
  • 키가 지출 한도에 도달했거나 잔액이 소진된 경우. 지출 한도 오류 문제 해결을 참조하세요.
Venice가 해당 모델을 지원 종료했을 수 있습니다. 지원 중단을 확인하고, 프로바이더의 모델 목록에서 현재 모델을 선택한 다음 새 대화를 시작하세요.

​
리소스

Setting Up Coding Intelligence

Xcode의 에이전트 및 채팅 프로바이더에 대한 Apple 가이드

Writing Code with Intelligence

코딩 어시스턴트, 프로젝트 컨텍스트 및 기록 사용하기

Venice 텍스트 모델

현재 모델 ID, 기능 및 프라이버시 등급 살펴보기

API 키 생성

지출 한도가 설정된 전용 키 만들기