무제한 Claude로 Zed 실행하기

Zed 어시스턴트는 손쉽게 부르게 됩니다 — 인라인 수정, 리팩터링, 빠른 질문 — 즉 하루 종일 모르는 사이에 호출을 쌓아갑니다. 정액 무제한 Claude 요금제는 이 리듬에 완벽히 맞아, 어시스턴트를 자유롭게 써도 비용은 결코 바뀌지 않습니다.

The provider that takes a custom URL

To put an unlimited gateway behind Zed you need a provider that accepts a base URL, and the native Anthropic provider does not offer one. The openai_compatible block does, so that is the route to a flat-rate endpoint.

This is not a workaround so much as the supported path for any third-party Claude endpoint. Set it up once and every assistant request in Zed draws from the same unlimited plan.

Because the connection is defined in one place, switching the whole editor onto unlimited is a single change: point api_url at the flat-rate gateway and every assistant feature follows. There is no per-feature billing toggle to hunt down, which keeps the unlimited setup simple. One api_url change is genuinely all that stands between a metered editor and an unmetered one. After that, every assistant feature simply inherits the flat rate.

Set api_url to the gateway

In settings.json add a provider under language_models.openai_compatible and set api_url to the gateway with /v1 on the end. Zed targets /chat/completions below that, hitting the gateway's OpenAI-compatible surface.

With the meter gone there is no reason to be cautious about how often the assistant fires. You can leave it wired into your everyday flow and let it answer as often as you like.

That freedom changes habits in practice: instead of saving the assistant for big questions, you reach for it on small ones too — renaming, quick explanations, one-line refactors. Those tiny calls add up fast on a meter, which is exactly why having them covered by a flat rate feels so different. Those small, frequent calls are exactly the ones a flat rate makes effortless to keep using. Over a working week they add up to far more value than the occasional big query.

List the models you want

Zed does not discover models automatically on a custom endpoint, so declare them in available_models. Add claude-sonnet-4-5 for everyday edits and claude-opus-4-8 for hard work, each with a name, a display_name, and a max_tokens.

On metered billing people often stick to the cheaper model to save money. On unlimited you can keep the strongest one selected as your default, because every model in the list costs the same flat rate.

Set max_tokens to the model's real capacity rather than a conservative number, since on a flat-rate plan there is no cost reason to clip responses short. A fuller max_tokens lets Claude return a complete refactor or explanation in one go instead of stopping partway. Sizing the limits to the model rather than the wallet is a habit unlimited lets you finally adopt. The result is fuller, less truncated answers in the editor.

Key in the keychain

The unlimited key does not belong in settings.json. Zed reads it from the OS keychain or an environment variable named for the provider, such as AIPRIME_API_KEY, so your synced config never carries the secret.

One key covers the whole plan. Enter it once when Zed prompts and the same flat-rate plan backs every assistant call you make for the period.

If you run Zed on more than one machine, each just needs the same unlimited key supplied locally through its keychain or environment; the shared settings file stays secret-free. The plan does not care which device a request comes from, so your laptop and desktop both draw from the one flat rate. The shared-config, local-key pattern scales cleanly from one machine to several with no extra cost. Each device draws from the same plan regardless of where you are working.

Or go native with ACP

If you prefer native Anthropic behaviour, run Claude Code as a Zed agent over the Agent Client Protocol. Claude Code carries its own ANTHROPIC_BASE_URL to the unlimited gateway, so Zed itself needs no Anthropic URL.

This pairs naturally with unlimited, because Claude Code's agentic loops move a lot of tokens. On a flat-rate plan you let those loops run to completion instead of cutting them short to manage spend.

It is the strongest argument for going the ACP route on this plan: a full agent that explores a codebase and edits across files is precisely the high-volume work that metered pricing makes you ration. With unlimited backing Claude Code, you point it at a hard task and let it work without watching a counter. For heavy agentic work the ACP route plus a flat rate is about as friction-free as Claude in an editor gets. You point Claude Code at a task and let it run to completion.

// Zed settings.json
{
  "language_models": {
    "openai_compatible": {
      "aiprime": {
        "api_url": "https://claudeapikey.dev/v1",
        "available_models": [
          { "name": "claude-sonnet-4-5",
            "display_name": "Claude Sonnet",
            "max_tokens": 200000 }
        ]
      }
    }
  }
}
// Key goes in the keychain / AIPRIME_API_KEY env var, NOT this file.

FAQ

무제한 Claude 요금제로 Zed를 실행할 수 있나요?
네 — api_url을 {SITE}/v1로 한 openai_compatible 프로바이더를 추가하고 Claude 모델을 선언하면, 정액 요금제가 모든 어시스턴트 호출을 커버합니다.

왜 openai_compatible 블록을 쓰나요?
Zed의 네이티브 Anthropic 프로바이더에는 api_url 재정의가 없습니다. openai_compatible 블록에는 있으므로 이를 통해 커스텀 무제한 엔드포인트에 도달합니다.

왜 무제한이 Zed에 좋은가요?
어시스턴트는 인라인 수정과 질문에 끊임없이 쓰이며 하루 종일 호출을 쌓습니다. 정액 무제한은 그 비용을 고정으로 유지합니다.

토큰 한도가 있나요?
요금제 기간 동안 토큰 한도는 없으며, 모두를 위해 게이트웨이를 빠르게 유지하는 공정 사용 속도 제한만 있습니다.