Zed 에디터 설정 튜토리얼: NextHub API 연동

Zed는 두 가지 연동 방식을 지원합니다. ACP 모드(Claude Code 설정을 그대로 재사용)와 Zed Agent 모드(에디터 내장 AI 패널에서 사용).

방식 1: ACP 모드(권장)

ACP 모드는 Claude Code CLI를 직접 호출하므로, CC-Switch / 수동 설정을 따라 Claude Code를 설정하기만 하면 Zed에서 바로 사용할 수 있으며 추가 설정이 필요하지 않습니다.

TIP

Zed ACP에는 Claude Code Agent가 내장되어 있어, Claude Code 설정을 완료한 뒤 Zed의 Agent 패널에서 바로 선택할 수 있습니다. 설정에 진입 장벽이 없습니다.

방식 2: Zed Agent 모드(Provider 수동 설정)

1. Agent Panel을 열고 현재 모델 이름 클릭

Zed 오른쪽 하단의 Agent Panel에서 현재 표시된 모델 이름을 클릭하여 모델 전환 화면으로 이동합니다.

2. Configure → Add Provider 클릭

팝업 화면에서 'Configure'를 클릭한 뒤 'Add Provider'를 클릭하고, 유형으로 **Compatible APIs (OpenAI)**를 선택합니다.

3. Provider 정보 입력

다음 형식으로 입력합니다.

필드	입력 내용
API Key	본인의 NextHub ApiKey
Base URL	https://api.nexthub.cc/v1
모델 ID	claude-opus-5-5 등 모델 목록의 ID

Base URL에 /v1을 포함하세요

Zed는 입력한 주소를 접두사로 그대로 사용합니다. https://api.nexthub.cc/v1를 입력하면 chat/completions와 Responses 두 가지 요청 방식이 모두 정상적으로 동작합니다. /v1이 없는 chat/completions 요청은 잘못된 경로로 전달되어 오류가 발생합니다.

4. 저장 후 Agent 패널에서 Claude 모델 선택

설정을 저장한 뒤 Agent Panel로 돌아가, 모델 드롭다운 목록에서 방금 추가한 Claude 모델을 선택하면 정상적으로 사용할 수 있습니다.