Cara Menggunakan Claude Code dengan Model Apa Pun: Setup SKILL.md

Claude Code bisa menjadi jauh lebih berguna ketika ia mengetahui cara kerja lapisan routing AI Anda. Setup SKILL.md adalah cara yang rapi untuk mengajarkan alur kerja itu: di mana router Flatkey berada, cara menemukan ID model yang aktif, cara memanggil model dan tool yang didukung, serta aturan keamanan mana yang harus diikuti sebelum menghabiskan saldo atau menyentuh sistem produksi.

Ada satu catatan penting sejak awal. Loop penalaran Claude Code sendiri tetap berjalan di Claude. Dokumentasi gateway Anthropic menyatakan bahwa Claude Code dapat terhubung ke gateway LLM, tetapi tidak mendukung routing Claude Code itu sendiri ke model non-Claude melalui gateway. Gunakan panduan ini untuk versi praktis dari Cara Menggunakan Claude Code dengan Model Apa Pun: Setup SKILL.md: biarkan Claude Code tetap menjadi agen coding Anda, lalu berikan skill Flatkey agar ia bisa menemukan dan memanggil model atau tool berbayar apa pun yang didukung Flatkey dari proyek Anda saat tugas memang memerlukannya.

SKILL.md publik Flatkey dibuat untuk pekerjaan itu. File ini memberi tahu agen untuk menggunakan https://router.flatkey.ai, base URL yang kompatibel dengan OpenAI https://router.flatkey.ai/v1, katalog model live, marketplace tools, panggilan awal yang kecil, request ID, dan gate persetujuan untuk penulisan, pengiriman, pembelian, penghapusan, publikasi, atau perubahan izin.

Jika Anda baru mengenal router-nya sendiri, biarkan quickstart API Flatkey tetap terbuka di samping panduan ini. Jika Anda membandingkannya dengan migrasi provider yang lebih luas, panduan alternatif API OpenAI dan workflow API AI terpadu menjelaskan pola base URL dengan lebih rinci.

Jawaban singkat

Gunakan setup ini ketika Anda ingin Claude Code mengoperasikan Flatkey dari dalam repo Anda:

1. Buat API key Flatkey di Flatkey Console.
2. Instal skill Flatkey ke dalam Claude Code sebagai ~/.claude/skills/flatkey/SKILL.md atau .claude/skills/flatkey/SKILL.md.
3. Simpan FLATKEY_API_KEY di shell Anda atau secret manager lokal, bukan di file yang dikomit.
4. Mintalah Claude Code menggunakan skill Flatkey, mengambil katalog model live, dan menjalankan panggilan smoke kecil melalui https://router.flatkey.ai/v1.
5. Periksa Flatkey Usage Logs untuk model, jumlah token, latensi, status, dan biaya.

Jika Anda ingin lalu lintas keluarga Claude milik Claude Code melewati Flatkey, gunakan panduan Claude Code dari Flatkey, bukan base URL /v1 yang kompatibel dengan OpenAI:

export ANTHROPIC_BASE_URL="https://router.flatkey.ai"
export ANTHROPIC_API_KEY="$FLATKEY_API_KEY"

Jalur itu digunakan untuk routing gateway Claude Code. Jalur SKILL.md digunakan untuk mengajarkan Claude Code cara menggunakan model dan tool Flatkey dari proyek.

Apa yang diubah SKILL.md di Claude Code

Skill Claude Code adalah direktori dengan file SKILL.md. Claude Code memuat metadata skill saat startup, lalu membaca isi skill hanya ketika tugas cocok atau saat Anda memanggil skill secara langsung. Itu menjadikan skill sebagai tempat yang lebih baik daripada CLAUDE.md untuk prosedur yang dapat diulang seperti "temukan model Flatkey, pilih route yang didukung, jalankan panggilan kecil, dan verifikasi Usage Logs."

Dengan Flatkey, skill seharusnya membuat Claude Code melakukan lima hal secara konsisten:

Itulah inti praktis dari Cara Menggunakan Claude Code dengan Model Apa Pun: Setup SKILL.md. Claude Code tetap menjadi orkestrator. Flatkey menjadi lapisan model dan alat yang dapat dioperasikannya secara sengaja.

Langkah 1: Pilih instalasi personal atau proyek

Instal skill secara global jika Anda ingin skill tersedia di setiap repo:

