기본 콘텐츠로 건너뛰기

Zed AI Tutorial: Agent Panel, Own Keys and Pro Limits

Summary: Zed is a fast, open-source code editor with a built-in AI agent, and the editor itself is free. You can run its agent on the free Personal plan with your own API keys, a local Ollama model, or an external agent such as Claude Agent or Codex, while Zed's hosted models and its Zeta edit predictions need Pro ($10/month with $5 of tokens included). This guide walks through the setup in the order most people need it, and shows where the free path stops.

What you get in Zed's AI, in plain terms

Zed's AI features split into three parts, and knowing which part you are touching saves a lot of confusion later:

  • Zed Agent: the native agent that lives in the Agent Panel. It reads and searches your project, edits files, runs terminal commands, and shows its changes in a review view. It uses whatever model you configure under LLM Providers.
  • External Agents: other coding agents (Claude Agent, Codex, OpenCode, Copilot, Cursor, Pi Coding Agent and more) that plug into the same panel through the Agent Client Protocol (ACP). They keep their own login, model choice and billing. Zed's docs state that Zed does not charge for External Agents.
  • Edit Prediction: tab-to-accept completions while you type. The default provider is Zeta, Zed's own open model, which needs a Pro, trial, Student or Business plan. On Free you can switch the provider to GitHub Copilot, Codestral, Mercury Coder or a local model.

There is also an Inline Assistant for rewriting a selection, and Terminal Threads for running an agent CLI inside a terminal-backed thread. If you only want an editor, you can switch every AI feature off with the disable_ai setting.

Step 1: Install Zed

The official installation page lists these routes:

  • macOS: download from zed.dev/download, or run brew install --cask zed.
  • Windows: download the installer, or run winget install -e --id ZedIndustries.Zed.
  • Linux: run curl -f https://zed.dev/install.sh | sh (a preview channel and pinned versions are also supported through environment variables).

The editor works without signing in. You only need a Zed account for hosted models, Zeta predictions, and collaboration features.

Step 2: Open the Agent Panel and pick a model path

Open the Command Palette and run agent: new thread, or click the sparkle icon in the status bar. The first time, the panel asks you to configure either a model for the Zed Agent or an External Agent. You have four realistic choices:

Option A: Your own API key (free plan)

Run agent: open settings, go to LLM Providers, and paste a key. The docs list first-class support for Anthropic, OpenAI, Google AI, Mistral, DeepSeek, xAI and OpenCode, plus any OpenAI-compatible or Anthropic-compatible endpoint. Keys saved this way go into your system keychain, not into settings.json. One detail worth knowing: a non-empty environment variable such as a provider key in your shell profile takes precedence over the keychain value, so if Zed keeps using an old key, unset the variable and restart Zed.

Option B: A local model with Ollama (free)

  1. Install Ollama from ollama.com/download.
  2. Pull a model, for example ollama pull mistral.
  3. Make sure the server is running (open Ollama.app on macOS, or run ollama serve).
  4. Pick the model in Zed's model dropdown. Zed discovers pulled models automatically.

Zed sends a context length of 4,096 tokens to Ollama by default. That is small for agent work, where the model has to hold file contents and tool results, so raise language_models.ollama.context_window (the docs example uses 8192) if answers start losing track of your files.

Option C: An External Agent you already pay for

Run zed: acp registry, or go to Agent Settings, External Agents, Add Agent, Install from Registry. Once installed, the agent shows up in the panel's "New Thread" menu. The important gotcha: an Anthropic or OpenAI key you gave the Zed Agent does not configure Claude Agent or Codex. Each external agent logs in on its own; for Claude Agent, the docs tell you to open a thread and run /login.

Option D: Zed Pro hosted models

Pro gives you Zed-hosted models from several labs without managing keys. Usage is metered in tokens and billed at the provider's list price plus 10%, with $5 included each month.

Step 3: Give the agent context and rules

Type @ in the message box to attach files, folders, symbols, earlier threads, diagnostics, branch diffs or a URL. The agent can search on its own, but the docs note that explicit context improves quality and reduces latency.

