Clash for AI Clash for AI Docs

Local Desktop Gateway

Switch relay providers without rewriting every tool config.

Clash for AI gives coding tools, chat clients, and SDK workflows one stable local endpoint. The desktop app manages upstream providers, health checks, and request logs in one place.

Start here

The first version of the docs is intentionally focused: setup, provider compatibility, practical integration, and operational FAQs. That gives you a clean structure for expanding into screenshots, walkthroughs, and troubleshooting later.

Introduction

Understand the local gateway model, provider switching workflow, and current scope.

Read overview

Quick Start

Launch the app, add a provider, and connect a tool using one stable local endpoint.

Open quick start

User Guide

Read the fuller setup flow, troubleshooting order, and real behavior of Models fallback.

Read guide

Tool Integration

See the setup pattern for coding tools, desktop clients, and OpenAI SDK based scripts.

Browse integrations

Deep Link Import

See how websites can open the desktop app and prefill Provider or Models import data.

Read import spec

Deep Link Generator

Use a ready-to-test page that generates `clash-for-ai://` import links for third-party integrations.

Open generator

Providers

Read the /v1 guidance, model list behavior, and compatibility notes for relay APIs.

Read provider notes

FAQ

Find answers about fallback behavior, model selection responsibility, and protocol limits.

Open FAQ