mkdir -p ~/.claude/skills/flatkey
curl -fsSL https://flatkey.ai/SKILL.md \
  -o ~/.claude/skills/flatkey/SKILL.md

Instal di dalam repo jika Anda ingin tim berbagi workflow Flatkey yang sama:

mkdir -p .claude/skills/flatkey
curl -fsSL https://flatkey.ai/SKILL.md \
  -o .claude/skills/flatkey/SKILL.md

Untuk skill proyek bersama, tinjau file tersebut sebelum meng-commit-nya:

sed -n '1,200p' .claude/skills/flatkey/SKILL.md

Jangan ubah perintah instalasi menjadi skrip shell yang berjalan otomatis. Skill adalah konten instruksi. Perlakukan seperti menambahkan prosedur pengembangan lain ke repo Anda: ambil, tinjau, lalu commit hanya jika tim menyetujuinya.

Langkah 2: Atur kunci Flatkey dengan aman

Gunakan variabel lingkungan:

export FLATKEY_API_KEY="sk-fk-your-key"

Jika Anda perlu variabel itu tetap tersimpan, letakkan di profil shell Anda, secret manager, atau file environment lokal yang diabaikan oleh git. Jangan letakkan kunci di .claude/settings.json, CLAUDE.md, SKILL.md yang di-commit, atau prompt yang Anda tempelkan ke thread bersama.

Aturan skill Flatkey itu sendiri sederhana: gunakan FLATKEY_API_KEY yang sudah ada jika sudah dikonfigurasi, dan jangan pernah mencetak, mencatat, meng-commit, atau mengirim kunci itu ke mana pun selain router.flatkey.ai atau Flatkey Console yang terautentikasi.

Langkah 3: Pastikan Claude Code melihat skill tersebut

Jalankan Claude Code dari repo atau terminal tempat skill tersedia:

claude

Kemudian periksa skill yang tersedia:

/skills

Anda seharusnya melihat flatkey di daftar skill. Jika Anda menginstal skill tersebut saat sesi Claude Code sedang berjalan dan skill itu tidak muncul, restart Claude Code. Claude Code dapat mendeteksi banyak perubahan skill selama sesi, tetapi me-restart adalah cara paling sederhana untuk menghilangkan ambiguitas selama setup.

Sekarang minta tugas awal yang aman:

Use the flatkey skill. Verify that FLATKEY_API_KEY is available without printing it, fetch the live model catalog from Flatkey, and summarize the first five text-capable model IDs you see. Do not run a generation yet.

Ini menguji discovery tanpa menghabiskan budget generasi.

Langkah 4: Ambil katalog model live

Skill Flatkey memberi tahu Claude Code untuk mengambil katalog model live sebelum memilih model. Perintah langsungnya adalah:

curl -fsS https://router.flatkey.ai/v1/models \
  -H "Authorization: Bearer $FLATKEY_API_KEY"

Untuk alur kerja nyata, minta Claude Code memilih hanya dari ID yang dikembalikan:

Use the flatkey skill. Fetch the live model catalog, choose one low-cost text model returned by the catalog for a one-sentence smoke test, and explain why you chose it before running the request.

Ini menghindari kesalahan agen yang umum: menggunakan nama model dari ingatan atau dari artikel lama. Katalog adalah sumber kebenaran untuk apa yang dapat dipanggil oleh kunci Anda pada saat itu.

Langkah 5: Jalankan smoke call kecil yang kompatibel dengan OpenAI

Setelah katalog kembali, jalankan permintaan kecil melalui API Flatkey yang kompatibel dengan OpenAI:

curl https://router.flatkey.ai/v1/chat/completions \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "replace-with-a-model-id-from-the-live-catalog",
    "messages": [
      {
        "role": "user",
        "content": "Reply with one sentence: Flatkey smoke test passed."
      }
    ],
    "max_tokens": 40
  }'

Pertahankan panggilan pertama tetap sederhana. Anda sedang menguji autentikasi, ID model, base URL, bentuk respons, dan visibilitas ledger. Simpan prompt konteks panjang, tool call, pembuatan gambar, dan batch job sampai jalur dasar berfungsi.

Langkah 6: Biarkan Claude Code memanggil model apa pun yang didukung dari sebuah tugas

Setelah smoke test berhasil, Anda dapat meminta Claude Code untuk mengarahkan pekerjaan ke model yang sesuai dengan tugas.

