Zed Editor
Zed를 선택하는 이유
Zed 는 현재 AI 코딩 경험이 가장 완벽한 에디터입니다:
- 네이티브 Agent 지원 — Claude Code, Codex CLI, Gemini CLI를 외부 에이전트로 내장
- 커스텀 LLM Provider — OpenAI 호환 프로토콜을 통해 모든 모델 접속
- 고성능 — Rust로 작성되어 빠른 시작과 낮은 리소스 사용
OfoxAI와 함께 사용하면 하나의 API Key로 Zed에서 100개 이상의 주요 대형 모델을 사용할 수 있습니다.
빠른 시작
1. API Key 발급
OfoxAI 콘솔 에서 API Key를 생성하세요.
2. Provider 추가
Agent Panel 추가 (권장)
Agent Panel을 통해 시각적으로 추가할 수 있으며, JSON 편집이 필요 없습니다.
⌘ + Shift + A를 눌러 Agent Panel을 엽니다- LLM Providers 영역의 + Add Provider를 클릭합니다
- 아래 그림과 같이 설정을 입력합니다:
| 표시 | 필드 | 값 |
|---|---|---|
| ① | Provider Name | OfoxAI |
| ② | API URL | https://api.ofox.ai/v1 |
| ③ | API Key | OfoxAI API Key |
| ④ | Model Name | openai/gpt-5.2 |
| ⑤ | Max Completion Tokens | 512000 |
| ⑥ | Capabilities | 모델이 지원하는 기능 체크 |
+ Add Model을 클릭하여 더 많은 모델을 추가할 수 있습니다.
API Key는 시스템 키체인(macOS Keychain / Linux Secret Service)에 안전하게 저장되며, 설정 파일에 평문으로 기록되지 않습니다.
시작하기
Zed Agent Panel에는 두 가지 모드가 있습니다:
| 모드 | 설명 |
|---|---|
| Zed Agent | 내장 AI 어시스턴트, 설정한 LLM Provider(예: OfoxAI) 사용 |
| External Agents | 외부 Agent(Claude Code, Codex CLI, Gemini CLI), 독립 실행 |
Zed Agent로 대화를 시작합니다:
| 단계 | 작업 |
|---|---|
| ① | + 클릭 → Zed Agent 선택 (⌘ + N) |
| ② | External Agents 영역에 연결된 외부 Agent 표시 |
| ③ | 오른쪽 하단 모델 선택기 → OfoxAI 그룹 → 모델 선택 |
추천 모델
| 시나리오 | 모델 | 설명 |
|---|---|---|
| Agent 코딩 | openai/gpt-5.2 | 512K 컨텍스트, 종합 최강 |
| 빠른 Q&A | openai/gpt-5-mini | 256K 컨텍스트, 고속 저비용 |
| 초장문 출력 | moonshotai/kimi-k2.5 | 262K 컨텍스트 / 262K 출력 |
| 중국어 시나리오 | bailian/qwen3-max | 256K 컨텍스트, 중국어-영어 이중 언어 |
전체 모델 목록은 모델 카탈로그를 참조하세요.
더 많은 모델 추가
각 모델에는 다음 파라미터가 필요합니다:
| 필드 | 필수 | 설명 |
|---|---|---|
name | 예 | 모델 ID, 예: openai/gpt-5.2 |
display_name | 아니오 | UI 표시 이름 |
max_tokens | 예 | 컨텍스트 윈도우 크기 |
max_output_tokens | 아니오 | 최대 출력 토큰 수 |
capabilities.tools | 아니오 | Function Calling 지원 여부 |
capabilities.images | 아니오 | 이미지 입력 지원 여부 |
고급 팁
수동으로 파라미터를 입력하기 번거로운가요? 이 페이지 오른쪽 상단의 Copy Page를 클릭하여 전체 텍스트를 복사하거나, 이 페이지 URL을 https://api.ofox.ai/v1/models와 함께 AI에게 전송하여 완전한 settings.json 설정을 자동으로 생성하도록 하세요.
설정 페이지로 이동 → 오른쪽 상단의 Edit in settings.json을 클릭하여 붙여넣기하세요:
문제 해결
모델 목록에서 OfoxAI가 보이지 않는 경우
settings.json 형식이 올바른지 확인하고, 저장 후 Zed를 재시작하세요.
인증 오류 메시지가 표시되는 경우
명령 팔레트 ⌘ + Shift + P → language model: reset credentials 검색 → API Key를 다시 입력하세요.
모델이 도구 호출을 지원하지 않는 경우
capabilities.tools를 false로 설정하세요.