# Use Hanzo AI with Cursor — Hanzo AI

> Use Hanzo AI models inside Cursor IDE by adding a custom API provider. Access Zen, GPT-4.1, Claude Sonnet, and 50+ other models directly in your editor.

[Integrations](https://hanzo.ai/integrations)/Cursor

🖱️Platforms & Editors

# Use Hanzo AI with Cursor

Use Hanzo AI models inside Cursor IDE by adding a custom API provider. Access Zen, GPT-4.1, Claude Sonnet, and 50+ other models directly in your editor.

Base URL: `https://api.hanzo.ai/v1`

API Key: Get yours at [hanzo.ai/signup](https://hanzo.ai/signup) · Fully OpenAI-compatible · 500+ models available

🖱️

Created by [Anysphere](https://cursor.com)

License: Proprietary · [View source on GitHub →](https://github.com/getcursor/cursor)

Hanzo AI is OpenAI-compatible, so existing Cursor code works with zero refactoring. We deeply appreciate the Anysphere team for building and maintaining this open-source project.

## Cursor settings

json

```
// Settings > Models > Add custom model { "provider": "openai-compatible", "name": "Hanzo AI", "baseUrl": "https://api.hanzo.ai/v1", "apiKey": "your-hanzo-api-key", "models": ["zen4-pro", "zen4-max", "openai/gpt-4.1", "anthropic/claude-sonnet-4-6"] }
```

## Available models

bash

```
# Query Hanzo models list curl https://api.hanzo.ai/v1/models \ -H "Authorization: Bearer $HANZO_API_KEY" | jq '.data[].id'
```

## Test connection

bash

```
curl https://api.hanzo.ai/v1/chat/completions \ -H "Authorization: Bearer $HANZO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"zen4-pro","messages":[{"role":"user","content":"Hello from Cursor!"}],"max_tokens":50}'
```

## Tips

bash

```
# zen4-pro: best for code generation # zen4-coder: specialized code model # zen4-thinking: step-by-step reasoning # openai/gpt-4.1: advanced reasoning # All available at api.hanzo.ai/v1
```

## Ready to get started?

Create a free account and get your API key. 100K API calls/month free forever.

[Get API Key — Free](https://hanzo.ai/signup)[Browse Models](https://hanzo.ai/models)

## More integrations

[OpenAI Python SDK](https://hanzo.ai/integrations/openai-sdk)[Anthropic SDK](https://hanzo.ai/integrations/anthropic-sdk)[LangChain](https://hanzo.ai/integrations/langchain)[LlamaIndex](https://hanzo.ai/integrations/llamaindex)[Vercel AI SDK](https://hanzo.ai/integrations/vercel-ai-sdk)[Hugging Face](https://hanzo.ai/integrations/huggingface)[AutoGen](https://hanzo.ai/integrations/autogen)[CrewAI](https://hanzo.ai/integrations/crewai)[DSPy](https://hanzo.ai/integrations/dspy)[Haystack](https://hanzo.ai/integrations/haystack)[Continue.dev](https://hanzo.ai/integrations/continue-dev)[GitHub Copilot](https://hanzo.ai/integrations/github-copilot)[Docker](https://hanzo.ai/integrations/docker)[Kubernetes](https://hanzo.ai/integrations/kubernetes)[Python](https://hanzo.ai/integrations/python)[TypeScript](https://hanzo.ai/integrations/typescript)[Go](https://hanzo.ai/integrations/go)[Rust](https://hanzo.ai/integrations/rust)