Contohnya:

Use the flatkey skill. I need a second-model review of this function. Fetch the live catalog, select a coding-capable model returned by the catalog, run a small review request through Flatkey, and report the model ID, request result, and any request ID or usage fields returned. Do not print secrets.

Atau:

Use the flatkey skill. Compare two Flatkey-supported text models on this prompt. Keep both calls under 200 output tokens. Show the outputs side by side and tell me which one I should use for this low-risk internal summarization task.

Itulah pola "model apa pun" yang bekerja dengan baik dengan Claude Code: Claude Code mengoordinasikan tugas, membaca file, menerapkan konteks repo, dan menggunakan Flatkey sebagai jalur model eksternal yang terkontrol ketika model kedua atau keluarga model yang berbeda berguna.

Untuk pemilihan model produksi, padukan ini dengan panduan katalog model AI sehingga Claude Code meninjau jenis endpoint, unit harga, ketersediaan, dan status verifikasi sebelum merekomendasikan rute.

Langkah 7: Gunakan Alat Flatkey hanya setelah inspeksi

SKILL.md milik Flatkey juga mencakup alat bermeter. Aturan pentingnya adalah Claude Code harus memeriksa sebuah alat sebelum menjalankannya. Ia tidak boleh mengarang ID alat, field yang diperlukan, harga, nama penyedia, atau unit penagihan.

Prompt awal yang baik adalah:

Use the flatkey skill. Open the Flatkey tools marketplace in the browser, inspect the search-related tools available to my account, and summarize the required fields and billing unit for one candidate tool. Do not execute the tool yet.

Lalu, ketika Anda siap:

Use the flatkey skill. Run the inspected tool with a small limit and an idempotency key. Before execution, repeat the exact tool, required fields, expected billing unit, and maximum budget for my approval.

Ini membuat Claude Code tetap berguna tanpa membiarkan agen melenceng ke panggilan berbayar yang tidak terkontrol.

Langkah 8: Arahkan traffic Claude milik Claude Code melalui Flatkey saat diperlukan

Setelan SKILL.md tidak sama dengan merutekan Claude Code itu sendiri melalui gateway. Jika tujuan Anda adalah menjalankan permintaan keluarga Claude dari Claude Code melalui Flatkey, konfigurasikan Claude Code sebagai klien gateway berformat Anthropic:

export ANTHROPIC_BASE_URL="https://router.flatkey.ai"
export ANTHROPIC_API_KEY="$FLATKEY_API_KEY"

Jangan gunakan awalan /v1 di jalur ini. Claude Code dan Anthropic SDK akan menambahkan rute yang diperlukan. Setelah mengatur variabel, mulai Claude Code dari shell yang sama dan jalankan:

/status

Cari Anthropic base URL dan sumber kredensial. Lalu kirim prompt singkat dan periksa Flatkey Usage Logs. Jika base URL tidak muncul, berarti Claude Code tidak menerima variabel lingkungan tersebut.

Gunakan jalur ini ketika Anda ingin penggunaan Claude oleh Claude Code masuk ke saldo dan ledger Flatkey. Gunakan jalur skill ketika Anda ingin Claude Code memanggil model dan alat yang didukung Flatkey dari repo Anda.

Untuk keputusan routing yang berdekatan, lihat routing API Claude vs GPT. Jika kasus penggunaan Anda adalah agen yang memanggil alat eksternal, daftar periksa Gemini API untuk agen AI tetap berguna bahkan ketika keluarga model berubah, karena kontrolnya serupa: ID model yang presisi, retry yang dibatasi, validasi alat, dan peninjauan penggunaan.

Kesalahan umum

Kesalahan 1: Menganggap SKILL.md mengubah otak Claude Code

Itu tidak. Sebuah skill memberi Claude Code instruksi dan prosedur yang dapat digunakan kembali. Itu tidak mengubah loop agent milik Claude Code sendiri menjadi GPT, Gemini, DeepSeek, Qwen, atau model lainnya.

Kesalahan 2: Menggunakan /v1 dengan ANTHROPIC_BASE_URL

Base URL OpenAI-compatible milik Flatkey adalah:

https://router.flatkey.ai/v1

Routing gateway Claude Code menggunakan:

https://router.flatkey.ai

Jangan dicampur.

Kesalahan 3: Meng-commit kredensial di pengaturan Claude

