Harici araçları OpenDesign Cloud API'sine bağlayın

OpenDesign API anahtarlarınızı web üzerinden yönetin ve planınızın desteklediği modelleri harici bir agent'ta kullanın. OpenDesign masaüstü uygulaması gerekli değildir. Tek tıklamayla kurulum, bağlantıyı bilgisayarınızdaki CC Switch aracılığıyla içe aktarır.

İhtiyacınız olan bağlantıyı seçin

Bir sağlayıcı anahtarını OpenDesign içine aktarmak için BYOK kurulumunu izleyin. Bu kılavuz diğer yönü ele alır: OpenDesign Cloud model API'sini Claude Code veya Codex gibi harici bir araçtan kullanmak.

Başlamadan önce

OpenDesign Cloud API; Go, Plus, Pro ve Max planlarında kullanılabilir. Free planı desteklenmez. Hesabınızdaki model listesi, kullanabileceğiniz metin modellerini belirler; ekran görüntülerinde gösterilen modeller yalnızca örnektir ve her plan için kullanım hakkı sunulduğu anlamına gelmez.

Desteklenen agent'lar Claude Code, Codex, Grok Build, OpenCode, OpenClaw ve Hermes Agent'tır. Önce seçtiğiniz agent'ı yükleyin. CC Switch zaten yüklüyse yükleme adımını atlayabilirsiniz.

Web'de API anahtarlarını açın

Web'de OpenDesign hesap yönetiminde oturum açın ve kenar çubuğundan API keys (API anahtarları) seçeneğini belirleyin. Sağ üstteki One-click agent setup (tek tıklamayla agent kurulumu) seçeneğini seçin. Mevcut bir anahtarınız olmadan başlayabilirsiniz.

API keys sayfasının tamamı: One-click agent setup sağ üsttedir; Connection setup, API biçimlerini ve bunların temel URL'lerini içerir.

Manuel kurulum için Connection setup'ı açın, aracınızın gerektirdiği API biçimini (Chat Completions, Responses veya Messages) seçin ve API base URL'sini kopyalayın. Uç nokta ile protokolün eşleştiğinden emin olun. Aşağıdaki adımlar tek tıklamayla içe aktarma işlemini gösterir.

1. Adım: CC Switch'i yükleyip açın

One-click agent setup bölümünde Download for Mac veya Download for Windows seçeneğini belirleyin.
CC Switch'i yükleyip açın. Zaten yüklüyse bu adımı atlayın.

2. Adım: Bir agent ve model seçin

Hedef agent'ınızı seçin. Varsayılan olarak Claude Code seçilidir.
Planınız için Model listesinden bir metin modeli seçin. Kullanılabilir model yoksa başka bir agent seçin veya planınızı kontrol edin; ekran görüntüsünden bir model adını kopyalamak erişim hakkı sağlamaz.

Kurulum iletişim kutusu: Önce hedef agent'ı, ardından hesabınızda kullanılabilir bir modeli seçin.

3. Adım: İçe aktarın ve yeniden başlatın

Import into CC Switch seçeneğini belirleyin. Bu işlem, Claude Code · Mac gibi agent ve sistem adına göre adlandırılmış yeni bir anahtar oluşturur ve CC Switch'i açar.
Tarayıcı isteminde Open CC Switch seçeneğine izin verin. CC Switch'teki API Endpoint, anahtar ve modeli gözden geçirin, ardından Import seçeneğini belirleyin.
Web sayfasına dönüp Done seçeneğini veya başka bir bağlantı için Set up another agent seçeneğini belirleyin.
Hedef agent'ı yeniden başlatın. Claude Code için mevcut oturumdan çıkın ve yeni bir terminalde claude komutunu çalıştırın.

CC Switch onay penceresi: İçe aktarmadan önce uç noktayı ve modeli kontrol edin. Bu ekran görüntüsündeki anahtar maskelenmiştir.

Her tek tıklamalı kurulum yeni bir anahtar oluşturur; mevcut bir anahtarı yeniden kullanamaz. Mevcut anahtarlar bundan etkilenmez. Önceki agent yapılandırmanız CC Switch'te kullanılabilir durumda kalır.

Etkin bağlantıyı doğrulayın

Yeniden başlatılan agent'ta kısa bir mesaj gönderin ve yanıt verdiğini doğrulayın.
Claude Code'da /status komutunu çalıştırın ve modeli seçiminizle karşılaştırın. Diğer agent'larda eşdeğer durum görünümünü kullanın.
Web'deki API keys sayfasında yeni anahtarın Last used zamanının güncellenip güncellenmediğini kontrol edin.

Eski model hâlâ etkinse eski oturumu kapatın ve agent'ı yeniden başlatın. Tarayıcı CC Switch'i açmadıysa adres çubuğunun yakınındaki onay istemini kontrol edin, CC Switch'i açın ve yeniden Open seçeneğini belirleyin. Daha sonra model değişikliklerini kurulumu tekrarlamadan CC Switch'te yapabilirsiniz.

Önceki yapılandırmaya dönün veya erişimi iptal edin

CC Switch'te agent'ın önceki yapılandırmasını bulun ve geri dönmek için etkinleştirin. Bir CC Switch yapılandırmasını kaldırmak API anahtarını devre dışı bırakmaz. Anahtarın çalışmasını durdurmak istediğinizde web'deki API keys sayfasından anahtarı iptal edin.

Geçerli planınız ve model kullanılabilirliği için hesap sayfasını kontrol edin. Kaydın ve ekran görüntülerinin tamamı için tek tıklamayla agent kurulumu eğitimine, hesap kurulumu içinse Abonelikler ve faturalandırma sayfasına bakın.

API çağrıları uygulama kredilerini paylaşır mı?

Evet. Normal API çağrıları, plan kotalarını ve kullanım aralıklarını uygulamayla paylaşır. Başka bir anahtar oluşturmak veya agent değiştirmek bunları sıfırlamaz. Promosyon kredileri için ayrı API uygunluk koşulları geçerli olabilir. Krediler ve kullanım sayfasına bakın.

Anahtarları ve kullanımı yönetmek için Cloud konsolunu açın. Özel bir model uç noktası ve anahtarı kabul eden Zcode gibi araçlar, eşleşen API protokolü için yapılandırılabilir. Bu, OpenDesign uygulamasının söz konusu aracı yerleşik bir yerel agent olarak başlatabileceği anlamına gelmez.

Görsel içeren istekler boyut sınırını aşıyor

Güncel destek yönergeleri, API istek gövdesi için 50 MiB sınırı belirtir. Bu sınır her bir görsele değil, gövdenin tamamına uygulanır; görsel kodlaması da boyutu artırır. Görsellerin sayısını veya boyutlarını azaltıp küçük bir isteği yeniden deneyin. Sorun devam ederse anahtarınızı açığa çıkarmadan yanıt durumunu, istek zamanını ve modeli destek ekibine iletin.