Zed 편집기 사용자 정의 API 설정

Zed는 에이전트 설정 UI와 OpenAI-compatible 엔드포인트에 대한 settings.json를 모두 지원합니다. Zed가 시스템 키체인에 TokenHub API 키를 저장하거나 공급자 이름에서 파생된 환경 변수를 통해 이를 제공하도록 합니다. settings.json에 키를 넣지 마십시오.

에이전트 설정에서 공급자 추가

1. 명령 팔레트를 열고 agent: open settings를 실행하십시오.
2. Settings → AI → LLM Providers로 이동합니다.
3. Add Provider를 클릭하고 OpenAI-compatible 공급자를 선택합니다.
4. 공급자 이름으로 tokenhub를 입력합니다.
5. API URL로 https://us-api.tokenhub.com/v1를 입력합니다.
6. TokenHub 모델 카탈로그에 표시된 정확한 모델 ID를 입력하세요.
7. 해당 모델의 실제 컨텍스트 창에 들어갑니다.
8. 공급자 설정에 TokenHub API 키를 입력하면 Zed가 이를 시스템 키체인에 저장합니다.

여러 모델이 필요한 경우 settings.json을 편집하세요.

Zed는 language_models.openai_compatible에서 공급자를 지원합니다. 이 스키마에서 max_tokens는 최대 출력이 아닌 컨텍스트 창을 의미합니다. 두 한계를 모두 모델에 대해 문서화된 값으로 바꿉니다.

{
  "language_models": {
    "openai_compatible": {
      "tokenhub": {
        "api_url": "__API_BASE_URL__/v1",
        "available_models": [
          {
            "name": "YOUR_TOKENHUB_MODEL_ID",
            "display_name": "TokenHub / YOUR_TOKENHUB_MODEL_ID",
            "max_tokens": 128000,
            "max_output_tokens": 8192,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": false
            }
          }
        ]
      }
    }
  }
}

capabilities를 생략하면 Zed는 위에 표시된 OpenAI-compatible 기본값을 사용합니다. 모델과 TokenHub 엔드포인트가 실제로 지원하는 경우에만 images, parallel_tool_calls 또는 다른 기능을 true로 설정하세요.

Zed의 API 키 조회 규칙을 따릅니다.

Zed는 공급자 ID를 대문자 스네이크 케이스로 변환하고 _API_KEY를 추가합니다. 따라서 공급자 ID tokenhub는 다음에 매핑됩니다.

export TOKENHUB_API_KEY="sk-..."

비어 있지 않은 환경 변수가 키체인보다 우선합니다. UI에서 키를 업데이트했지만 Zed가 여전히 이전 자격 증명을 보내는 경우 이 변수를 설정 해제하고 Zed를 다시 시작하세요.

모델 이름에서 추론 또는 응답 지원을 추론하지 마십시오.

• TokenHub 모델이 OpenAI 스타일 reasoning_effort를 지원하는 경우 엔드포인트가 허용하는 값만 설정하세요. Zed는 none, minimal, low, medium, high, xhigh 및 max를 노출하지만 타사 엔드포인트는 더 적은 수의 값을 지원할 수 있습니다.
• TokenHub는 현재 이 연결에 대해 채팅 완료를 권장하므로 capabilities.chat_completions: true를 유지하세요.
• API 응답이 필요한 모델에 대해서만 false로 변경하세요. 단순히 추론을 활성화하기 위해 API를 전환하지 마십시오.
• 엔드포인트에 max_completion_tokens 대신 max_tokens가 필요한 경우에만 max_tokens_parameter: true를 설정하십시오.

Zed 내부 확인

Agent 또는 Inline Assistant에서 TokenHub / YOUR_TOKENHUB_MODEL_ID를 선택하고 현재 파일에 대한 설명을 요청합니다. 모델이 없는 경우 JSON, 제공자 ID, available_models를 확인하세요. 401의 경우 Zed 프로세스에 표시되는 TOKENHUB_API_KEY를 확인하세요. 도구나 이미지가 실패하면 capabilities로 돌아가 선언이 모델의 실제 지원을 초과하지 않는지 확인하십시오.

공식 참고자료

• Zed: API 액세스 사용