Windows için ChatGPT masaüstü uygulaması

Windows'ta yerel korumalı alan ve PowerShell desteğiyle ChatGPT masaüstü uygulamasını kullanın

Windows için ChatGPT masaüstü uygulaması, projeler arasında çalışmak, paralel sohbetler yürütmek ve sonuçları incelemek için tek bir arayüz sunar. Windows uygulaması; çalışma ağaçları, zamanlanmış görevler, Git işlevleri, yerleşik tarayıcı, dosya önizlemeleri, eklentiler ve beceriler gibi temel iş akışlarını destekler. PowerShell ve Windows korumalı alanını kullanarak Windows'ta yerel olarak çalışır veya Windows Subsystem for Linux 2 (WSL2) içinde çalışacak şekilde yapılandırabilirsiniz.

ChatGPT masaüstü uygulamasını indirme

Windows için ChatGPT masaüstü uygulamasını indirin.

Ardından başlamak için hızlı başlangıç adımlarını izleyin.

Kurumsal yükleme ve güncelleme seçenekleri için Windows uygulamasını dağıtma bölümüne bakın.

Komut satırından yüklemeyi tercih ediyorsanız şunu çalıştırın:

winget install --id 9PLM9XGG6VKS -s msstore

Yerel korumalı alan

Windows'taki ChatGPT masaüstü uygulaması, ajan PowerShell'de çalışırken yerel bir Windows korumalı alanını destekler; ajanı Windows Subsystem for Linux 2 (WSL2) içinde çalıştırdığınızda ise Linux korumalı alanını kullanır. Her iki modda da korumalı alan önlemlerini uygulamak için Codex'e mesaj göndermeden önce oluşturucunun altındaki Onay iste seçeneğini belirleyin.

Geliştirme kurulumunuza göre özelleştirme

Tercih edilen düzenleyici

Aç için Visual Studio, VS Code veya başka bir düzenleyici gibi varsayılan bir uygulama seçin. Bu seçimi proje bazında geçersiz kılabilirsiniz. Bir proje için Aç menüsünden zaten farklı bir uygulama seçtiyseniz projeye özgü bu seçim öncelikli olur.

Tümleşik terminal

Varsayılan tümleşik terminali de seçebilirsiniz. Yüklediğiniz araçlara bağlı olarak seçenekler şunlardır:

• PowerShell
• Komut İstemi
• Git Bash
• WSL

Bu değişiklik yalnızca yeni terminal oturumlarına uygulanır. Zaten açık bir tümleşik terminaliniz varsa yeni varsayılan terminalin görünmesi için uygulamayı yeniden başlatın veya yeni bir sohbet başlatın.

Windows Subsystem for Linux (WSL)

ChatGPT masaüstü uygulaması varsayılan olarak Windows'a yerel Codex ajanını kullanır. Bu, ajanın komutları PowerShell'de çalıştırdığı anlamına gelir. Uygulama gerektiğinde wsl CLI'ı kullanarak Windows Subsystem for Linux 2 (WSL2) içinde bulunan projelerle çalışmaya devam edebilir.

WSL dosya sisteminden bir proje eklemek istiyorsanız Yeni proje ekle'ye tıklayın veya Ctrl+O tuşlarına basın, ardından Dosya Gezgini penceresine \\wsl$\ yazın. Buradan Linux dağıtımınızı ve açmak istediğiniz klasörü seçin.

Windows'a yerel ajanı kullanmaya devam etmeyi planlıyorsanız projeleri Windows dosya sisteminizde depolamayı ve bunlara WSL'den /mnt/<drive>/... üzerinden erişmeyi tercih edin. Bu kurulum, projeleri doğrudan WSL dosya sisteminden açmaktan daha güvenilirdir.

Ajanın kendisinin WSL2 içinde çalışmasını istiyorsanız Ayarlar'ı açın, ajanı Windows yerel seçeneğinden WSL'ye geçirin ve uygulamayı yeniden başlatın. Değişiklik, yeniden başlatana kadar geçerli olmaz. Yeniden başlatmanın ardından projeleriniz yerinde kalmalıdır.

WSL1, Codex 0.114 sürümüne kadar destekleniyordu. Codex 0.115 sürümünden itibaren Linux korumalı alanı bubblewrap sistemine geçtiğinden WSL1 artık desteklenmemektedir.

Tümleşik terminali ajandan bağımsız olarak yapılandırırsınız. Terminal seçenekleri için Geliştirme kurulumunuza göre özelleştirme bölümüne bakın. İş akışınıza bağlı olarak ajanı WSL'de tutup terminalde PowerShell kullanabilir veya her ikisi için de WSL kullanabilirsiniz.

Yararlı geliştirici araçları

Codex, bazı yaygın geliştirici araçları önceden yüklü olduğunda en iyi şekilde çalışır:

