Claude Code dan Codex kini bisa memakai model Octafy

Tiga format API, satu gateway

Octafy sekarang menerima tiga format API dari satu API key dan satu saldo:

• POST /v1/chat/completions — OpenAI Chat Completions.
• POST /v1/messages — Anthropic Messages, untuk Claude Code.
• POST /v1/responses — OpenAI Responses, untuk Codex CLI.

Ketiganya memakai gateway, routing, billing, rate limit, dan pencatatan usage yang sama. Yang berbeda hanya bentuk request dan response di sisi klien.

Penting: ini adalah adapter protokol, bukan perubahan model. Saat Claude Code atau Codex memanggil Octafy, model yang digunakan tetap model Octafy seperti DeepSeek, GLM, atau Kimi. Octafy hanya menerjemahkan format pesan, tool, dan event streaming agar cocok dengan klien tersebut.

Claude Code

Cara paling cepat adalah memakai CLI @octafy/helper:

npx @octafy/helper

Pilih Claude Code, masukkan API key Octafy, lalu pilih model. Helper akan menulis konfigurasi ke ~/.claude/settings.json dan membuat backup file lama.

Konfigurasi manual yang dipakai helper:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.octafy.xyz",
    "ANTHROPIC_AUTH_TOKEN": "sk_live_xxxxxxxxx",
    "ANTHROPIC_MODEL": "octa/deepseek-v4.1-flash"
  }
}

Jangan menambahkan /v1 ke ANTHROPIC_BASE_URL. Claude Code menambahkan /v1/messages sendiri.

Endpoint /v1/messages mendukung streaming, tool calling, system prompt, tool result, dan usage cache. Responsnya mengikuti bentuk Anthropic Messages, termasuk content_block_delta, tool_use, dan usage.input_tokens.

Codex CLI

Untuk Codex, jalankan helper yang sama:

npx @octafy/helper

Pilih Codex CLI dan model Octafy. Helper akan menulis ~/.codex/config.toml dan ~/.codex/auth.json.

Konfigurasi manualnya:

model = "octa/deepseek-v4.1-flash"
model_provider = "octafy"

[model_providers.octafy]
name = "Octafy"
base_url = "https://api.octafy.xyz/v1"
wire_api = "responses"

Endpoint /v1/responses mendukung streaming event response.created, response.output_text.delta, response.function_call_arguments.delta, dan response.completed. Usage menyertakan input_tokens_details.cached_tokens serta output_tokens_details.reasoning_tokens.

Agent dan IDE lain

Helper juga mendukung:

• OpenCode
• Cline
• Continue
• Hermes Agent
• OpenClaw

Untuk OpenCode, helper menulis provider octafy dengan @ai-sdk/openai-compatible, model list, dan pilihan model aktif. Untuk tools lain, helper melakukan merge konfigurasi, bukan menimpa seluruh file.

Mode non-interaktif untuk automation:

octafy-helper apply   --key sk_live_xxxxxxxxx   --model octa/deepseek-v4.1-flash   --agents claude,codex,opencode   --yes

Catatan penggunaan

1. API key tetap hanya ditampilkan sekali di dashboard.
2. Jangan menaruh API key di repository. Helper menulis file konfigurasi dengan permission 600 dan menyimpan backup .octafy-backup.
3. Tidak semua model identik dalam kemampuan tool calling, reasoning, atau input multimodal. Pilih model sesuai beban kerja.
4. Billing dan cache mengikuti model Octafy yang dipilih, bukan model yang namanya dikirim klien.
5. Untuk melihat format lengkap, baca dokumentasi di octafy.xyz/docs.

Claude Code dan Codex sekarang bisa memakai katalog Octafy tanpa mengganti API key atau alur billing. Cukup pilih klien, pilih model, lalu mulai dari satu perintah.