Geliştirici Kaynakları

Claude Code GitHub Actions

Claude Code GitHub Actions'ı bir RunAPI sırrı, modeli, izinleri, tetikleyicileri ve minimal bir iş akışıyla yapılandırın.

Markdown'ı görüntüle

Genel Bakış

Resmi anthropics/claude-code-action, Claude Code’u bir GitHub Actions iş akışında çalıştırır. Bu kılavuz, RunAPI anahtarını GitHub Secret olarak depolar, hassas olmayan Base URL’yi Claude Code ayarlarında belirler, bir model seçer ve yetkili @claude yorumlarına yanıt verir.

Başlamadan önce

Claude GitHub Uygulamasını yüklemek, Actions gizli dizilerini oluşturmak ve bir iş akışı eklemek için depo yöneticisi erişimine ihtiyacınız vardır.
Kimlik Doğrulama Kılavuzu bölümünde standart bir RunAPI API anahtarı oluşturun.
Model Kataloğu‘ndan Anthropic Messages’ı destekleyen bir model tanımlayıcısı kopyalayın.
Claude Code GitHub Actions kurulumunu ve kuruluşunuzun iş akışı politikasını inceleyin.

Yükle

Hedef depoda Claude Code’dan /install-github-app komutunu çalıştırın ve GitHub Uygulamasını yüklemek için yönergeleri izleyin. Bir Anthropic kimlik bilgisi oluşturma teklifi çıktığında kaydetmeden önce durun: bu kılavuz, Anthropic kimlik bilgisi yerine bir RunAPI deposu veya kuruluş sırrı kullanır.

Claude GitHub Uygulamasını manuel olarak kurun, ardından aşağıdaki iş akışını .github/workflows/claude.yml dosyasına ekleyin.

RunAPI'yi yapılandırın

RUNAPI_API_KEY adlı bir depo veya organizasyon Actions sırrı oluşturun. Bunu yalnızca action’ın sır girdisi aracılığıyla iletin:

YAML

anthropic_api_key: ${{ secrets.RUNAPI_API_KEY }}

Anahtarı iş akışı dosyasına veya action’ın settings JSON’ına koymayın. Action, ayarları ayrı olarak işler; yalnızca hassas olmayan Base URL oraya aittir.

Aşağıdaki minimal etkileşimli iş akışı, yeni sorunları ve çekme isteği inceleme yorumlarını dinler:

YAML

name: Claude Code

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
      actions: read
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.RUNAPI_API_KEY }}
          settings: |
            {
              "env": {
                "ANTHROPIC_BASE_URL": "https://runapi.ai"
              }
            }
          claude_args: "--model YOUR_RUNAPI_MODEL_ID"

Sırlar

GitHub, çatal çekme isteklerinden veya Dependabot olaylarından tetiklenen iş akışlarına sıradan Actions sırlarını iletmez. Bir çalıştırmanın kimlik bilgisi yoksa RunAPI anahtarını değiştirmeden önce olay kaynağını doğrulayın. Depo ve kuruluş kapsamı için GitHub’ın Actions sırları kılavuzunu kullanın.

İzinler

contents: write, eylemin kod değişikliklerini kaydetmesine olanak tanır.
pull-requests: write ve issues: write, tetikleyici konuşmayı okumasına ve yanıt vermesine olanak tanır.
id-token: write, eylemin varsayılan GitHub App kimlik doğrulamasını destekler.
actions: read, iş akışı sonuçlarını incelemesine olanak tanır.

write-all yerine bu açık izinleri kullanın. İş akışınızın ihtiyaç duymadığı özellikleri kaldırın.

Tetikleyici olaylar

issue_comment, sorunlardaki ve çekme isteği konuşmalarındaki yorumları kapsar; pull_request_review_comment ise fark satırlarındaki yorumları kapsar. issue_comment‘in tetikleyici olabilmesi için iş akışı dosyasının varsayılan dalda mevcut olması gerekir. Eylem ayrıca çalıştırmayı kimin başlattığını denetler; yetkili referans olarak resmi güvenlik davranışını kullanın.

Bir model seçin

claude_args içindeki YOUR_RUNAPI_MODEL_ID değerini Model Kataloğu‘ndaki tam tanımlayıcıyla değiştirin. Model seçimini settings.env dışında tutmak, iş akışının seçtiği modeli eylem yapılandırmasında görünür kılar.

Doğrula

RUNAPI_API_KEY gizli dizisinin değerini yazdırmadan var olduğunu doğrulayın.
İş akışını varsayılan dala birleştirin ve Actions’ın etkin olduğunu doğrulayın.
Depoya yazma erişimi olan bir hesaptan, bir sorun yorumuna @claude describe this repository in one sentence ekleyin.
İş akışı çalışmasını açın, eylemin başarılı olduğunu doğrulayın ve Claude’un aynı sorunda yanıt verdiğini doğrulayın.

Sorun giderme

Hiçbir iş akışı başlamıyor: Dosyanın varsayılan dalda olduğunu, yorum etkinliğinin eşleştiğini ve Actions’ın etkin olduğunu onaylayın.
İş atlandı: Yorumun @claude içerdiğini ve aktörün gerekli depo erişimine sahip olduğunu onaylayın.
Kimlik doğrulama başarısız olur: İş akışının secrets.RUNAPI_API_KEY referansı verdiğini onaylayın, gerekirse Kimlik Doğrulama Kılavuzu üzerinden anahtarı döndürün.
Çatallı bir pull request anahtarı kullanamıyor: GitHub, çatal tarafından tetiklenen çalıştırmalardan sıradan gizli bilgileri kasıtlı olarak saklar. Gizli bilgiyi bir değişmez değerle değiştirmeyin.
Model kullanılamıyor: Tam tanımlayıcıyı Model Kataloğu sayfasından kopyalayın.
Claude’un commitleri başka bir iş akışı başlatmıyor: Resmi action’ın GitHub token sorun giderme belgesini inceleyin.

Sonraki adımlar

Protokol davranışı için LLM API Hızlı Başlangıç ve istek alanları için Anthropic Messages API Başvurusu kullanın. Daha fazla tetikleyici ve eylem girdisi için resmi örnekler ve yapılandırma başvurusu kaynaklarını inceleyin.