• Git: ChatGPT masaüstü uygulamasındaki inceleme paneline güç verir ve değişiklikleri incelemenize veya geri almanıza olanak tanır.
• Node.js: Ajanın görevleri daha verimli gerçekleştirmek için kullandığı yaygın bir araçtır.
• Python: Ajanın görevleri daha verimli gerçekleştirmek için kullandığı yaygın bir araçtır.
• .NET SDK: Yerel Windows uygulamaları geliştirmek istediğinizde yararlıdır.
• GitHub CLI: ChatGPT masaüstü uygulamasındaki GitHub'a özgü işlevlere güç verir.

Bunları, aşağıdakini tümleşik terminale yapıştırarak veya Codex'ten yüklemesini isteyerek varsayılan Windows paket yöneticisi winget ile yükleyin:

winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id Python.Python.3.14
winget install --id Microsoft.DotNet.SDK.10
winget install --id GitHub.cli

GitHub CLI'ı yükledikten sonra uygulamadaki GitHub özelliklerini etkinleştirmek için gh auth login komutunu çalıştırın.

Farklı bir Python veya .NET sürümüne ihtiyacınız varsa paket kimliklerini istediğiniz sürüme göre değiştirin.

Sorun giderme ve SSS

Komutları yükseltilmiş izinlerle çalıştırma

Codex'in komutları yükseltilmiş izinlerle çalıştırması gerekiyorsa ChatGPT masaüstü uygulamasının kendisini yönetici olarak başlatın. Yüklemeden sonra Başlat menüsünü açın, uygulamayı bulun ve Yönetici olarak çalıştır'ı seçin. Codex ajanı bu izin düzeyini devralır.

PowerShell yürütme ilkesi komutları engelliyor

PowerShell'de daha önce Node.js veya npm gibi araçları hiç kullanmadıysanız Codex ajanı veya tümleşik terminal yürütme ilkesi hatalarıyla karşılaşabilir.

Bu durum, Codex sizin için PowerShell betikleri oluşturduğunda da ortaya çıkabilir. Böyle bir durumda PowerShell'in bunları çalıştırabilmesi için daha az kısıtlayıcı bir yürütme ilkesine ihtiyacınız olabilir.

Hata şuna benzer görünebilir:

npm.ps1 cannot be loaded because running scripts is disabled on this system.

Yaygın bir çözüm, yürütme ilkesini RemoteSigned olarak ayarlamaktır:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

İlkeyi değiştirmeden önce ayrıntılar ve diğer seçenekler için Microsoft'un yürütme ilkesi kılavuzuna bakın.

Windows'ta yerel ortam betikleri

Yerel ortamınız, npm betikleri gibi platformlar arası komutlar kullanıyorsa tüm platformlar için ortak bir kurulum betiği veya eylem kümesi kullanabilirsiniz.

Windows'a özgü davranışa ihtiyacınız varsa Windows'a özgü kurulum betikleri veya Windows'a özgü eylemler oluşturun.

Eylemler, tümleşik terminalinizin kullandığı ortamda çalışır. Geliştirme kurulumunuza göre özelleştirme bölümüne bakın.

Yerel kurulum betikleri ajan ortamında çalışır: ajan WSL kullanıyorsa WSL'de, aksi takdirde PowerShell'de.

Yapılandırmayı, kimlik doğrulamayı ve oturumları WSL ile paylaşma

Windows uygulaması, Windows'taki yerel Codex ile aynı Codex ana dizinini kullanır: %USERPROFILE%\.codex.

Codex CLI'ı WSL içinde de çalıştırırsanız CLI varsayılan olarak Linux ana dizinini kullanır; dolayısıyla yapılandırmayı, önbelleğe alınmış kimlik doğrulamayı veya oturum geçmişini Windows uygulamasıyla otomatik olarak paylaşmaz.

Bunları paylaşmak için aşağıdaki yaklaşımlardan birini kullanın:

• WSL ~/.codex dizinini dosya sisteminizdeki %USERPROFILE%\.codex ile eşitleyin.
• CODEX_HOME ayarını belirleyerek WSL'yi Windows Codex ana dizinine yönlendirin:

export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

Bu ayarı her kabukta kullanmak istiyorsanız ~/.bashrc veya ~/.zshrc gibi WSL kabuk profilinize ekleyin.

Git özellikleri kullanılamıyor

Git'i Windows'a yerel olarak yüklemediyseniz uygulama bazı özellikleri kullanamaz. PowerShell'den winget install Git.Git veya cmd.exe ile yükleyin.

\\wsl$ üzerinden açılan projelerde Git algılanmıyor

Şimdilik WSL'den de erişilebilen bir projede Windows'a yerel ajanı kullanmak istiyorsanız en güvenilir geçici çözüm, projeyi yerel Windows sürücüsünde depolamak ve WSL'den /mnt/<drive>/... üzerinden erişmektir.

Cmder açma iletişim kutusunda listelenmiyor

Cmder yüklü olduğu hâlde Codex'in açma iletişim kutusunda görünmüyorsa Windows Başlat Menüsü'ne ekleyin: Cmder üzerine sağ tıklayın ve Başlat'a ekle'yi seçin, ardından Codex'i veya bilgisayarı yeniden başlatın.