For rules that should apply every time, Zed reads instruction files. Personal instructions live in ~/.config/zed/AGENTS.md (under %APPDATA%\Zed\ on Windows). For a project, Zed uses the first matching file from a list that includes .rules, .cursorrules, .windsurfrules, .clinerules, .github/copilot-instructions.md, AGENT.md, AGENTS.md, CLAUDE.md and GEMINI.md. Because only the first match is used, a leftover .cursorrules from an old setup can silently win over the AGENTS.md you just wrote.

Step 4: Decide what the agent may do without asking

Tool permissions control which actions run automatically. Since Zed v0.224.0 the main switch is agent.tool_permissions.default (older versions used the boolean agent.always_allow_tool_actions). You can then write per-tool regex rules for the terminal, file edits, deletes, moves, fetches and web search. A sensible starting point is the pattern from the docs: allow by default, but keep the terminal on confirm, auto-approve only known build and test commands, and always confirm anything with sudo. Deny rules block an action even when the default is set to allow.

Step 5: Review, keep or roll back

After the agent edits files, the panel shows how many files and lines changed. Click Review Changes to open every change in one multi-file tab, where you can accept or reject each hunk. Every message that produced edits also gets a Restore Checkpoint button, which returns the project to its state before that message, even if you stopped the agent midway. For long sessions, "New From Summary" starts a fresh thread seeded with a summary of the old one, which helps when you approach the model's context limit.

Zed plans compared

Plan Price AI included Edit predictions (Zeta) Best for
Personal (Free) $0, forever Own API keys, local models and External Agents; no Zed-hosted models Not included; use Copilot, Codestral or a local model instead People who already have keys or an agent subscription
Pro $10/month All Zed-hosted models, $5 of tokens per month, then list price +10% Unlimited Solo developers who want one bill and no key management
Business $30/seat/month Hosted models at usage rates (no bundled credit) or your own keys Unlimited Teams that need model policies, data controls and one invoice

Also listed in the docs: a Student plan, free for one year for verified university students, with $10/month in token credit and most hosted models. The Pro trial lasts 14 days with $5 of usage on one model (GPT-6 Luna), needs no credit card, and falls back to Free on its own.

Editor's note

Good fit: developers who want an agent inside a fast native editor and already pay for an API key, Claude, ChatGPT/Codex or Copilot. The free plan covers that without a Zed bill.

Not a fit: anyone who expects free AI autocomplete out of the box. Zeta predictions are a paid feature, and teams that need SSO today should note that the pricing page lists SSO, SAML and SCIM as planned, not available.

Gotchas I checked in the docs:

  • "My key works for the Zed Agent but Claude Agent asks me to log in." Expected. External agents have their own auth; run their login flow.
  • Zed uses the wrong API key. An environment variable overrides the keychain. Unset it and restart.
  • The agent ignores my AGENTS.md. Check for an older rules file earlier in the list, such as .rules or .cursorrules.
  • Pro bill higher than $10. The default monthly spend limit is $10 on top of the subscription, so up to $20 total. Set it to $0 on the billing page at dashboard.zed.dev to cap spend at exactly $10.
  • Local model forgets files mid-task. Raise the Ollama context window from the 4,096 default.

FAQ

Can I use Zed's AI agent completely free?

Yes, with your own API key, a local model, or an External Agent. You pay the model provider (or nothing, for local models), not Zed. Only Zed-hosted models and Zeta predictions require Pro.

What happens when the $5 of Pro tokens runs out?

Extra usage is billed at API list price plus 10%, charged at the end of the month or for every additional $10, whichever comes first, up to the spend limit you set. When the limit is hit, hosted usage stops until it resets on your billing date.

Does the Business plan include AI credits?

No. Business seats have no fixed credit allotment; members use hosted models at standard usage rates or bring the company's own provider keys. There is no minimum seat count and no free trial for Business.

Related on lightmind24: if you prefer an agent that runs as a VS Code extension, see the Cline tutorial on plan, act and rollback. If Option B fails at the Ollama step, the Ollama troubleshooting guide covers server and GPU errors, and the Codex CLI fixes post helps if Codex as an External Agent will not log in.

