메인 콘텐츠로 건너뛰기
Zed는 settings.json의 두 별도 제공자 슬롯(language_models.openai_compatible 및 language_models.anthropic_compatible)을 통해 커스텀 모델을 호출할 수 있습니다. 둘 다 커스텀 api_url을 허용하므로, Zed는 Tokios의 양쪽 면을 보여주기 가장 깔끔한 곳입니다 — https://api.tokios.com/v1의 OpenAI 호환 엔드포인트와 https://api.tokios.com의 Anthropic 호환 엔드포인트입니다. 하나를 선택하거나 둘 다 구성하여 어시스턴트별로 전환하세요.

Prerequisites

Option A: OpenAI-compatible provider

1

Open Zed's settings.json

명령 팔레트를 열고 zed: open settings를 실행하거나 settings.json을 직접 편집하세요.
2

Add an openai_compatible entry

Tokios 기본 URL, 배포 이름, API 키가 포함된 language_models.openai_compatible 블록을 추가하세요:
settings.json
바꾸세요: gemma-tunnel → 공개 배포 이름 (Models 탭에서 등록한 값) — Ollama/llama.cpp/vLLM/LM Studio의 로컬 모델 ID가 아닙니다. 키는 의도적으로 여기에 포함되지 않았으니 다음 단계를 참고하세요.
3

Set your API key outside settings.json

Zed는 settings.json에서 API 키를 읽지 않습니다. sk-tok-… 키를 다음 방법 중 하나로 제공하세요:
  • UI를 통해 — 명령 팔레트에서 agent: open settings를 실행하고, LLM Providers 아래에서 Tokios를 찾은 다음 키를 붙여넣으세요. Zed는 시스템 키체인에 저장합니다.
  • 환경 변수를 통해 — Zed는 settings.json의 제공자 ID에서 이름을 파생하며, 대문자 스네이크 케이스로 변환하고 _API_KEY를 접미사로 추가합니다. 위의 Tokios ID는 따라서 TOKIOS_API_KEY를 읽습니다.
비어 있지 않은 환경 변수는 키체인 값보다 우선하므로, 나중에 UI 방식으로 전환할 경우 환경 변수를 설정 해제하세요.
4

Select the model in the assistant panel

Zed의 어시스턴트 패널을 열고 모델 선택기에서 Tokios: gemma-tunnel(또는 구성한 display_name)을 선택하세요.

Option B: Anthropic-compatible provider

1

Add an anthropic_compatible entry

같은 settings.json에 Tokios Anthropic 호환 엔드포인트를 가리키는 language_models.anthropic_compatible 블록을 추가하세요. 이 기본 URL에는 no /v1 — 슬래시 없음 — 에 주의하세요:
settings.json
바꾸세요: gemma-tunnel → 공개 배포 이름 (Models 탭에서 등록한 값) — Ollama/llama.cpp/vLLM/LM Studio의 로컬 모델 ID가 아닙니다.
2

Set your API key outside settings.json

Option A와 같은 방식으로 sk-tok-… 키를 제공하세요:
  • UI를 통해 — 명령 팔레트에서 agent: open settings를 실행하고, Anthropic 호환 섹션의 LLM Providers 아래에서 Tokios를 찾은 다음 키를 붙여넣으세요. Zed는 시스템 키체인에 저장합니다.
  • 환경 변수를 통해 — Option A에서 사용한 TOKIOS_API_KEY 변수가 두 제공자 슬롯 모두에 적용됩니다. 두 경우 모두 제공자 ID가 Tokios이기 때문입니다.
3

Select the model in the assistant panel

Zed의 어시스턴트 패널을 열고 모델 선택기에서 Tokios (Anthropic): gemma-tunnel(또는 구성한 display_name)을 OpenAI 호환 항목과 함께 또는 대신 선택하세요.
바꾸세요: gemma-tunnel을 등록한 배포 이름으로, sk-tok-YOUR_KEY를 실제 키로. 둘 중 어느 것도 공유되거나 버전 관리되는 settings.json에 커밋하지 마세요.
두 제공자를 한 번에 구성하고 별도의 항목을 유지할 수 있습니다 — 하나는 https://api.tokios.com/v1(OpenAI 호환)을 가리키고 다른 하나는 https://api.tokios.com(Anthropic 호환)을 가리키도록 — 그런 다음 모델 선택기에서 전환하여 동일한 기본 배포에 대한 동작을 비교할 수 있습니다.

Why this works without a tunnel

두 Zed 제공자 슬롯 모두 Zed의 모델 요청이 발생하는 곳에서 도달 가능한 URL이 필요합니다. Tokios의 커넥터는 아웃바운드 전용입니다: 모델 옆에서 아웃바운드 연결을 시작하며 인바운드 포트를 열지 않으므로, https://api.tokios.com(또는 /v1)은 한 번 설정하면 되는 안정적이고 인증된 URL입니다. 유지보수해야 할 ngrok 프로세스도 없고, LAN에 인증되지 않은 포트가 열려 있을 일도 없습니다.

Troubleshooting

Zed가 전송한 API 키가 없거나, 형식이 잘못되었거나, 취소된 경우입니다. 전체 sk-tok-… 키가 추가 공백 없이 설정되어 있는지 확인하고, Keys 탭에서 상태를 확인하세요.
확인: name 값이 available_models 내에서 등록된 배포와 일치하지 않습니다. Models 탭의 공개 이름과 정확히 일치하는지 확인하세요.
해당 배포의 커넥터가 오프라인 상태이거나 동시성 한도에 도달했습니다. Connectors 탭을 확인하세요 — Online 상태로 표시되어야 합니다.

Next steps

Quickstart

커넥터를 페어링하고 첫 번째 배포를 처음부터 등록하세요.

Compatible clients

다른 OpenAI 및 Anthropic 호환 클라이언트의 기본 URL 및 키 설정을 확인하세요.