1dabb5110f
docs(help): bring the user guide back in line with the current app The help was written on 2026-10-14 and about forty user-visible changes merged since without touching it, so several pages described controls that no longer exist: Missions still listed four playbooks and a Save step for preferences that now save on each change, the depth editor kept its old names, notifications still had their former switches, and voice input pointed to a microphone button that is not in the composer. Every English page was re-checked claim by claim against the current labels (English UI messages) and behaviour, then the nine translations were updated to match, using each locale's own UI labels. Notable corrections: Missions (Compare two models, autosaving defaults with Apply to / Global / Reset, Subsession nesting depth, prepared hand-offs, retired-task interrupts, the named causes of "Mission Control is unavailable", standalone server support); conversations and history (reasoning/tool durations, token lines adding up the cleanup selection, presets including Nothing, timeline markers following Message content, in-place reveal of long text, Open in session, focus after send, Queue message / Steer now, Retrying); settings (notification routing table and defaults, Stats, Mode, info tips, Server setting badge, localized native menus); shortcuts (72 actions, Clear shortcut, Ctrl/Cmd+K); voice (More actions entries, Save status); files (live Workspace refresh, Show 200 more); OpenCode, install, server and updates (2.1.1 recommended, OpenCode 2 beside an older installation, version card first, private loopback listener for Missions, preview releases offered once all builds are published); providers, integrations, browser, SideCars, desktop and remote pages. Translations also repaired older drift, mainly the project-tab closing passages. The Chat settings table header (Default state, its title, item column, the thinking row and its accessible label) was still English in eight locales; it is now translated so the help can cite what users see. AGENTS.md now asks every PR changing user-visible behavior to update the affected help pages in the same PR, since CI validates structure and links but not whether the text still matches the UI; it also corrects the needs-input notification default. USER_HELP.md no longer claims native menus stay English. Validation: npm run test:help (all ten locales, 25 pages, heading ids unchanged), a full help build, and the i18n and transcript-visibility unit tests.
11 KiB
Sağlayıcılar ve hesaplar
Sağlayıcı kimlik doğrulaması, tarayıcı cihazına veya bir CodeNomad projesine değil, bağlı OpenCode hizmetine aittir. Model görüntüleme tercihleri, abonelik kotaları ve web arama seçeneklerinin farklı kapsamları vardır.
Bir modeli veya arama sağlayıcısını bağlayın
- Çalışma alanı açıp Ayarlar → Provider'lar yoluna gidin. Modeller açık olarak başlar; arama sağlayıcıları için Web araması bölümünü genişletin.
- O grupta Provider seç öğesini, ardından Bağlan öğesini seçin.
- Model sağlayıcısı için sunulan yerel Kimlik doğrulama yöntemi öğesini tamamlayın: API anahtarı, OAuth veya komut. OAuth için Yetkilendirme sayfasını aç öğesini kullanın ve yalnızca istendiğinde bir yetkilendirme kodu gönderin. Arama sağlayıcıları API anahtarıyla bağlanır.
- Tamamlandıktan sonra yapılandırılmış sağlayıcı satırını kontrol edin. Modeller bağlantılardan, hesap değişikliklerinden ve yeniden bağlanmalardan sonra yeniden okunur; Web araması bölümünde ayrıca Yenile vardır.
Yalnızca arama entegrasyonları Modeller altında değil, Web araması altında görünür. Kimlik doğrulamanın kaydedilmesi bir model seçmez veya varsayılan arama sağlayıcısını değiştirmez. API anahtarları ve OAuth kimlik bilgileri, etkin OpenCode sunucusu tarafından kaydedilir. Tarayıcı, kayıtlı kimlik bilgisi sırlarını değil, bağlantı meta verilerini alır. Ortam değişkenlerinden kaynaklanan bir bağlantı bu kullanıcı arayüzünde salt okunurdur: bağlantıyı burada kesmeye çalışmak yerine sahibi olduğu ortamı değiştirin.
Yetkilendirme penceresi engellenmişse akıştan Yetkilendirme sayfasını aç, Bu sekmede aç veya Bağlantıyı kopyala öğesini kullanın. Yetkilendirme bağlantısını veya kodunu teşhiste yayınlamayın.
Hesapları seçin ve yönetin
- Sağlayıcının satırında, kayıtlı bir kimlik bilgisini seçmek için Etkin hesap öğesini kullanın.
- Başka bir bağlantının kimliğini doğrulamak için Hesap ekle öğesini kullanın.
- Farklı bir kayıtlı hesabı yönetmek için önce hesabı seçin, ardından Hesabı yeniden adlandır veya Hesabı kaldır öğesini kullanın. Yeniden adlandırma Hesap adı ve Kaydet öğesini kullanır; Hesabı kaldır onay istemeden hemen uygulanır.
Seçme, yeniden adlandırma ve kaldırma, diğer projeler ve istemciler de dahil olmak üzere OpenCode hizmeti genelindeki entegrasyonu etkiler. Bir kimlik bilgisinin kaldırılması, bu istemcilerin kimlik doğrulaması olmadan kalmasına neden olabilir; konuşma geçmişini silmez veya sağlayıcının uzak hesabını iptal etmez. Ortam bağlantıları, yazılabilir kayıtlı kimlik bilgileri olarak seçilemez veya buradan kaldırılamaz. Bir işlem başarısız olursa CodeNomad hesapları yeniden okur: tekrar harekete geçmeden önce Etkin hesap öğesini yeniden kontrol edin.
Otomatik seçim sınırları
Desteklenen entegrasyonda birden fazla kayıtlı kimlik bilgisi varsa Hesabı otomatik seç, CodeNomad üzerinden sonraki istem/özel komut kabulünden önce kota tabanlı seçimi etkinleştirir. Ayar CodeNomad yapılandırmasında entegrasyon başınadır; sonuçtaki hesap seçimi hizmet genelindedir.
| Uygun entegrasyon | Uygun hesap türü |
|---|---|
| OpenAI / Codex | Codex tarayıcı/cihaz OAuth abonelik hesapları; OpenAI kullandıkça öde anahtarları veya kullanım verisini OpenAI'ın sağlamadığı ChatGPT oturum açma yöntemi değil. |
| OpenCode Go | Go anahtarı veya yalnızca Go sağlayıcısı için kullanılan OpenCode Console girişi/anahtarı; Zen kullandıkça öde kredileri için değil. |
| Anthropic | OpenCode'un Claude Pro/Max OAuth girişi; Claude Code girişi değil. |
| GitHub Copilot | Okunabilir premium istek kotasına sahip OAuth; kurumsal uç nokta kimlik bilgileri okunabilir aday değildir. |
| Kodlama planları | Anahtar tabanlı zai-coding-plan, zhipuai-coding-plan, kimi-for-coding, minimax-coding-plan, minimax-cn-coding-plan. |
Geçişi yalnızca mevcut hesabın kotasının tamamen dolması tetikler; alternatif hesabın daha fazla kapasitesi olması yetmez. Okumalar adayları etkinleştirmeden veya yenileme belirteçlerini takas etmeden her kayıtlı kimlik bilgisini inceler. Codex, Copilot ve kodlama planlarında kullanılabilir olduğu gösterilebilen aday gerekir. Go, Console ve Claude, yakın tarihli yerel kota hatasıyla tükenmiş işaretlenmeyen, kotası bilinmeyen adayı kullanabilir. OpenCode Go kullanım uç noktası ve Console OAuth kullanımı kaynak tarafta doğrulanmamıştır; kullanılabilirlik garantisi yoktur.
Bu, devam eden istek için otomatik geçiş değildir. Başarısız istekleri yeniden denemez; istemleri, komutları veya değişiklik işlemlerini yeniden yürütmez. Ortam bağlantılarını, isteğe bağlı sağlayıcıları, kullandıkça öde bakiyelerini veya harici Claude Code girişlerini döndürmez. Hazırlık sırasında elle yapılan hesap değişikliklerine uyulur; istemciler arası hesap kilidi yoktur. Kota/kimlik doğrulama hatalarında Etkin hesap bilgisini inceleyin, Kullanımı yenileyin ve bilinçli yeniden göndermeden önce gerekirse kimlik bilgisi sahibinde oturum açın.
Model görünürlüğü, favoriler ve Düşünme
- Model sağlayıcının yanında Modelleri yönet öğesini seçin.
- Ada/kimliğe göre arama yapın ve görünürlüğü değiştirin; Tümünü göster ve Tümünü gizle, söz konusu sağlayıcının seçici listesini etkiler.
- Bir konuşmanın Model seçicisinde Favorilere ekle veya Favorilerden kaldır öğesini kullanın; Tüm modelleri göster yalnızca favorilere yönelik filtrelemeyi bırakır.
- Seçilen modelin sunduğu varyantlar için ileti düzenleyicisinde Düşünme öğesini kullanın.
Görünürlük ve sık kullanılanlar, CodeNomad'in seçicilerini düzenler; modelleri kaldırmaz, kimlik bilgilerini kaldırmaz veya diğer OpenCode istemcilerinin bunları kullanmasını engellemez. Bir modeli gizlemek hesap bağlantısını kesmek değildir. Düşünme, zaten konuşma dökümünde bulunan akıl yürütmenin görünürlüğünü değil, sonraki gönderimler için bir model çeşidi seçer. Gizli modelleri Modelleri yönet → Tümünü göster ile geri yükleyin.
Kullanım, belirteç sayıları ve süresi dolmuş oturum açma bilgileri
Etkin görüşmenin sağlayıcı planı pencereleri, sıfırlama süreleri ve desteklenen bakiyeler için sağ paneldeki Kullanım öğesini kullanın. Bu sağlayıcı okumaları, mesaj başına Tokenlar ve maliyet tahminlerinden farklıdır: abonelik kotası, görünür konuşma dökümünden hesaplanan bir fatura değildir. Eksik, eski veya bilinmeyen bir okuma, sıfır kullanım veya kalan kapasitenin kanıtı değildir. Ayarlar → Gelişmiş içindeki Sağlayıcı kredi bakiyesi ek bakiye ekranını kontrol eder.
OpenAI, ChatGPT oturum açma yöntemlerinden biri için kullanım verisi sağlamaz: Kullanım, kota pencereleri göstermek yerine bunu belirtir. Sohbet etmek yine çalışır ve aynı girişle yeniden bağlanmak bu okumayı geri getirmez.
Kullanım, seçili OpenCode kimlik bilgisini izler. Claude, anthropic/claude üzerinden OpenCode Anthropic OAuth girişini kullanır. claude-code sağlayıcısı, WSL dağıtımı dahil daemon ana bilgisayarındaki Claude Code girişini kullanır: önce CLAUDE_CODE_OAUTH_TOKEN, sonra kayıtlı giriş; dosya deposunu CLAUDE_SECURESTORAGE_CONFIG_DIR / CLAUDE_CONFIG_DIR veya ~/.claude belirler; native macOS Keychain kullanılabilir. CodeNomad bir Claude girişini diğerinin yerine kullanmaz.
Süresi dolmuş bir sağlayıcı girişi için, sahibi (OpenCode, Claude Code veya Codex CLI) aracılığıyla yenileyin/oturum açın, ardından CodeNomad'i yenileyin. CodeNomad, harici olarak sahip olunan yenileme belirteçlerini takas etmez. CodeNomad sunucu oturum açma süresinin sona ermesi ayrıdır: başarısız bir sağlayıcı isteğinin yeniden gönderileceğini varsaymadan CodeNomad'e yeniden bağlanın/oturum açın. Bkz. Sorun Giderme.
İsteğe bağlı kullanım ortamı değişkenleri
Bunları başlatmadan önce CodeNomad arka uç sürecinin ortamında ayarlayın. Bunlar tarayıcı ayarı veya model seçimi değil, kullanım okuyucusu kimlik bilgileridir. Oturum Ortam Değişkenleri düzenleyicisini değiştirmek çalışan arka ucun bu okuyucular için kullandığı process.env değerini güncellemez. Değiştirirken arka ucu amaçlanan ortamda yeniden başlatın; yalnızca kullanım okuyucusu değişkeni için ortak OpenCode hizmetini yeniden başlatmayın.
| Kullanım entegrasyonu | Ortam değişkeni |
|---|---|
| Cursor | CURSOR_ACCESS_TOKEN, yoksa CURSOR_TOKEN |
| Ollama Cloud | OLLAMA_CLOUD_COOKIE |
| OpenCode Go ek kullanımı | OPENCODE_GO_WORKSPACE_ID ve OPENCODE_GO_AUTH_COOKIE birlikte |
| ZenMux | ZENMUX_PLATFORM_API_KEY — çıkarım anahtarından farklı platform anahtarı |
| exe.dev | EXE_DEV_USAGE_TOKEN |
| Command Code | Native kimlik bilgisi yoksa COMMAND_CODE_API_KEY kullanılır |
Belirteçleri/çerezleri kabuk geçmişinden, ekran görüntülerinden ve raporlardan uzak tutun. İsteğe bağlı okuyucular, sağlayıcı API'lerine ve kimlik bilgilerinin geçerliliğine bağlıdır; Bir değişkenin yapılandırılması, kullanılabilir kota verilerinin garantisi değildir.
Web araması varsayılanı ve Proje geçersiz kılma
- Ayarlar → Provider'lar bölümünde Web araması grubunu genişletin ve gerekiyorsa arama entegrasyonunu API anahtarıyla bağlayın.
- Genel yapılandırma için Varsayılan arama öğesini seçin.
- Etkin Location için geçersiz kılmak üzere Geçerli proje için öğesini kullanın. Etkili sonucu içeren Bu projede arama bilgisini görmek için bu seçicinin üzerine gelin veya odaklanın.
Değişiklikler otomatik olarak kaydedilir. Varsayılan / devralınan, devralınan yapılandırmayı veya kaydedilen yerel seçimi kullanır; Proje geçersiz kılma Global'e galip gelir. Devre dışı seçilen kapsamda aramayı kapatır; Otomatik sağlayıcı, yerel otomatik sağlayıcı seçimi talep ediyor. Web araması bağlantılarını ve seçimlerini yalnızca genişletildiğinde yükler. Bağlantıyı kes kayıtlı bir arama anahtarını kaldırır; bir ortam değişkeninden sağlanan bağlantı salt okunur olarak etiketlenir ve Bağlantıyı kes eylemi yoktur.
Arama kimlik bilgileri, sağlayıcı seçimi Proje kapsamında olsa bile hizmet geneli olarak kalır. Bir anahtarın kaydedilmesi, onu arama varsayılanı olarak seçmez. Okuma/kaydetme işlemi başarısız olursa, yeniden denemeden önce yenileyin; konfigürasyonu körü körüne değiştirmeyin. Yerel yapılandırma ayrıntıları için, bkz. OpenCode belgeleri ve OpenCode kurulumu.