Zed Editor Integration Guide

Zed is a high-performance modern code editor with built-in AI assistant capabilities that supports multiple large language models. This guide explains how to integrate Zed Editor with OPEAI Platform to leverage cutting-edge models for programming assistance.

Quick Start

1. Obtain API Key

Visit the OPEAI Platform Console and create your dedicated API Key.

2. Add Provider

You can configure OPEAI Platform using one of the following methods:

Visual Configuration (Recommended)

Add configuration through the Agent Panel visual interface without manually editing JSON files.

Steps

1. Press Cmd + Shift + A (Windows/Linux: Ctrl + Shift + A) to open the Agent Panel.
2. Click + Add Provider in the LLM Providers area.
3. Enter the configuration information according to the table below:

No.	Field Name	Configuration Value
①	Provider Name	OPEAI
②	API URL	https://api-platform.ope.ai/v1
③	API Key	Your OPEAI API Key
④	Model Name	Claude-4.6-Sonnet
⑤	Max Completion Tokens	200000
⑥	Capabilities	Check Tools and Images (model-dependent)

4. Click + Add Model to continue adding other models (e.g., Claude-4.6-Opus, GPT-5.4-Pro).

Edit settings.json

Suitable for batch adding multiple models; editing the configuration file is more efficient.

Steps

1. Press Cmd + , (Windows/Linux: Ctrl + ,) to open settings.
2. Click Edit in settings.json in the top right corner.
3. Add the following content to the configuration file:

~/.config/zed/settings.json

{
  "language_models": {
    "openai_compatible": {
      "OPEAI": {
        "api_url": "https://api-platform.ope.ai/v1",
        "available_models": [
          {
            "name": "Claude-4.6-Sonnet",
            "display_name": "Claude Sonnet 4.6",
            "max_tokens": 200000,
            "max_output_tokens": 64000,
            "capabilities": {
              "tools": true,
              "images": true
            }
          },
          {
            "name": "Claude-4.6-Opus",
            "display_name": "Claude Opus 4.6",
            "max_tokens": 200000,
            "max_output_tokens": 64000,
            "capabilities": {
              "tools": true,
              "images": true
            }
          },
          {
            "name": "Claude-4.5-Haiku",
            "display_name": "Claude Haiku 4.5",
            "max_tokens": 200000,
            "max_output_tokens": 64000,
            "capabilities": {
              "tools": true,
              "images": true
            }
          },
          {
            "name": "GPT-5.4-Pro",
            "display_name": "GPT-5.4 Pro",
            "max_tokens": 1050000,
            "max_output_tokens": 128000,
            "capabilities": {
              "tools": true,
              "images": false
            }
          },
          {
            "name": "GPT-5.4",
            "display_name": "GPT-5.4",
            "max_tokens": 1050000,
            "max_output_tokens": 128000,
            "capabilities": {
              "tools": true,
              "images": false
            }
          },
          {
            "name": "DeepSeek-V3.2",
            "display_name": "DeepSeek V3.2",
            "max_tokens": 128000,
            "max_output_tokens": 8000,
            "capabilities": {
              "tools": true,
              "images": false
            }
          },
          {
            "name": "Gemini-3-Pro",
            "display_name": "Gemini 3 Pro",
            "max_tokens": 1000000,
            "max_output_tokens": 64000,
            "capabilities": {
              "tools": true,
              "images": true
            }
          }
        ]
      }
    }
  }
}

4. After saving the file, Zed will automatically display an API Key input dialog; enter your OPEAI API Key.

tip

The settings.json method is suitable for batch model management; simply edit the available_models array to add/remove models.

Security Note: API Keys are securely stored in the system keychain (macOS Keychain / Linux Secret Service) and are not written to configuration files in plain text.

---

Getting Started

Zed Agent Panel provides two working modes:

Mode	Description
Zed Agent	Built-in AI assistant that uses your configured LLM Provider (e.g., OPEAI).
External Agents	External integration plugins (e.g., Claude Code, Gemini CLI), running independently.

Start Zed Agent conversation:

Step	Operation
①	Click the + in the left panel → Select Zed Agent (shortcut: Cmd/Ctrl + N).
②	If external plugins are installed, they will appear in the External Agents area.
③	In the model selector at the bottom right, switch to the OPEAI group and select a specific model.

---

Recommended Models

Use Case	Recommended Model	Features
Core Coding	Claude-4.6-Sonnet	200K context, strong overall capability, fast response.
Top-tier Reasoning	Claude-4.6-Opus	200K context, strongest reasoning, ideal for architecture design.
Quick Q&A	Claude-4.5-Haiku	200K context, ultra-fast response, low cost.
Ultra-long Context	GPT-5.4-Pro	1M context, OpenAI flagship model.
Cost Optimization	DeepSeek-V3.2	128K context, extremely low cost, preferred for high-frequency calls.

For the complete model list, please check Model Pricing.

---

Model Configuration Reference

Each model requires the following parameters:

Field	Required	Description
name	Yes	Model ID (e.g., Claude-4.6-Opus, GPT-5.4)
display_name	No	UI display name
max_tokens	Yes	Context window size (e.g., 200000)
max_output_tokens	No	Maximum output tokens (e.g., 64000)
capabilities.tools	No	Whether Function Calling is supported
capabilities.images	No	Whether image input is supported

Common Model Configuration Quick Reference

Model ID	Max Tokens	Max Output	Tools	Images
Claude-4.6-Opus	200000	64000	Yes	Yes
Claude-4.6-Sonnet	200000	64000	Yes	Yes
Claude-4.5-Haiku	200000	64000	Yes	Yes
GPT-5.4-Pro	1050000	128000	Yes	No
GPT-5.4	1050000	128000	Yes	No
DeepSeek-V3.2	128000	8000	Yes	No
Gemini-3-Pro	1000000	64000	Yes	Yes

---

Troubleshooting

OPEAI Provider Not Showing in Model List

• Confirm that the Provider has been correctly added in the Agent Panel or settings.json.
• Try restarting Zed Editor.
• Check if the API URL is correct: https://api-platform.ope.ai/v1

Authentication Error

• Confirm API Key format is correct (starts with sk-).
• Open command palette Cmd/Ctrl + Shift + P → Search for language model: reset credentials → Re-enter Key.
• Visit OPEAI Platform Console to confirm Key validity.

Tool Use Not Responding

• Confirm that "capabilities": { "tools": true } is set in the configuration.
• Some models do not support tool calls; refer to the quick reference table above.

Model Returns Error or Timeout

• Check network connection, confirm access to https://api-platform.ope.ai.
• Try switching to another model (e.g., Claude-4.5-Haiku) for testing.
• View Zed logs: Help > View Logs.

Related Links

• Zed Official Documentation
• OPEAI Platform Console
• OPEAI Platform API Documentation
• Model Pricing