Beyhan Ogur
96 lines
3.0 KiB
Markdown
96 lines
3.0 KiB
Markdown
# ClaudeCode_Setup
|
||
|
||
**Özet:** Claude Code CLI'ı bu LLM Gateway üzerinden kullanmak için gerekli yapılandırma. Claude Code, Anthropic Messages API formatında konuşur; gateway `/anthropic/*` endpoint'i ile bunu OpenAI formatına çevirip herhangi bir OpenAI-compatible backend'e (DeepSeek, vb.) iletir.
|
||
|
||
**Kütüphaneler:** Claude Code CLI, Go Fiber v3
|
||
|
||
**Bağlantılar:** [[AnthropicHandler]], [[BifrostTransform]], [[Anthropic Flow]], [[Config]], [[Index]]
|
||
|
||
## Nasıl Çalışır
|
||
|
||
```
|
||
Claude Code → x-api-key → Gateway /anthropic/v1/messages → AnthropicToBifrost()
|
||
↓
|
||
OpenAI Chat Completions
|
||
↓
|
||
OPENAI_BACKEND/v1/chat/completions
|
||
↓
|
||
BifrostToAnthropic()
|
||
↓
|
||
Claude Code ← Anthropic Messages API ← Gateway ← ← ← ← ← ←
|
||
```
|
||
|
||
## Claude Code Yapılandırması
|
||
|
||
Claude Code'u gateway'e yönlendirmek için iki yol var:
|
||
|
||
### 1. Environment Variable (Önerilen)
|
||
|
||
```bash
|
||
export ANTHROPIC_BASE_URL="http://localhost:8000/anthropic"
|
||
export ANTHROPIC_API_KEY="<upstream-api-key>"
|
||
claude
|
||
```
|
||
|
||
### 2. Claude Code Settings JSON
|
||
|
||
`~/.claude/settings.json`:
|
||
|
||
```json
|
||
{
|
||
"anthropicBaseUrl": "http://localhost:8000/anthropic",
|
||
"apiKey": "<upstream-api-key>"
|
||
}
|
||
```
|
||
|
||
## Gateway Konfigürasyonu (`.env`)
|
||
|
||
```env
|
||
PORT=8000
|
||
OPENAI_BACKEND=https://api.deepseek.com
|
||
OPENAI_KEY=sk-your-deepseek-api-key
|
||
REQUEST_TIMEOUT_SECONDS=30
|
||
```
|
||
|
||
| Değişken | Değer | Açıklama |
|
||
|---|---|---|
|
||
| `OPENAI_BACKEND` | `https://api.deepseek.com` | Upstream LLM API (OpenAI-compatible) |
|
||
| `OPENAI_KEY` | `sk-...` | Upstream API anahtarı (auto-inject) |
|
||
|
||
## Test
|
||
|
||
Gateway çalışırken Claude Code'un gönderdiği formatta test:
|
||
|
||
```bash
|
||
curl -X POST "http://localhost:8000/anthropic/v1/messages" \
|
||
-H "Content-Type: application/json" \
|
||
-H "x-api-key: sk-test-key" \
|
||
-H "anthropic-version: 2023-06-01" \
|
||
-d '{
|
||
"model": "claude-sonnet-4-20250514",
|
||
"max_tokens": 256,
|
||
"messages": [{"role": "user", "content": "Merhaba, 2+2 nedir?"}]
|
||
}'
|
||
```
|
||
|
||
Başarılı yanıt formatı:
|
||
|
||
```json
|
||
{
|
||
"id": "chatcmpl-xxx",
|
||
"type": "message",
|
||
"role": "assistant",
|
||
"content": [{"type": "text", "text": "4"}],
|
||
"model": "DeepSeek/deepseek-v4",
|
||
"stop_reason": "end_turn"
|
||
}
|
||
```
|
||
|
||
## Önemli Notlar
|
||
|
||
- Claude Code `x-api-key` header'ı ile authentication yapar → Gateway bunu `Authorization: Bearer`'a çevirir
|
||
- `anthropic-version` header'ı olduğu gibi upstream'e iletilir
|
||
- Model adı otomatik prefix alır: `claude-sonnet-4-20250514` → `Anthropic/claude-sonnet-4-20250514`
|
||
- **Streaming (`stream: true`) henüz desteklenmez** — response tamamlanana kadar bekler
|
||
- Claude Code `--no-stream` flag'i ile streaming'i kapatarak kullanılabilir: `claude --no-stream`
|