Start on the free plan with a key you already have, and pay for Pro only if you find yourself missing hosted models or Zeta predictions.

Screenshots: official zed.dev pricing and documentation pages, captured by the author; see the official screenshots at the end of this post.

Last verified: 2026-11-02
Sources:
Zed pricing
Zed docs: Plans and Pricing
Zed docs: AI Quick Start
Zed docs: Agent Panel
Zed docs: External Agents
Zed docs: Use API Access
Zed docs: Use a Local Model
Zed docs: Instructions
Zed docs: Tool Permissions
Zed docs: Edit Prediction
Zed docs: Installation

Uploaded Image Uploaded Image Uploaded Image Uploaded Image Uploaded Image

댓글

이 블로그의 인기 게시물

브루(Vrew) 요금제 정리: 무료 200크레딧으로 어디까지 쓸 수 있나

요약: 영상 자막 편집기 브루(Vrew)는 2026년 4월 22일부터 기능별 사용량 대신 '통합 크레딧' 하나로 요금을 매겨요. 무료 플랜은 매달 200크레딧이 들어오는데, 음성 분석(자동 자막)만 쓰면 최대 200분 분량이라 짧은 영상 몇 편은 충분하지만, 영상 초반의 Vrew 마크를 지우려면 유료 플랜이 필요해요. 이 글은 브루 공식 가격 페이지와 고객센터 공지를 2026년 10월 23일에 다시 확인해, 크레딧 계산법과 플랜 고르는 기준을 정리했어요. 목차 브루 요금 구조: 통합 크레딧이란 1크레딧으로 할 수 있는 일 무료 플랜으로 되는 것과 안 되는 것 유료 플랜 4종 비교표 월 구독·연 구독·기간 이용권, 무엇이 이득일까 상황별 추천: 학생·직장인·유튜버 크레딧이 모자랄 때: 사용 기록 지우개 업그레이드·환불 전에 알아둘 규칙 운영자 메모, 자주 묻는 질문 1. 브루 요금 구조: 통합 크레딧이란 예전 브루는 플랜마다 음성 분석 몇 분, AI 목소리 몇 자, 번역 몇 자처럼 기능별 한도를 따로 줬어요. 그런데 보이저엑스(브루 운영사)가 실제 이용 데이터를 보니 한두 가지 기능만 집중해서 쓰는 사람이 훨씬 많았다고 해요. 그래서 2026년 4월 22일 업데이트부터는 플랜마다 정해진 크레딧을 받고, 어떤 기능에 쓸지는 내가 정하는 방식으로 바뀌었어요. 플랜별 매달 지급량은 Free 200 · Light 2,000 · Standard 10,000 · Business 12,000크레딧 이에요. 공식 공지에 따르면 무료 사용자는 매달 1일에, 유료 사용자는 매월 결제일에 충전되고, 남은 크레딧은 다음 달로 넘어가지 않아요. 바뀐 뒤 무엇이 좋아졌나 공지에 나온 예시가 이해하기 쉬워요. Standard 플랜에서 AI 목소리만 쓰면 예전에는 최대 50만 자였지만, 지금은 1만 크레딧을 모두 AI 목소리에 몰아 쓸 수 있어 최대 100만 자가 돼요. 반대로 여러 기능을 골고루 쓰는 사람은 크레딧이 기능끼리 ...

에이닷 전화 vs 익시오: 통화 녹음·AI 요약, 내 통신사·폰에 맞는 앱 고르기

