Claude Codeのインストール：Windows、macOS、Linuxでの手順、サブスクリプション不要のAPIキー、カード決済

簡単に言うと、Claude Codeは、お使いのターミナルに合った1行のコマンドでインストールできます。macOS、Linux、WSLではinstall.sh、Windows PowerShellではirm … | iex、コマンドプロンプト（CMD）ではinstall.cmdの行を実行します。3つともすぐ下に示します。この方法ではNode.jsは不要です。npmでインストールする場合はNode.js 22以降が必要です。インストール後は、Claudeアカウントでログインする方法（Pro、Max、Team、Enterprise、またはConsole。無料プランはClaude Codeを対象としていません）と、サブスクリプションなしでAPIキーを使う方法の2つがあります。キーを使う場合は、ANTHROPIC_BASE_URL=https://api.kunavo.com（末尾に/v1を追加しない）、ANTHROPIC_AUTH_TOKEN、およびモデルを固定する4つの変数を設定します。セッション中に/statusを実行すると、キーが有効かどうかを確認できます。料金が発生するのは使用したトークン分だけです。残高はVisaまたはMastercardのカード、Apple Pay、Google Pay、またはLinkで、最低10 USDからチャージできます。分割払いとPaparaには対応していません。

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

:: Windows – Komut İstemi (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Bu satırları ve aşağıdaki değişken adlarını Claude Code'un インストール ve ゲートウェイ接続 belgelerinden 2026年10月3日 tarihinde aldık. Anthropic bu belgeleri Türkçe yayımlamıyor; hata mesajlarını bu yüzden İngilizce asıllarıyla veriyoruz. Kunavo fiyatlarını ve ödeme yöntemlerini en son 2026年10月3日 tarihinde kontrol ettik. VPN ya da yurt dışı proxy'si aramanıza gerek yok: Anthropicの対応国ページ Türkiye'yi hem Claude.ai hem API için sayıyor (kontrol: 2026年10月3日).

どの行をどのターミナルで使いますか？

インストールでつまずく人の多くは、コマンドではなくターミナルを間違えています。以下の表で、お使いの環境に合う行を確認できます。Windowsを使用している場合のターミナルの見分け方は、次のセクションで説明します。

システム要件

公式インストールドキュメントの要件（2026年10月3日時点）:

• オペレーティングシステム: macOS 13.0以降、Windows 10バージョン1809以降またはWindows Server 2019以降、LinuxではUbuntu 20.04、Debian 10、Alpine Linux 3.19以降。
• ハードウェア: 4 GB以上のRAMとx64またはARM64プロセッサ。32ビットWindowsはサポートされていません。
• シェル: Bash、Zsh、PowerShell、またはCMD。
• Node.js: ネイティブインストーラーには不要。npmを使う場合のみ22以降が必要です。
• アカウント: ログインする場合はPro、Max、Team、Enterprise、またはConsole。APIキーを使う場合、サブスクリプションもログインも不要です。

インターネット上のトルコ語の説明の一部は、このリストの古い版をコピーしています。npmにはNode.js 18、LinuxにはUbuntu 18.04またはCentOS 7と記載されたものが、今でも存在します。現在のドキュメントでは、最低バージョンとしてNode.js 22とUbuntu 20.04が指定されています。「米国発の固定プロキシがなければすべての手順でエラーになる」という警告も、トルコには当てはまりません。むしろ、開いたままのVPN接続では地域エラーになる可能性があります（macOSとLinuxのセクションにあるダウンロードエラーを参照してください）。

Claude CodeのWindowsへのインストール

Windowsでは、管理者権限、WSL、またはGitは必要ありません。公式ドキュメントでは、ターミナルを管理者として起動することを求めていません。トルコ語の動画で見られる「PowerShellを管理者として実行する」という手順は省略できます。知っておくべきことは、現在どのターミナルを使っているかだけです。

• プロンプトがPS C:\Users\KullaniciAdi>のようにPSで始まっている場合はPowerShellです。irm … | iexの行を使用してください。
• 先頭にPSがなく、C:\Users\KullaniciAdi>だけが表示されている場合はコマンドプロンプトです。install.cmdの行を使用してください。
• スタートメニューにある「Windows PowerShell (x86)」は開かないでください。32ビットプロセスのため、64ビットのコンピューターでもClaude Code does not support 32-bit Windowsというエラーが表示されます。サフィックスのない「Windows PowerShell」を選択してください。

間違ったウィンドウに行を貼り付けることは、Windowsで発生するエラーの主な原因ですが、メッセージには明確に示されません。PowerShellにCMDの行を貼り付けると、The token '&&' is not a valid statement separatorが返されます。CMDにPowerShellの行を貼り付けると、トルコ語版Windowsでは「'irm' は内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチファイルとして認識されません。」と表示されます（英語システムでは'irm' is not recognized as an internal or external command）。macOSのcurl … | bashの行をPowerShellで実行すると、A parameter cannot be found that matches parameter name 'fsSL'または'bash' is not recognized as the name of a cmdletが表示されます。トルコ語のシステムでは、これらの文言もトルコ語になる場合があります。いずれの場合も解決策は同じです。現在使用しているターミナル用の行を使ってください。

Git for WindowsとWSLは必要ですか？

İkisi de isteğe bağlı. Git for Windows kuruluysa Claude Code kabuk komutlarını onunla gelen Git Bash'te çalıştırır, değilse PowerShell aracına geçer; belge Git'i öneriyor ama şart koşmuyor. Git kurulu olduğu hâlde Git Bash bulunamıyorsa ~/.claude/settings.json dosyasının env bloğunda CLAUDE_CODE_GIT_BASH_PATH değişkenine bash.exe dosyasının tam yolunu verin (belgedeki örnek: C:\Program Files\Git\bin\bash.exe).

WSLを選ぶ理由は2つあります。Linuxツールが必要な場合、またはコマンドをサンドボックス内で実行したい場合です。ネイティブWindowsインストールにはサンドボックスがありません。

WSLを使用する場合は、インストールも使用もWSLターミナルで行ってください。macOS/Linuxの行はそこで実行でき、claudeもそこから起動します。

「claude」コマンドが見つからない

インストールが完了したのに'claude' is not recognized（macOSとLinuxではcommand not found: claude）と表示される場合、インストール前に開いたウィンドウで実行している可能性が高いです。インストーラーはPATH変数を更新しますが、古いターミナルには反映されません。まずターミナルを閉じて、もう一度開いてください。プログラムはWindowsでは%USERPROFILE%\.local\bin\claude.exe、macOSとLinuxでは~/.local/bin/claudeにあります。Windowsで新しいウィンドウでも解決しない場合は、ドキュメントのコマンドを使って、フォルダーをユーザーのPATH変数に追加してください。

# 1. Kurulum klasörü PATH içinde mi?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sonuç yoksa kullanıcı PATH'ine ekleyin, terminali kapatıp yeniden açın
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Yeni terminalde
claude --version

npm.ps1を読み込めません

このメッセージはnpmを使う場合にのみ表示されます。npmはPowerShell用の.ps1ランチャーを書き込みますが、システムのスクリプト実行ポリシー（execution policy）がそれをブロックします。ドキュメントでは、コマンドをnpm.cmdおよびclaude.cmdという名前で実行する、PowerShellでネイティブインストーラーに切り替える、または自分のユーザーに対してのみローカルスクリプトを許可する、という3つの方法を示しています。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

macOSとLinuxへのインストール

上記のinstall.shの行は、公式ドキュメントの「Native Install (Recommended)」タブにあります。WSLでもそのまま実行できます。この方法でインストールしたClaude Codeは、新しいバージョンをバックグラウンドで自動的にダウンロードします。パッケージマネージャーを使いたい場合は、HomebrewとWinGetも公式の選択肢です。ただし、ドキュメントによると、これらのインストール方法はデフォルトでは自動更新されず、パッケージマネージャーから自分で新しいバージョンを取得します。

# Homebrew – stable kanalı; varsayılan olarak kendini güncellemez
brew install --cask claude-code

# WinGet (Windows) – varsayılan olarak kendini güncellemez
winget install Anthropic.ClaudeCode

スクリプトの代わりにHTMLまたは403が返る場合

syntax error near unexpected token '<' mesajı, bash'e betik yerine bir HTML sayfasının gittiğini gösterir; curl: (22) The requested URL returned error: 403 ise sunucunun indirmeyi reddettiğini. インストールの問題に関するドキュメント (kontrol: 2026年10月3日) ikisini de yükleyici adresinin betik döndürmemesine bağlıyor. Sayfada App unavailable in region yazıyorsa istek, belgeye göre Claude Code'un sunulmadığı bir ülkeden gelmiş görünüyor. Türkiye listede olduğuna göre bu mesajı Türkiye'den alıyorsanız trafiğiniz büyük ihtimalle bir VPN ya da proxy üzerinden başka bir ülkeye çıkıyordur; kapatıp yeniden deneyin. İçeriksiz bir 403 genellikle şirket proxy'sinden ya da güvenlik duvarından gelir: başka bir ağdan deneyin veya BT ekibinizden bu adrese izin vermesini isteyin.

npmでのインストール: Node.js 22が必須

npm yolu kaldırılmadı, resmi belgede hâlâ anlatılıyor; ama paketin istediği sürüm artık Node.js 22 ve üstü. node -v daha eski bir sürüm gösteriyorsa npm kurulumu durdurmaz, yalnızca bir EBADENGINE uyarısı basar. Yine de en temizi Node.js'i nodejs.org üzerinden 22 veya üstüne yükseltmek.

node -v                                    # v22 veya üstü olmalı
npm install -g @anthropic-ai/claude-code   # sudo kullanmadan

# güncelleme: npm update -g değil, @latest
npm install -g @anthropic-ai/claude-code@latest

この方法では、次の3つの習慣が問題を引き起こします。

• sudoでインストールする。 ドキュメントでは、sudo npm install -gによる権限の問題とセキュリティリスクについて警告しています。
• npm update -gで更新する。 正しくはnpm install -g @anthropic-ai/claude-code@latestです。
• オプションの依存関係を無効にする。 実行可能ファイル本体は、プラットフォーム固有の@anthropic-ai/claude-code-*パッケージとしてオプションの依存関係でインストールされます。--omit=optionalフラグ、または.npmrc内のoptional=falseはこのパッケージをスキップします。インストールはエラーなく完了しますが、macOSとLinuxではclaudeの起動時にclaude native binary not installedと表示されます。

インストールは成功しましたか？

どの方法を選んだ場合でも、新しいターミナルを開き、次の2つのコマンドを実行してください。

claude --version   # sürüm numarasını yazar, ör. 2.1.211 (Claude Code)
claude doctor      # oturum açmadan kurulum ve ayar teşhisi

claude --versionでバージョン番号が表示されれば、プログラムは正しくインストールされています。claude doctorは、ログインせずにインストールの状態と設定ファイルの問題を一覧表示します。次の手順で問題が発生した場合、問題がインストールにあるのか設定にあるのかをここで切り分けられます。

サブスクリプションなしで: Claude CodeにAPIキーを設定する

claudeを初めて起動すると、認証情報を求められます。Claudeプランがある場合はログインして続行します。プランがない場合、または固定の月額料金ではなく使用量に応じて支払いたい場合は、APIキーでClaude Codeを実行します。2つの方法の違いは次のとおりです。

キーを使う方法は、Anthropicが想定している構成です。ANTHROPIC_BASE_URLはClaude Codeの組み込み変数であり、公式のゲートウェイドキュメントでも、この変数を使ってClaude Codeをプロキシまたはゲートウェイの背後で実行する方法を説明しています。プラグイン、パッチ、変更されたクライアントをインストールする必要はありません。macOSとLinuxでは、シェル設定ファイル（~/.zshrcまたは~/.bashrc）に6行を追加してください。

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # yalnızca alan adı, /v1 yok
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Windowsでは、設定を永続化する前に、1つのPowerShellセッションで試してください。ウィンドウを閉じると変数も消えます。

# Yalnızca bu PowerShell penceresinde geçerli – pencereyi kapatınca kaybolur
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

すべてのターミナルで有効にしたい場合は、同じ値をユーザー設定ファイルのenvブロックに記述します。ドキュメントによると、このファイルはすべてのプロジェクトに適用されます。Windowsでの場所は%USERPROFILE%\.claude\settings.jsonです。AIによる要約で見かける%APPDATA%\Claude\settings.jsonは、公式ドキュメントに記載されたパスではありません。ファイルがすでにある場合は、内容を削除せず、envブロックだけを追加してください。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

6つの変数と注意点

ANTHROPIC_AUTH_TOKENですか、それともANTHROPIC_API_KEYですか？ Kunavoのキーは両方のヘッダーを受け付けます。Authorization: Bearerとx-api-keyです。違いはClaude Codeの動作にあります。ANTHROPIC_AUTH_TOKENはBearerヘッダーに送られ、質問なしで動作します。ANTHROPIC_API_KEYはx-api-keyヘッダーに送られ、対話モードでは初回に確認を求めます。その質問に「いいえ」と答えると、キーは警告なしで無視されます。再び有効にするには、/config → Use custom API keyの順に進む必要があります。このガイドでANTHROPIC_AUTH_TOKENを使用する理由はこれです。

モデルを固定する理由 モデル設定ドキュメント göre (kontrol: 2026年10月3日) API ile çalışan Claude Code, hiçbir şey ayarlanmamışsa varsayılan model ve opus takma adı için Opus 5.5'i, sonnet takma adı için Sonnet 5.5'i ister; Anthropic yeni model çıkardıkça bu takma adlar da kayar. Kunavo 2026年10月3日 itibarıyla Sonnet 5.5'i sunmuyor, dolayısıyla sabitlenmemiş bir sonnet isteği 404 ile döner. Claude Opus 5.5 Kunavo'da çalışıyor, ama tarifesi ($2,80 / $14,00) Claude Sonnet 5 tarifesinden ($1,40 / $7,00) yüksek; sabitlemezseniz farkında olmadan daha pahalı modelle çalışırsınız. Yukarıdaki blokta ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 satırı bu yüzden var: /model sonnet, opusplan'ın yürütme aşaması ve model: sonnet olarak ayarlanmış alt ajanlar Sonnet 5.5 yerine Claude Sonnet 5 ile çalışır. opus takma adını ise Claude Opus 5.5 modeline (claude-opus-5-5) sabitliyoruz; bu model Claude Code v2.1.280 veya üstünü ister, eski bir sürümdeyseniz claude update çalıştırın.

Kunavoの料金（入力 / 出力、100万トークンあたり）: Claude Sonnet 5 $1,40 / $7,00 （Anthropicの料金：$2,00 / $10,00）; Claude Opus 5.5 $2,80 / $14,00; バックグラウンドジョブを担うClaude Haiku 4.5 $0,70 / $3,50。

キーを記述してはいけない場所と、優先される値

Projenin kendi .claude/settings.json dosyası anahtar için yanlış yer: ゲートウェイドキュメント bu dosyanın depoya commit edildiğini hatırlatıyor, yani anahtar depoyu klonlayan herkese gider. Aynı değişken hem kabukta hem ayar dosyasının env bloğunda tanımlıysa çoğu durumda ayar dosyasındaki geçerli olur; kabukta değiştirdiğiniz bir değer etki etmiyorsa önce oraya bakın. Ayar dosyasındaki model anahtarı bu kuralın dışında: ANTHROPIC_MODEL değişkeni ondan önce gelir, model yalnızca değişken yoksa kullanılır. VS Code eklentisinde değişkenler, VS Code kullanıcı ayarlarındaki claudeCode.environmentVariables alanına girer.

初回起動と/statusの確認

変数が正しい場所にあれば、claudeコマンドはログイン画面をまったく表示せずにセッションを開始します。ゲートウェイドキュメント（確認: 2026年10月3日）では、ANTHROPIC_AUTH_TOKENが設定されている場合の動作をこのように説明しています。ログイン画面が表示される場合、Claude Codeはキーを認識していません。よくある原因は、キーがプロジェクト設定にしか存在しないことです。対話モードでは、プロジェクトの.claude/settings.jsonまたは.claude/settings.local.jsonファイルにあるenvブロックは、初回実行ウィザードとフォルダーの信頼確認が完了した後に読み込まれます。キーは、ウィザードより前に読み込まれる場所に設定する必要があります。シェルのexport、ユーザーレベルの~/.claude/settings.json、または管理対象設定（managed settings）です。

セッションが開始されたら/statusと入力してください。次の2行で十分な情報が得られます。

• Anthropic base URL: カスタムアドレスが設定されている場合のみ表示され、https://api.kunavo.comとなっている必要があります。この行がまったく表示されない場合、ANTHROPIC_BASE_URLはセッションに到達していません。
• Auth token: その横にANTHROPIC_AUTH_TOKENの名前が表示されていれば、リクエストはAPIキーで送信されています。代わりにclaude.aiアカウントを示すLogin method行が表示される場合、Claude Codeはまだ保存済みのログイン情報を使用しています。ログアウトし、新しいターミナルを開き、変数をどこに記述したか確認してください。

Claude Codeを起動せずにテストする

アドレスとキーは、Claude Codeとは独立してテストすることもできます。公式ドキュメントの方法では、出力トークン1個のリクエストを送信します。残高からごく少額が差し引かれます。コマンドはその時点のシェルから変数を読み取るため、キーが設定ファイルにしかない場合は、まずこのターミナルでexportしてください。応答が{"id":"msg_で始まれば、アドレスとキーは有効です。401はキーが拒否されたことを示します。

curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

PowerShell版は下記のとおりです。成功すると、応答にmsg_で始まるidフィールドが含まれます。

Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

APIキーで何が変わりますか？

• Remote Controlと音声ディクテーションは利用できません。 ドキュメントによると、どちらもclaude.aiのIDを必要とし、ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、またはapiKeyHelperが有効な場合は動作しません。v2.1.196以降では、ANTHROPIC_BASE_URLがAnthropic以外のサーバーを指している場合もRemote Controlは無効になります。
• /fastは無効として表示されます。 ドキュメントによると、Bearerトークンのみが設定されている場合、Claude Codeは高速モード（fast mode）の状態を確認せず、無効として扱います。
• MCPツール検索はデフォルトで無効です。 MCPドキュメント (kontrol: 2026年10月3日) özel bir ANTHROPIC_BASE_URL ayarını, tool search kullanılmayan yapılandırmalar arasında sayıyor.
• /contextの数値は概算です。 Kunavo /v1/messages/count_tokens uç noktasını sunmuyor; bu durumda Claude Code, ゲートウェイ互換性ドキュメント göre (kontrol: 2026年10月3日) bağlam kullanımını karakter sayısından tahmin eder.

統合の技術的な詳細は英語のClaude Code統合ドキュメントにあります。このガイドに対応する英語版はInstall Claude Codeです。

トルコからの支払い: カード、Apple Pay、Google Pay、Link

Burada ödediğiniz şey bir abonelik değil, Claude Code'un token başına harcadığı ön ödemeli API bakiyesi. Anthropic'in sitesinden alınan Pro ve Max ise yalnızca kredi veya banka kartıyla ödenebiliyor (Claude有料プランに関するFAQ, kontrol: 2026年10月3日). Kunavo'ya yaptığınız yükleme bu planların yerine geçmez ve onları ödemez. Adımlar:

1. Kunavoに登録します。メールアドレスまたはGoogleアカウントがあれば十分で、登録時にカード情報は求められません。
2. Billingページで金額を選択します。最低額は10 USDで、サブスクリプションや月額料金はありません。高額なチャージにはボーナスが追加されます: 100 USD yükleyene 110 USD bakiye, 1.000 USD yükleyene 1.200 USD bakiye, 5.000 USD yükleyene 6.250 USD bakiye。
3. Stripeの決済ページが開きます。カード（Visa、Mastercard）、Apple Pay、Google Pay、またはLinkから選択してください。Apple PayとGoogle Payは、それらに対応しているデバイスとブラウザーでのみ表示されます。
4. 次にAPI Keysページで、sk-kn-から始まるキーを生成します。キーは一度しか表示されないため、コピーしてすぐにANTHROPIC_AUTH_TOKENの値に設定してください。

金額はトルコリラで表示されますか、それともドルですか？

Kunavo fiyatları dolar cinsinden; ödeme sayfasında hangi para biriminin gösterileceğine Stripe karar verir ve tutar TL olarak da çıkabilir. StripeのAdaptive Pricingドキュメント (kontrol: 2026年10月3日) Türkiye'yi desteklenen pazarlar arasında sayıyor ve bu çevrimde kura %2–4 arası, alıcının ödediği bir ücret eklendiğini yazıyor. Dolarla ödemeyi seçerseniz bu ücret olmaz; o zaman kartınızın bankası kendi döviz kurunu ve varsa yurt dışı işlem ücretini uygular. Para birimi hangisi olursa olsun, kesin tutarı onaylamadan önce ödeme sayfasında görürsünüz.

分割払い、Papara、銀行振込、Troy

• 分割払いはなく、一括払いのみです。 Türk kartlarıyla yurt dışı sitelerden yapılan harcamalar sonradan da taksite bölünemiyor (enuygunfinans.com, kontrol: 2026年10月3日).
• Papara、銀行振込/EFT、PayPalは利用できません。 決済ページにはこれらの選択肢は表示されません。
• Troy: Stripe'ın 対応カードブランド sayfasında Troy geçmiyor (kontrol: 2026年10月3日). Visa ya da Mastercard logolu bir kartla ödeyin.
• 請求書はありません。 Kunavoはe-Arşivを含め、いかなる請求書も発行しません。チャージの明細はBillingページに保存されます。

カードが拒否された場合は、まず銀行のモバイルアプリを確認してください。カードはオンラインショッピングと海外取引に対応している必要があります。自動チャージは登録済みのカードまたはLinkでのみ設定できます。残高に有効期限はなく、失敗したリクエストには料金が発生しません。すべてのモデルの料金はClaude APIの料金ガイドに記載されています。

1回の作業セッションにはいくらかかりますか？

キーを使う場合、コストは完全にトークン数に依存します。Claude Codeは各リクエストで会話のコンテキストを最初から送信します。コンテキストの変化しない先頭部分がキャッシュから読み込まれる場合は、はるかに低い料金で計算されます。以下の表は測定結果ではなく、明示した仮定に基づく計算です。上限として解釈すべきものでもありません。仮定:

• リクエストあたり40.000入力トークン。そのうち36.000（90%）はキャッシュから読み込まれ、残りの4.000はキャッシュに書き込まれる。
• リクエストあたり1.000出力トークン。
• セッションあたり50リクエスト。バックグラウンドでのClaude Haiku 4.5呼び出しは計算に含めていません。
• Claude Sonnet 5では、キャッシュからの読み込みは入力料金の%10、キャッシュへの書き込みは1,25倍です。表では、各モデルをそれぞれの料金で計算しています。

Gerçek tutarı bağlamın uzunluğu, önbellek isabeti, yanıtların uzunluğu ve konu değiştirirken sohbeti temizleyip temizlemediğiniz belirler. 公式のコストドキュメント (kontrol: 2026年10月3日) iki ayrıntı ekliyor: Claude Code siz bir şey yazmasanız da arka planda az miktarda token harcar, genellikle oturum başına 0,04 dolardan az; API anahtarında önbellek ömrü varsayılan olarak beş dakika, dolayısıyla daha uzun bir aradan sonraki ilk mesaj önbelleği ıskalar ve bağlamın tamamı yeniden işlenir. Konu değiştirirken /clear, uzun oturumlarda /compact bu maliyeti düşürür.

すべての料金は料金ページに掲載されています。自分の使用量は、Claudeトークンコスト計算ツール（英語）で見積もれます。サブスクリプションとAPIのどちらが適しているかについては、Claude Codeの料金ガイドで説明しています。

エラーメッセージと解決方法

知っておくべき制限

• Kunavoは請求書を発行しません。e-Arşivも利用できません。
• 一括払いのみです。分割払い、Papara、銀行振込/EFTは利用できません。自動チャージには登録済みのカードまたはLinkが必要です。
• これはClaude ProまたはMaxのサブスクリプションではなく、トークン単位で支払うAPIです。キーを使う場合、Remote Controlと音声ディクテーションは動作せず、/fastは無効として表示され、MCPツール検索はデフォルトで無効です。
• Kunavoは2026年10月3日時点ではSonnet 5.5を提供していません。モデルを固定しない場合、sonnetエイリアスは404を返します。
• Claude Codeの公式ドキュメントとKunavo統合ドキュメントは英語のみです（確認: 2026年10月3日）。

よくある質問