API anahtarlarıyla Kodlama

Bir Koderen API anahtarıyla, OpenAI-benzeri bir API ile çalışan programlama araçlarını kullanabilirsiniz. Araç, talepleri AI-School'a gönderir. AI-School anahtarı, bütçeyi, geçerlilik süresini ve izin verilen modelleri kontrol eder.

Daha sonra AI-School, isteği ortamın teknik bağlantısı üzerinden işler.

Neye ihtiyacınız var?

Üç veriye ihtiyacınız var:

Verilen	Nerede bulabilirsiniz?
API anahtarı	Bir yönetici veya öğretmenden alırsınız
Uç Nokta (Endpoint)	https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
Model adı	Örneğin gpt-5.6-luna, gpt-5.6-terra veya gpt-5.6-sol

API anahtarı ais. ile başlar. Bu anahtarını bir şifre gibi ele alın.

Hangi modeli seçiyorsunuz?

Çoğu öğrenci için GPT-5.6 Luna iyi bir başlangıçtır. Bu hızlı model, ders sırasında programlama yardımı ve günlük kod soruları için uygundur.

Öğretmenler veya ileri öğrenciler için GPT-5.6 Terra büyük projeler ve daha karmaşık kodlar için uygundur. En talepkâr görevler için GPT-5.6 Sol'u seçin; çok analiz, planlama veya akıl yürütme gerektirir.

Hangi aracı seçiyorsunuz?

AI-School iki araç önerir:

Araç	İçin Önerilen	Neden
Aider	Öğrenciler ve sınıf içi kodlama	Açık ve net çalışır, ajan görünümü daha az
OpenCode	Öğretmenler ve ileri kullanıcılar	Ajanik CLI aracı ve masaüstü uygulaması de içerir

Öğrenciler için Aider

Aider, terminalde bir eş-romb programlama aracıdır. Kullanıcı yardım ister, değişiklikleri görür ve koda yakın kalır. Bu, programlama öğrenimine iyi uyar: öğrenci desteklenir, ancak olan bitene kendisi katılır.

Resmi Aider belgelerine bakınız: officiële Aider-documentatie.

İleri kullanım için OpenCode

OpenCode daha ajaniktir. Araç bağımsız adımlar atabilir, dosyaları değiştirebilir ve görevleri daha da geliştirebilir. Bu güçlüdür, ancak koda, git’e ve yerel geliştirme ortamlarına daha fazla anlayış gerektirir.

Resmi OpenCode belgelerine bakınız: officiële OpenCode-documentation.

Anahtarları güvenli kullanma

API anahtarınızı herkese açık paylaşmayın ve paylaşacağınız koda eklemeyin.

Tercih edilmesi gerekenler:

• çevresel değişkenler (environment variables)
• git'e gönderilmeyecek yerel bir .env
• aracın yerleşik yapılandırması

OpenCode için proje dizininde örneğin bir .env dosyası kullanabilirsiniz:

AI_SCHOOL_CODEREN_API_KEY=ais.jouw-api-sleutel

Aracın bu .env dosyasını gerçekten yüklediğinden emin olun. PowerShell'da bu değişkeni mevcut terminal için geçici olarak da ayarlayabilirsiniz:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.jouw-api-sleutel"

Uyarı

API anahtarlarını hiçbir zaman herkese açık bir depo, Teams sohbeti, paylaşılan belge veya ekran görüntüsüne koymayın.

Anahtar çalışmazsa

Şunu kontrol edin:

• Koderen ortam için etkinleştirildi mi
• anahtarınız hala aktif mi
• bütçe tükendi mi
• anahtar geçerlilik süresi içinde mi
• kullanılan modelin izin verilenler arasında mı
• uç noktanın doğru yapılandırılmış mı
• aracın API anahtarını Authorization: Bearer ... olarak gönderdi mi
• aracın AI-School Koderen'i desteklemeyen sağlayıcıya özel parametreler gönderip göndermediği

Şüphe halinde bir yöneticiye veya öğretmene anahtarı kontrol ettirmeye başvurun.