Zed

Zed가 401 또는 유효하지 않은 API 키를 반환할 때 해결하는 방법

401은 요청이 AI Code With 서버에 도달했지만 인증 단계에서 실패했음을 의미합니다. 문제는 API 키 자체, 키의 유효성 또는 계정 상태에 있으며, API URL 또는 Model ID가 아닙니다. Zed는 키를 시스템 키체인에 저장합니다. settings.json에 실제 키를 넣지 마세요.

다음 검사부터 시작하세요

요청이 AI Code With에 도달했지만 인증에 실패했습니다. API URL 또는 Model ID를 변경하기 전에 키체인 API 키를 확인하세요.

  • Agent Panel에서 메시지를 보낸 후 Zed가 401, Unauthorized 또는 유효하지 않은 API 키를 보고합니다.
  • 붙여넣은 API 키가 불완전하거나, 추가 공백이나 줄 바꿈이 있거나, 잘못된 키입니다
  • Agent Settings(명령 agent: open settings) → LLM Providers를 열고 AI Code With / aicodewith를 선택하세요
401UnauthorizedInvalid API Key

01

요청이 서버에 도달했는지 확인

401 / Unauthorized / 유효하지 않은 API 키는 HTTP 요청이 https://api.aicodewith.ai/v1에 도달했지만 Authorization 헤더를 확인하는 중 거부되었음을 의미합니다. 아직 API URL 또는 Model ID를 변경하지 마세요.

시간 초과, DNS 실패 또는 404는 주소나 네트워크 문제입니다 — 먼저 API URL 문서를 사용하세요. 오류가 명시적으로 401일 때만 이 페이지를 따르세요.

02

공급자 UI에서 API 키 다시 붙여넣기

Agent Settings → LLM Providers를 열고 추가한 OpenAI 호환 공급자를 선택한 다음 API Key 필드를 지우고 전체 키를 붙여넣으세요. 복사된 줄 바꿈, 주변 공백 또는 따옴표를 피하세요.

Zed는 키를 settings.json이 아니라 시스템 키체인에 기록합니다. 이전에 JSON에 sk- 문자열을 넣었다면 해당 필드를 삭제하고 대신 UI에 키를 입력하세요. 그렇지 않으면 UI 값이 적용되지 않을 수 있습니다.

  1. 1Agent Settings(명령 agent: open settings) → LLM Providers를 열고 AI Code With / aicodewith를 선택하세요
  2. 2API Key 필드를 지우고 공백이나 줄 바꿈 없이 전체 키를 다시 붙여넣으세요

03

키와 계정을 확인한 다음 테스트 메시지 보내기

AI Code With 대시보드에서 키가 여전히 유효하고 계정에 잔액이 있는지 확인하세요. 만료되거나 비활성화되었거나 잔액이 0인 키도 인증 시 401을 반환합니다.

공급자를 저장한 후 Agent Panel에서 해당 공급자 아래의 모델을 선택하고 짧은 메시지를 보내세요. 401 없이 정상 응답이 오면 자격 증명 체인이 복원된 것입니다. 그런 다음 사용 기록에서 시간별로 호출을 일치시키세요.

  1. 1API Key 필드를 지우고 공백이나 줄 바꿈 없이 전체 키를 다시 붙여넣으세요
  2. 2AI Code With Key Management에서 키가 활성 상태이고 계정에 잔액이 있는지 확인하세요

공급자를 복사하거나 저장하는 것은 성공적인 연결이 아닙니다. 확인 가능한 신호는 실제 Agent Panel 응답과 일치하는 사용 기록 항목입니다.

그래도 해결되지 않으면

출처

다시 구성

통합 센터로 돌아가 설정 단계를 계속하세요.

관련 설정 단계로 돌아가기

Related problems

모델을 찾을 수 없음 / 잘못된 모델 ID · API URL 오류 · 요청이 AI Code With에 전달되지 않음

Back to Zed