API anahtarlarını yönetme

Bu kılavuz, Control Center’ın kullandığı her kimlik bilgisinin nerede saklandığını ve nasıl değiştirileceğini gösterir.

Yazı yazdığınız makinede hiçbir şey saklanmaz. Her kimlik bilgisi sunucuda yaşar; belirli bir isteğe hangisinin yanıt verdiği, arkasında bir insan olup olmadığına bağlıdır.

Kimlik bilgisi	Saklandığı yer	Kim kullanır
Forge / biletleme kimlik bilginiz	Sunucunun 0600 izinli sırlar dosyası, kullanıcı kimliğinize göre	İstediğiniz her şey: PR yüzeyi, ajan çalıştırmalarınız, imajlarınız
Sunucunun uygulama kimliği	Aynı dosya, sır olmayanlar içinse `server_settings`	Hiçbir insanın istemediği işler: webhook’lar, PR yoklaması, bilet eşitleme
Model sağlayıcı anahtarları ve OAuth token’ları	Sunucunun kendi kimlik bilgisi deposu	Kurulumdaki her çalışma alanı için yerleşik adaptör
Slack bot token’ları	Sunucuda `<dataDir>/<workspaceId>/chat_credentials/`	O çalışma alanının sohbet köprüsü
Harici CLI kimlik bilgileri	O CLI’ın kullandığı her ne ise	Sunucu ana makinesindeki Claude Code

İki GitHub kimlik bilgisi ve farklı sorulara yanıt verirler

Sizinki, oturum açmadan (cihaz akışı) ya da bir token yapıştırmadan gelir. Sizin adınıza yapılan her isteğin kullandığı şey budur, dolayısıyla sizin için gönderilen bir yorum sizin adınızı taşır. Başka bir üye bunu okuyamaz; kendi kimlik bilgisini kendisi bağlar
Sunucununki, operatörün kaydettiği GitHub App’ten gelir. Çağıranı olmayan her şeye yanıt verir — böylece biri ayrıldığında ya da bir token’ı döndürdüğünde forge erişimi ortadan kalkmaz

Sizinki Ayarlar → Çalışma alanı → Profil ve kimlik altındaki Kod barındırma kartında ayarlanır; sunucununki Ayarlar → Sunucu → Tek oturum açma altındaki Sağlayıcı uygulamaları’nda. Bkz. GitHub entegrasyonunu kurma ve GitHub App oluşturma.

Model sağlayıcı anahtarlarını ayarlama

Yerleşik adaptör sağlayıcılarda kimlik doğrulamasını kendisi yapar ve bu kimlik bilgileri sunucuda yaşar.

Ayarlar → Sunucu → Model sağlayıcıları’na gidin
Sağlayıcılar ve modeller’e kaydırın
Sağlayıcıyı bağlayın — OpenAI, Codex, Cursor ve Kimi Code için tarayıcı OAuth’u; Anthropic ve geri kalanı için bir API anahtarı

Tam liste ve özel bir uç nokta ekleme için Adaptörleri ve modelleri yönetme sayfasına bakın.

Bu kimlik bilgileri ana makine genelinde geçerlidir: tek bir anahtar kurulumdaki her çalışma alanına hizmet eder. OAuth token’ları süreleri dolmadan yenilenir.

Harici adaptör CLI’ları kendi kimlik bilgilerini, kendi yapılandırmalarında, sunucu ana makinesinde tutar — Control Center bunları yönetmez. Claude Code’un kimlik doğrulamasını, cc_server’ın çalıştığı makinede, kendi belgelerinin söylediği şekilde yapın.

Adaptör başına Ortam değişkenleri iletişim kutusu, bunlardan biri için bir anahtar koyulacak yer gibi görünür ama değildir: sizin cihazınıza yazar, oysa sunucu kendi kopyasını okur ve ikisi arasında hiçbir köprü yoktur. Bkz. Adaptörleri ve modelleri yönetme.

Bir bilet sağlayıcısı bağlama

Ayarlar → Çalışma alanı → Genel üzerindeki Biletler kartı tek bir kararın iki yarısını barındırır: biletlerinizin hangi sağlayıcıda yaşadığı ve ona ait kimlik bilgisi. Yerel’i seçmek kimlik bilgisi satırını gizler — yerel biletler bu sunucunun kendi veritabanında yaşar ve kimlik doğrulaması yapılacak bir şeyleri yoktur.

Anahtarınız, forge’daki gibi, sunucuda kullanıcı kimliğinize bağlı olarak saklanır. Sunucu kendi Linear anahtarını ayrıca tutar (Sağlayıcı uygulamaları); hiçbir insan istemediğinde bilet eşitlemesi bunun üzerinden çalışır. Bir ajanın sandbox’ına hiçbir biletleme anahtarı enjekte edilmez; ajanlar biletleri, Harici takip sistemine yaz kuralına soran Control Center araçlarıyla yazar. Bkz. Linear entegrasyonunu kurma.

Döndürme veya iptal etme

GitHub kimlik bilginiz: Bağlantıyı kes’e basın, ardından yeniden oturum açın ya da yeni token’ı yapıştırın. Eskisini GitHub’da iptal edin
Sunucunun uygulaması: uygulamanın GitHub sayfasında yeni bir özel anahtar ya da istemci sırrı oluşturun, Sağlayıcı uygulamaları’na yapıştırın ve Test’e basın
Bir model sağlayıcısı: satırında oturumu kapatın (OAuth) ya da anahtarı kaldırın, sonra yeniden bağlayın
Slack: token’ları bağlantı iletişim kutusuna yeniden yapıştırın. Bkz. Slack entegrasyonunu kurma

Sorun giderme

PR listesi boş ama token’ım `curl` ile çalışıyor

Kod barındırma satırının alt başlığına bakın. Başka bir kaynak adı veriyorsa (“bu sunucunun uygulaması üzerinden”, “ortamdan”), test ettiğiniz kimlik bilgisi yanıt veren değildir — sizinki kaydedilmemiştir.

Token kabul ediliyor ama sonraki istekler başarısız oluyor

Token, saklandığı hâliyle yoklanır, dolayısıyla satır arkasındaki hesabın adını verir — ama yalnızca hesabı, kapsamları değil. Kapsamları çok az olan bir token bağlanır, sonra tek tek isteklerde başarısız olur. Kapsamları ve son kullanma tarihini kontrol edin:

curl -H "Authorization: token YOUR_TOKEN" https://api.github.com/user