Project .claude/settings.json biasanya dibagikan dengan repo. Jangan letakkan kunci di sana. Gunakan export shell, vault, atau .claude/settings.local.json hanya jika repo Anda mengabaikannya dan tim Anda menerima alur kerja lokal tersebut.

Kesalahan 4: Membiarkan agent menebak ID model

Selalu ambil /v1/models terlebih dahulu. Jika sebuah ID model tidak ada dalam respons katalog live untuk kunci Anda, jangan gunakan itu.

Kesalahan 5: Menjalankan tools berbayar sebelum memeriksanya

Untuk Flatkey Tools, periksa dulu field yang diperlukan, contoh, unit penagihan, dan harga pastinya. Lalu gunakan idempotency key dan minta persetujuan sebelum eksekusi.

Daftar periksa setup yang bisa disalin

Gunakan daftar periksa ini untuk satu mesin developer:

# 1. Install skill Flatkey untuk Claude Code
mkdir -p ~/.claude/skills/flatkey
curl -fsSL https://flatkey.ai/SKILL.md \
  -o ~/.claude/skills/flatkey/SKILL.md

# 2. Tinjau isinya
sed -n '1,200p' ~/.claude/skills/flatkey/SKILL.md

# 3. Export kunci Flatkey Anda
export FLATKEY_API_KEY="sk-fk-your-key"

# 4. Mulai Claude Code
claude

Lalu kirim prompt:

Gunakan skill flatkey. Konfirmasi bahwa skill Flatkey sudah dimuat, verifikasi bahwa FLATKEY_API_KEY tersedia tanpa mencetaknya, ambil katalog model live, dan jalankan satu smoke test chat-completions kecil melalui https://router.flatkey.ai/v1 menggunakan ID model yang dikembalikan oleh katalog.

Setelah panggilan, buka Flatkey Usage Logs dan pastikan request muncul dengan model, status, jumlah token, latensi, dan biaya yang diharapkan.

FAQ

Dapatkah Claude Code menggunakan model apa pun melalui SKILL.md?

Claude Code sendiri tetap berjalan pada Claude. Setup SKILL.md memungkinkan Claude Code menemukan dan memanggil model serta tools yang didukung Flatkey dari project Anda, sehingga sebuah tugas dapat menggunakan model lain melalui API Flatkey bila sesuai.

Apakah ini sama dengan mengubah ANTHROPIC_BASE_URL?

Tidak. ANTHROPIC_BASE_URL=https://router.flatkey.ai merutekan traffic Claude-family milik Claude Code melalui gateway. Menginstal https://flatkey.ai/SKILL.md mengajarkan Claude Code cara mengoperasikan API dan tools Flatkey selama sebuah tugas.

Haruskah saya menginstal skill Flatkey secara global atau di repo?

Gunakan ~/.claude/skills/flatkey/ untuk penggunaan pribadi lintas proyek. Gunakan .claude/skills/flatkey/ ketika repo harus membawa workflow tim yang dibagikan. Commit hanya file skill yang sudah direview, jangan pernah commit kredensial.

Mengapa panduan mengambil /v1/models terlebih dahulu?

Karena ketersediaan model berubah. Katalog Flatkey yang live lebih aman daripada nama model yang disalin dari ingatan, jawaban chat, atau dokumen lama.

Apa yang harus saya verifikasi setelah setup?

Verifikasi tiga hal: Claude Code melihat skill tersebut, permintaan katalog Flatkey berhasil, dan Usage Logs menampilkan permintaan smoke dengan model, status, token, latensi, dan biaya.

Referensi resmi

• Flatkey SKILL.md: https://flatkey.ai/SKILL.md
• Flatkey quickstart: https://docs.flatkey.ai/quickstart.md
• Panduan Flatkey Claude Code: https://docs.flatkey.ai/guides/claude-code.md
• Panduan Flatkey OpenAI SDK: https://docs.flatkey.ai/guides/openai-sdk.md
• Anthropic Claude Code skills: https://code.claude.com/docs/en/skills
• Dokumentasi gateway Anthropic Claude Code: https://docs.anthropic.com/en/docs/claude-code/llm-gateway.md
• Panduan koneksi gateway Anthropic: https://docs.anthropic.com/en/docs/claude-code/llm-gateway-connect.md
• Ringkasan Anthropic Agent Skills: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview