연동
OpenAI 호환 또는 Anthropic 호환 클라이언트가 있는 도구라면 무엇이든 Kiln에 연결할 수 있습니다. base URL을 https://api.bricksum.com/v1으로 설정하고 sk-bk-로 시작하는 키를 넣으세요. 아래에 SDK별 페이지가 하나씩 있고, 각 페이지의 스니펫은 실제 API로 실행해 확인한 것입니다. 그다음은 코딩 도구입니다.
SDK
각 페이지는 일부러 짧게 썼습니다. 무엇을 설치하는지, 실제 API로 실행해 확인한 호출 하나, 그리고 Kiln에서 다른 점 두세 가지입니다. SDK가 공통으로 쓰는 내용은 다섯 페이지에 반복하지 않고 API 레퍼런스에 모아 두었습니다.
코딩 도구
Claude Code, Codex CLI, Hermes Agent, OpenCode, OpenClaw, Cursor는 각각 짧은 설정 변경으로 연결됩니다. 스니펫은 이 페이지에 있으며, 로그인하면 콘솔 → 도구 연결에서도 같은 스니펫을 볼 수 있습니다. 이 도구들의 에이전트 모드는 위에서 설명한 자동 툴 선택에 의존합니다.
Claude Code
Claude Code는 Anthropic Messages API를 사용하고 Kiln이 이를 직접 제공하므로 router 없이 연결합니다. ANTHROPIC_BASE_URL에 Kiln API 오리진을, ANTHROPIC_AUTH_TOKEN에 Kiln 키를 넣고 ANTHROPIC_MODEL과 ANTHROPIC_DEFAULT_*_MODEL 슬롯을 모두 Kiln 모델 ID로 지정하세요.
# Claude Code connects to Kiln directly — Kiln serves the Anthropic Messages API.
# Put these in your shell profile (or a direnv file); never commit the key.
export ANTHROPIC_BASE_URL="https://api.bricksum.com"
export ANTHROPIC_AUTH_TOKEN="sk-bk-..." # your Kiln API key
# Claude Code picks a model per task slot — point every slot at Kiln's model.
export ANTHROPIC_MODEL="qwen3-32b"
export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen3-32b"
export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen3-32b"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen3-32b"
# Claude Code does not know this model, so it assumes a 200k context window and
# lets the session grow past what the upstream accepts. Tell it the real one —
# its own system prompt and tools take a large share of it, so it compacts early.
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=32768
claudeClaude Code 공식 문서와 대조해 확인한 날짜:
Codex CLI
Codex CLI는 ~/.codex/config.toml에서 provider 블록을 읽고 Responses API(wire_api = "responses")로 Kiln과 통신합니다. Codex를 시작하기 전에 셸에 KILN_API_KEY를 설정하고 Kiln 카탈로그의 모델 ID를 그대로 사용하세요.
model = "qwen3-32b"
model_provider = "kiln"
# The model's real window; Codex's own prompt and tools take a large share of it.
model_context_window = 32768
[model_providers.kiln]
name = "Kiln"
base_url = "https://api.bricksum.com/v1"
env_key = "KILN_API_KEY"
# Codex speaks the Responses API (Kiln serves POST /v1/responses); "chat" is gone.
wire_api = "responses"# Set this in your shell profile, never commit it.
export KILN_API_KEY="sk-bk-..."
codexCodex CLI 공식 문서와 대조해 확인한 날짜:
Hermes Agent
Hermes Agent는 OpenAI 호환 엔드포인트를 위한 custom provider 경로를 제공합니다. config.yaml에 엔드포인트와 모델을 저장하고 OPENAI_API_KEY로 키를 전달하면 세션이 바뀌어도 설정이 유지됩니다.
model:
provider: custom
default: qwen3-32b
base_url: https://api.bricksum.com/v1# Set this in your shell profile, never commit it.
export OPENAI_API_KEY="sk-bk-..."
# Start Hermes, then send a short test prompt.
hermesHermes Agent 공식 문서와 대조해 확인한 날짜:
OpenCode
OpenCode는 opencode.json에서 OpenAI 호환 provider 패키지를 사용합니다. 같은 provider 설정을 터미널과 데스크톱 워크플로우에 적용할 수 있습니다.
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"kiln": {
"npm": "@ai-sdk/openai-compatible",
"name": "Kiln",
"options": {
"baseURL": "https://api.bricksum.com/v1",
"apiKey": "{env:KILN_API_KEY}"
},
"models": {
"qwen3-32b": {
"name": "qwen3-32b",
"limit": { "context": 32768, "output": 8192 }
}
}
}
}
}# Set this in your shell profile, never commit it.
export KILN_API_KEY="sk-bk-..."
opencodeOpenCode 공식 문서와 대조해 확인한 날짜:
OpenClaw
OpenClaw는 models.providers 아래에 custom provider를 등록합니다. Kiln은 openai-completions adapter를 사용하고, 선언한 모델을 kiln/qwen3-32b로 에이전트 기본값에 지정합니다.
{
"models": {
"mode": "merge",
"providers": {
"kiln": {
"baseUrl": "https://api.bricksum.com/v1",
"apiKey": "${KILN_API_KEY}",
"api": "openai-completions",
"models": [
{
"id": "qwen3-32b",
"name": "qwen3-32b",
"contextWindow": 32768
}
]
}
}
},
"agents": {
"defaults": { "model": { "primary": "kiln/qwen3-32b" } }
}
}# Set this in your shell profile, never commit it.
export KILN_API_KEY="sk-bk-..."OpenClaw 공식 문서와 대조해 확인한 날짜:
Cursor
Cursor Settings → Models에서 Kiln 키를 입력하고 Override OpenAI Base URL을 켠 뒤, Kiln 모델 ID를 추가해 선택하세요.
Cursor → Settings → Models
1. "OpenAI API Key" 에 Kiln API 키 입력 (sk-bk-...)
2. "Override OpenAI Base URL" 활성화
→ https://api.bricksum.com/v1
3. 모델 목록에 qwen3-32b 추가 후 선택Cursor 공식 문서와 대조해 확인한 날짜:
쿡북
이 연동을 처음부터 끝까지 활용하는 레시피(스트리밍 채팅 CLI 등)는 쿡북에 있습니다. 쿡북 보기 →