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
- 로컬 모델과 페어링된 Tokios 커넥터 — 참고: Connector install
- 등록된 모델 배포 이름 — 참고: Register a model
- Tokios API 키(
sk-tok-…) — 참고: API Keys - Zed 설치 완료
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는 비어 있지 않은 환경 변수는 키체인 값보다 우선하므로, 나중에 UI 방식으로 전환할 경우 환경 변수를 설정 해제하세요.
settings.json에서 API 키를 읽지 않습니다. sk-tok-… 키를 다음 방법 중 하나로 제공하세요:- UI를 통해 — 명령 팔레트에서
agent: open settings를 실행하고, LLM Providers 아래에서 Tokios를 찾은 다음 키를 붙여넣으세요. Zed는 시스템 키체인에 저장합니다. - 환경 변수를 통해 — Zed는
settings.json의 제공자 ID에서 이름을 파생하며, 대문자 스네이크 케이스로 변환하고_API_KEY를 접미사로 추가합니다. 위의TokiosID는 따라서TOKIOS_API_KEY를 읽습니다.
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에 커밋하지 마세요.Why this works without a tunnel
두 Zed 제공자 슬롯 모두 Zed의 모델 요청이 발생하는 곳에서 도달 가능한 URL이 필요합니다. Tokios의 커넥터는 아웃바운드 전용입니다: 모델 옆에서 아웃바운드 연결을 시작하며 인바운드 포트를 열지 않으므로,https://api.tokios.com(또는 /v1)은 한 번 설정하면 되는 안정적이고 인증된 URL입니다. 유지보수해야 할 ngrok 프로세스도 없고, LAN에 인증되지 않은 포트가 열려 있을 일도 없습니다.
Troubleshooting
401 error
401 error
Zed가 전송한 API 키가 없거나, 형식이 잘못되었거나, 취소된 경우입니다. 전체
sk-tok-… 키가 추가 공백 없이 설정되어 있는지 확인하고, Keys 탭에서 상태를 확인하세요.404 error
404 error
확인:
name 값이 available_models 내에서 등록된 배포와 일치하지 않습니다. Models 탭의 공개 이름과 정확히 일치하는지 확인하세요.503 error
503 error
해당 배포의 커넥터가 오프라인 상태이거나 동시성 한도에 도달했습니다. Connectors 탭을 확인하세요 — Online 상태로 표시되어야 합니다.
Next steps
Quickstart
커넥터를 페어링하고 첫 번째 배포를 처음부터 등록하세요.
Compatible clients
다른 OpenAI 및 Anthropic 호환 클라이언트의 기본 URL 및 키 설정을 확인하세요.