Zed

Zed is a fast native editor with a built-in agent panel. It supports OpenAI-compatible providers directly in settings.json, so pointing its agent at Hyphen takes one block.

Setup guide: this config comes from Zed's official documentation and has not been run end to end against the gateway. Corrections to support@hyphen-solution.com.

1. Get a key

app.hyphen-solution.com → sign in → pick a plan or credit pack → Dashboard → API Keys. Copy the sk-... key.

2. Configure

Open Zed's settings with cmd-, (ctrl-, on Linux) and add this to ~/.config/zed/settings.json:

Code
{
  "language_models": {
    "openai_compatible": {
      "hyphen": {
        "api_url": "https://api.hyphen-solution.com/v1",
        "available_models": [
          {
            "name": "minimax-m3",
            "display_name": "MiniMax M3 (Hyphen)",
            "max_tokens": 200000,
            "max_output_tokens": 32000,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false
            }
          },
          {
            "name": "minimax-m2.7",
            "display_name": "MiniMax M2.7 (Hyphen)",
            "max_tokens": 200000,
            "max_output_tokens": 32000,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false
            }
          },
          {
            "name": "minimax-m2.5",
            "display_name": "MiniMax M2.5 (Hyphen)",
            "max_tokens": 200000,
            "max_output_tokens": 32000,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false
            }
          }
        ]
      }
    }
  }
}

3. Set the key

Do not put the key in settings.json. Zed says so explicitly, and the file is often in version control. Zed derives the environment variable name from the provider ID, upper-snake-cased with _API_KEY appended. The provider above is called hyphen, so the variable is HYPHEN_API_KEY:

Code
export HYPHEN_API_KEY="sk-YOUR_KEY"

Put that in ~/.zshrc or ~/.bashrc, then launch Zed from a shell that has it so the variable is inherited. Launching from the Dock or a desktop icon will not see it.

Alternatively, paste the key into the Agent Panel's provider settings UI, which stores it in Zed's own keychain entry. That works regardless of how Zed is launched.

4. Verify

Open the Agent Panel (cmd-?), click the model picker at the bottom of the panel, and select MiniMax M3 (Hyphen) under the hyphen provider. Then:

Code
Reply with the single word: connected

If it prints connected, you are wired up.

Notes on the fields

• api_url ends in /v1. Zed appends /chat/completions itself.
• max_tokens is the context window Zed advertises, not your output cap. 200000 is a safe value for the standard M-series. Drop it to 60000 if you add minimax-m2-her, and raise it for minimax-text-01.
• max_output_tokens is the per-response cap Zed sends. Keep it generous. The M-series are reasoning models and a tight output budget gets consumed by internal reasoning, returning nothing. See Choosing a model.
• capabilities.tools must be true or the agent panel cannot edit files.
• images: false is correct. The catalog is text only.

Troubleshooting

• Provider does not appear. settings.json is invalid JSON, or Zed needs a restart. Zed shows a parse error inline when the file is broken.
• 401. Zed cannot see HYPHEN_API_KEY. Launch Zed from a terminal (zed .) or enter the key in the Agent Panel provider settings instead.
• Empty replies. Raise max_output_tokens.
• 429. Monthly budget spent. See Rate limits & caps.
• Config shape changed? Zed's AI settings move between releases. Confirm the current shape at Zed's API access docs.

Related

• Choosing a model: which model for which job.
• Other OpenAI-compatible clients: Roo Code, Kilo Code, Cursor, Cline.