요약: 통화 녹음과 AI 요약을 쓰고 싶다면 먼저 내 통신사와 휴대폰 종류부터 확인해야 해요. LG유플러스 고객은 무료 앱 익시오, SKT 고객은 에이닷 전화가 가장 기능이 많고, 다른 통신사의 아이폰 사용자는 iOS에 들어 있는 기본 통화 녹음·전사 기능이 현실적인 선택이에요. 이 글은 2026-10-30에 SKT·LG유플러스·Apple 공식 페이지와 도움말을 직접 확인해 세 가지를 비교했어요. 왜 '앱 기능'보다 '내 조건'을 먼저 봐야 할까요 통화 요약 앱 비교 글을 보면 기능 목록부터 나열하는 경우가 많아요. 그런데 실제로 써 보려는 사람에게 가장 먼저 걸리는 건 기능이 아니라 이용 조건 이에요. 익시오는 LG유플러스 고객 전용이고, 에이닷 전화는 누구나 설치할 수 있지만 통역콜·baro 같은 기능은 SKT 고객에게만 열려 있어요. 아이폰은 운영체제 구조상 앱이 통화를 마음대로 녹음하기 어려워서, 통신사 앱이 안 되면 iOS 기본 기능에 기대야 해요. 그래서 이 글은 "어떤 앱이 제일 좋은가"보다 "내 통신사·내 폰에서 무엇을 쓸 수 있나" 순서로 정리했어요. 기능 차이는 그다음이에요. 한눈에 비교: 에이닷 전화 vs 익시오 vs 아이폰 기본 통화 녹음 구분 에이닷 전화 (SKT) 익시오 ixi-O (LG유플러스) 아이폰 기본 통화 녹음 (Apple) 누가 쓸 수 있나 통신사 구분 없이 앱 설치 가능. 단, 통역콜·baro·그룹통화 발신 등은 SKT 고객 전용 U+ 모바일 고객. 타 통신사, 만 14세 미만, 선불요금제 고객은 제한 (공식 사이트 FAQ상 알뜰폰 중 KB리브엠은 예외) 지원 국가·언어의 iPhone 사용자. 1명과 통화할 때만 녹음 가능 지원 OS·기기 Android 10 이상, iOS 16 이상 iOS 17 이상 iPhone 12 이상 / Android...

타입캐스트 vs 클로바더빙: 수익 나는 채널에 쓸 때 무료·유료 조건 비교

요약 타입캐스트와 클로바더빙은 둘 다 글만 입력하면 한국어 AI 목소리를 만들어 주는 서비스지만, 무료로 쓸 수 있는 범위가 꽤 다릅니다. 클로바더빙 무료는 매달 15,000자까지 쓸 수 있는 대신 수익이 생기는 채널에는 쓸 수 없고, 타입캐스트 무료는 처음에 주는 약 5분 분량의 다운로드로 끝나는 체험판에 가깝습니다. 광고 수익이 붙은 유튜브나 쇼핑몰 영상에 넣을 목소리라면 처음부터 유료 플랜 조건을 보고 고르는 편이 안전합니다. 왜 이 두 서비스를 같이 비교하나 쇼츠 내레이션, 수업 자료 더빙, 상품 소개 영상처럼 "내 목소리 대신 AI 목소리"가 필요할 때 한국 사용자들이 가장 많이 찾는 곳이 네오사피엔스의 타입캐스트 와 네이버의 클로바더빙 입니다. 기능 소개만 보면 비슷해 보이지만, 실제로 문제가 되는 건 음질보다 "이 목소리를 내 채널에 써도 되나" 입니다. 그래서 이 글은 기능 나열보다 무료 사용 범위, 출처 표기 의무, 유료 플랜 가격과 다운로드 한도를 중심으로 정리했습니다. 모든 수치는 2026년 10월 25일에 두 서비스의 공식 요금 페이지와 고객센터 도움말에서 직접 다시 확인한 내용입니다. 한눈에 보는 비교표 항목 타입캐스트 무료 타입캐스트 베이직 클로바더빙 Free 클로바더빙 Standard 월 요금 0원 9,900원 (연간 결제 시 10% 할인) 0원 19,900원 (네이버 클라우드 플랫폼에서 결제) 무료·포함 사용량 음성 생성·재생 무제한, 다운로드는 최초 3,000크레딧(약 5분) 1회 지급 월 30,000크레딧(약 60분) 월 15,000자, 다운로드 월 20회, 프로젝트 누적 5개 (매월 1일 갱신) 월 30,000자, 다운로드 월 40회, 프로젝트 누적 20개 쓸 수 있...