anoman
Panduan Integrasi Agent
CLI + Python

Hubungkan Claude Code ke Anoman AI

Arahkan Claude Code dan klien Anthropic SDK apa pun melalui Anoman menggunakan endpoint proxy yang kompatibel dengan Anthropic. Semua guardrail berlaku pada setiap request — termasuk penyelesaian streaming dan tool call.

Prasyarat

  • Akun Anoman AI dengan API key aktif
  • Claude Code CLI terpasang (npm install -g @anthropic-ai/claude-code)
  • Atau: Python 3.9+ dengan anthropic SDK terpasang

Endpoint yang kompatibel dengan Anthropic

Claude Code menggunakan format Anthropic Messages API, bukan format OpenAI. Anoman menyediakan endpoint terpisah yang kompatibel dengan Anthropic di /anthropic. Gunakan endpoint ini — bukan endpoint OpenAI /v1 — untuk Claude Code dan Anthropic Python SDK.

Langkah 1: Konfigurasikan Claude Code CLI

Atur dua variabel lingkungan sebelum meluncurkan Claude Code. CLI membacanya secara otomatis.

export ANTHROPIC_BASE_URL=https://api.anoman.io/anthropic
export ANTHROPIC_API_KEY=anm-sk-your-key-here

# Launch Claude Code — all requests now route through Anoman
claude

Langkah 2: Konfigurasi Python SDK

Teruskan base_url saat membuat klien Anthropic. SDK mengirim semua request ke proxy Anoman, yang menerapkan guardrail sebelum meneruskan ke Anthropic.

import anthropic

client = anthropic.Anthropic(
    api_key="anm-sk-your-key-here",
    base_url="https://api.anoman.io/anthropic",
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Summarize this document."}],
)
print(message.content[0].text)

Respons streaming

Streaming bekerja secara identik melalui proxy Anoman. Guardrail berjalan pada prompt sebelum stream dibuka.

with client.messages.stream(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain this code."}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Saat guardrail terpicu

Jika sebuah request diblokir oleh pipeline guardrail, Anoman mengembalikan 403 sebelum konten apa pun mencapai Anthropic. SDK menampilkannya sebagai anthropic.APIStatusError.

try:
    message = client.messages.create(...)
except anthropic.APIStatusError as e:
    if e.status_code == 403:
        print("Blocked by guardrail:", e.body)
    raise

Periksa docs/openapi/ untuk skema error terkini.

Header transparansi guardrail

Setiap respons dari proxy Anoman menyertakan header hasil guardrail. Periksa ini di log Anda untuk memverifikasi bahwa pipeline aktif.

X-Anoman-Guardrail-Injection: pass score=0.04
X-Anoman-Guardrail-Pii: pass
X-Anoman-Guardrail-Content: pass
X-Anoman-Cache: none

Butuh bantuan dengan integrasi Anda?

Gabung Founding 50 untuk akses awal dan dukungan langsung dari tim Anoman.

Gabung Founding 50