Tutorial Claude Code untuk Pemula

Pendahuluan

Claude Code memungkinkan Anda menulis, men-debug, dan mengeksekusi kode secara interaktif menggunakan model LLM Claude Pro. Dengan Claude Code, tim dapat mempercepat prototyping, otomatisasi skrip, dan integrasi AI ke pipeline CI/CD tanpa menulis boilerplate berulang.

Arsitektur singkat:

User → Claude Pro API (prompt) → Claude Code Engine → Output (code / hasil eksekusi)

Kami akan menyiapkan lingkungan lokal, menulis prompt dasar, dan menghubungkannya ke GitHub Actions untuk eksekusi otomatis.

Prasyarat & Persiapan

Langkah Demi Langkah

Step 1 – Membuat Akun Claude Pro

1. Buka tautan Claude Pro (ai-chat).
2. Ikuti proses pendaftaran, verifikasi email, dan pilih paket berlangganan.
3. Setelah masuk, buka API Keys → Create New Key → Salin key (contoh: sk-xxxxxxxxxxxx).

Step 2 – Instalasi CLI Claude

Claude menyediakan CLI resmi yang dapat di‑install via pip.

# Pastikan pip terbaru
python3 -m pip install --upgrade pip

# Instal Claude CLI
python3 -m pip install anthropic[cli]

# Verifikasi instalasi
claude --version

Catatan: Jika Anda menggunakan lingkungan virtual (venv), aktifkan terlebih dahulu.

Step 3 – Konfigurasi API Key

Buat file konfigurasi di home directory:

mkdir -p ~/.config/claude
cat > ~/.config/claude/config.toml <<EOF
[default]
api_key = "sk-xxxxxxxxxxxx"
model = "claude-2.1"
EOF

Uji koneksi:

claude ping
# Expected output: {"status":"ok","model":"claude-2.1"}

Step 4 – Menulis Prompt Claude Code

Buat file prompt.txt dengan struktur berikut:

You are a senior Python developer. Write a function that:
- Accepts a list of integers.
- Returns a dictionary with keys "even" and "odd" containing lists of even and odd numbers respectively.
- Include type hints and docstring.
Provide only the final Python code block.

Jalankan Claude Code:

claude code --prompt-file prompt.txt --output generated.py

Hasil generated.py akan berisi:

from typing import List, Dict

def split_even_odd(numbers: List[int]) -> Dict[str, List[int]]:
    """
    Split a list of integers into even and odd numbers.

    Args:
        numbers: List of integers.

    Returns:
        A dictionary with keys "even" and "odd".
    """
    even = [n for n in numbers if n % 2 == 0]
    odd = [n for n in numbers if n % 2 != 0]
    return {"even": even, "odd": odd}

Step 5 – Menjalankan Kode dan Validasi

python3 generated.py  # Jika file berisi script utama
# Atau gunakan REPL untuk menguji fungsi:
python3 - <<'PY'
from generated import split_even_odd
print(split_even_odd([1,2,3,4,5,6]))
PY
# Expected output: {'even': [2, 4, 6], 'odd': [1, 3, 5]}

Step 6 – Integrasi dengan GitHub Actions (CI/CD)

Buat repository GitHub, lalu tambahkan file .github/workflows/claude-code.yml:

name: Claude Code CI

on:
  push:
    paths:
      - '**.py'
      - 'prompt.txt'

jobs:
  generate-code:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - name: Set up Python
        uses: actions/setup-python@v4
        with:
          python-version: '3.10'

      - name: Install Claude CLI
        run: |
          python -m pip install --upgrade pip
          python -m pip install anthropic[cli]

      - name: Configure Claude API Key
        env:
          CLAUDE_API_KEY: ${{ secrets.CLAUDE_API_KEY }}
        run: |
          mkdir -p ~/.config/claude
          cat > ~/.config/claude/config.toml <<EOF
          [default]
          api_key = "${CLAUDE_API_KEY}"
          model = "claude-2.1"
          EOF

      - name: Generate code from prompt
        run: |
          claude code --prompt-file prompt.txt --output generated.py

      - name: Run unit tests
        run: |
          python -m pip install pytest
          pytest -q

1. Simpan API key Claude sebagai secret CLAUDE_API_KEY di Settings → Secrets.
2. Setiap push akan memicu Claude untuk memperbarui generated.py dan menjalankan tes otomatis.

Tips Optimasi & Keamanan

• Rate limiting: Claude Pro memiliki batas kuota per menit. Gunakan --max-tokens dan --temperature untuk mengontrol output panjang.
• Prompt caching: Simpan prompt yang sering dipakai di file terpisah, lalu referensikan dengan --prompt-file.
• Keamanan API Key: Jangan pernah hard‑code key di repo. Selalu gunakan secret manager (GitHub Secrets, GitLab CI variables, atau Vault).
• Validasi output: Selalu lint kode yang dihasilkan (flake8, black, mypy) sebelum diproduksi.
• Versioning model: Tetapkan model versi di config.toml (mis. claude-2.1) untuk menghindari perubahan perilaku tak terduga.

Troubleshooting Error Umum

Kesimpulan

Claude Code memberikan cara cepat untuk menghasilkan kode yang dapat diuji dan di‑integrasikan ke pipeline CI/CD. Dengan mengikuti langkah di atas, Anda dapat:
1. Mengatur Claude Pro dan CLI.
2. Menulis prompt yang menghasilkan kode bersih dan terdokumentasi.
3. Mengotomatisasi proses melalui GitHub Actions.
4. Menjaga keamanan API dan kualitas kode melalui best practice.

Gunakan tool pendukung seperti Notion AI untuk mencatat prompt, Canva Pro untuk diagram arsitektur, atau Midjourney untuk visualisasi contoh output bila diperlukan. Selamat bereksperimen!