본문으로 건너뛰기
PleumRouter
시작하기

Zed

Zed는 language_models.openai_compatible 항목에 api_url을 넣습니다.

설정 예시입니다. Zed 버전에 따라 메뉴·설정 이름이 조금 다를 수 있습니다.

설정#

Zed는 language_models.openai_compatible에 OpenAI 호환 제공자를 추가합니다.

  1. settings.json에 아래 제공자를 추가합니다. api_url은 https://apirouter.pleum.ai/v1이고, available_models의 name에는 모델 카탈로그의 ID를 적습니다. max_tokens에는 출력 한도가 아니라 그 모델의 컨텍스트 창 크기를 적습니다.
  2. 키는 settings.json에 쓰지 않습니다. Zed의 제공자 설정 화면(Agent Settings의 LLM Providers)에 입력하거나, 제공자 ID를 대문자 스네이크 케이스(밑줄로 잇는 대문자 표기)로 바꾸고 _API_KEY를 붙인 환경변수로 넘기세요. 예를 들어 my-gateway는 MY_GATEWAY_API_KEY입니다.
settings.json
// Zed settings.json
{
  "language_models": {
    "openai_compatible": {
      "PleumRouter": {
        "api_url": "https://apirouter.pleum.ai/v1",
        "available_models": [
          // max_tokens is the model's context window, not its output limit
          { "name": "gpt-5.5", "max_tokens": 1050000 }
        ]
      }
    }
  }
}

확인#

짧은 프롬프트를 보내 응답이 오면 연결입니다. 비용은 응답 헤더 X-Request-Id로 GET /v1/generation?id=…에서 조회할 수 있습니다.

작동 방식#

이 도구는 OpenAI Chat Completions 형식(/v1/chat/completions)으로 요청합니다. base URL은 https://apirouter.pleum.ai/v1이고 인증은 plm_ 키를 Authorization: Bearer로 보냅니다.

오류#

아래 표는 Zed를 연결할 때 나오는 오류와 조치입니다. api_url 끝에 /chat/completions를 붙이지 마세요.

증상원인과 조치
401 Unauthorized키가 틀렸거나 비활성입니다. 대시보드 API 키에서 plm_ 키를 다시 복사하세요. 다른 서비스의 키를 넣지 않았는지도 확인하세요.
402 Payment Required크레딧 잔액이 부족하거나 키의 일·주·월 예산이나 월 토큰 한도를 다 썼습니다. 충전하거나 API 키의 예산과 한도를 확인하세요.
404 Not Foundbase URL이 틀렸거나 모델 ID가 카탈로그에 없습니다. OpenAI 호환 도구는 /v1까지, Anthropic·Gemini 도구는 /v1이 없는 루트 주소입니다. 끝에 /chat/completions 같은 경로를 직접 붙이지 마세요. 오류 코드가 model_not_found면 모델 ID를 확인하세요.
429 Too Many Requests키당 분당 요청 한도나 동시 요청 한도(concurrency_limit_exceeded)를 넘었거나, 모델 공급자 쪽 한도에 걸렸습니다(upstream_rate_limited). 에이전트의 병렬 실행 수를 줄이고 사용량 제한을 확인하세요.
model not found카탈로그에 없는 모델 ID입니다. GET /v1/models로 정확한 ID를 확인하고 대소문자까지 그대로 쓰세요.

비용·보안 팁#

  • 키에 예산을 걸어 두세요. 코딩 에이전트는 한 작업에서 모델을 여러 번 호출하고 긴 컨텍스트를 반복해 보냅니다. API 키에 일·주·월 예산을 설정하면 비용을 예측하기 쉽습니다.
  • 키는 git에 올리지 마세요. 셸 프로필이나 설정 파일에 넣은 키가 저장소에 커밋되지 않게 하고, 유출이 의심되면 대시보드에서 바로 폐기한 뒤 새로 발급하세요.
  • 민감한 코드라면 처리 위치를 확인하세요. 프롬프트와 코드는 고른 모델의 공급자에게 전달됩니다. 데이터 처리 위치와 개인정보 마스킹으로 범위를 정할 수 있습니다.
이전Continue다음Aider