Coding Agent 설정

Zed 사용자 지정 모델 및 API 설정

Zed에 BetterToken을 OpenAI 호환 제공자로 추가하세요. Base URL, API Key, 모델을 설정하고 Key를 시스템 키체인에 보관하세요.

Zed Agent Settings에서 OpenAI-compatible provider를 추가한 다음 BetterToken API Key, Base URL 및 Model ID를 입력하세요. Zed는 이 screen을 통해 저장한 keys를 settings.json 대신 system keychain에 저장합니다.

주요 설정

필드	값
Provider	`BetterToken`
API Key	`YOUR_API_KEY`
Base URL	`https://bettertoken.ai/v1`
모델	`YOUR_MODEL_ID`

사전 요구 사항

최신 버전의 Zed 설치
BetterToken API Key 만들기
모델 광장에서 YOUR_MODEL_ID 복사

가입하고 BetterToken API Key 받기

이미 계정이 있나요? 로그인하고 잔액을 충전한 다음 콘솔에서 키를 만드세요.

설치

Zed website에서 최신 version을 설치하거나 업데이트하세요. Zed를 시작한 다음 아래 단계에 따라 Agent settings를 여세요.

수동 설정

OpenAI-compatible provider 추가

Add Provider를 클릭하고 OpenAI Compatible를 선택한 다음 Provider Name으로 BetterToken을 입력하세요.

연결 settings 입력

필드	값
API URL	`https://bettertoken.ai/v1`
API Key	`YOUR_API_KEY`
Model ID	`YOUR_MODEL_ID`

Base URL만 입력하세요. 이 가이드는 Zed의 기본 Chat Completions 모드를 사용하므로 Zed가 해당 엔드포인트 경로를 추가합니다.

API Key 저장

Zed settings에서 provider를 저장하세요. Zed는 API Key를 local system keychain에 저장하며 settings.json에 작성하지 않습니다.

모델 선택

Agent Panel model picker를 열고 YOUR_MODEL_ID를 BetterToken 아래에서 선택하세요.

선택 사항: `settings.json`에서 provider 및 model 선언

file-managed model declarations가 필요하면 zed: open settings file을 실행하세요. file에는 provider, api_url 및 model metadata만 유지하세요.

{
  "language_models": {
    "openai_compatible": {
      "BetterToken": {
        "api_url": "https://bettertoken.ai/v1",
        "available_models": [
          {
            "name": "YOUR_MODEL_ID",
            "display_name": "YOUR_MODEL_ID",
            "max_tokens": 128000
          }
        ]
      }
    }
  }
}

Zed는 model context-window declaration으로 max_tokens를 요구합니다. 선택한 model에 맞게 조정하세요. system keychain에 저장되도록 Agent Settings에서 API Key를 입력하세요.

연결 확인

Agent Panel에서 BetterToken / YOUR_MODEL_ID를 선택하세요.
짧은 테스트 message를 보내세요.
authentication 또는 model errors 없는 정상 response가 설정을 확인합니다.

provider 또는 model settings를 변경한 후 Zed를 완전히 종료하고 다시 시작하세요.

모델 전환

Agent Panel model picker에서 다른 BetterToken model을 선택하세요. Model ID를 추가하려면 모델 광장에서 현재 값을 복사한 다음 provider settings 또는 available_models를 업데이트하세요.

일반적인 오류

오류	해결 방법
`401` 또는 `Unauthorized`	Agent Settings에서 BetterToken API Key를 다시 입력하고 앞뒤 spaces를 제거하세요.
`404`	API URL로 `https://bettertoken.ai/v1`을 사용하고 `/chat/completions`를 추가하지 마세요.
`model not found`	모델 광장에서 `YOUR_MODEL_ID`를 다시 복사하세요.
Settings가 적용되지 않음	provider를 저장하고 Zed를 완전히 종료한 다음 다시 여세요.
Zed가 이전 Key를 사용함	provider ID를 대문자 스네이크 표기법으로 바꾸고 `_API_KEY`를 붙인 변수를 확인하세요. 예를 들어 `BetterToken`은 `BETTERTOKEN_API_KEY`가 됩니다. 비어 있지 않은 값은 키체인보다 우선합니다. 변수를 해제하고 Zed를 다시 시작하면 저장된 Key를 사용합니다. Zed Key 우선순위를 참고하세요.

기술 세부 정보

Keychain, settings file 및 endpoint

Zed는 OpenAI 호환 provider를 통해 BetterToken을 호출합니다. 설정 화면은 Key를 시스템 키체인에 저장하며 settings.json에는 provider, api_url, 모델 선언만 포함됩니다. 이 가이드의 기본 Chat Completions 설정에서는 https://bettertoken.ai/v1을 Base URL로 사용하고 Zed가 엔드포인트 경로를 추가하게 하세요.