簡短回答:Claude Code 只需在終端機中執行一行適用的命令即可安裝。在 macOS、Linux 和 WSL 上執行 install.sh,在 Windows PowerShell 中執行 irm … | iex,在命令提示字元(CMD)中執行 install.cmd;三者如下所示。此方法不需要 Node.js;若要使用 npm 安裝,則需要 Node.js 22 或更新版本。安裝後有兩種選擇:使用 Claude 帳戶登入(Pro、Max、Team、Enterprise 或 Console;免費方案不包含 Claude Code),或不訂閱而使用 API 金鑰。在金鑰方式中,您需要設定 ANTHROPIC_BASE_URL=https://api.kunavo.com(結尾不要加上 /v1)、ANTHROPIC_AUTH_TOKEN 以及固定模型的四個變數;工作階段中的 /status 會顯示金鑰是否已啟用。只會對實際使用的 Token 收費。您可以使用 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.cmdBu satırları ve aşağıdaki değişken adlarını Claude Code'un 安裝 ve Gateway 連線 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,我們會在下一節說明如何辨識終端機。
| 您的環境 | 應使用的方式 | 更新 |
|---|---|---|
| macOS、Linux、Windows 上的 WSL | install.sh 行(原生安裝,建議) | 在背景自動進行 |
| Windows PowerShell | irm https://claude.ai/install.ps1 | iex | 在背景自動進行 |
| Windows 命令提示字元(CMD) | install.cmd 行 | 在背景自動進行 |
| Homebrew(macOS)或 WinGet(Windows) | 套件管理器(如下) | 預設不會自動更新;請透過套件管理器自行更新 |
| 已安裝 Node.js 22 或更新版本 | npm(如下) | 使用 npm install -g @anthropic-ai/claude-code@latest |
系統需求
官方安裝文件要求的條件(截至 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。
- Shell: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 列為最低版本。「沒有美國出口的固定 Proxy,每一步都會出錯」的警告也不適用於土耳其;相反地,啟用的 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)。如果在 PowerShell 中嘗試 macOS 的 curl … | bash 行,會看到 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 有兩個原因:需要 Linux 工具,或希望在沙箱中執行命令。在原生 Windows 安裝中沒有沙箱:
| 安裝 | 前提 | 沙箱 | 適用對象 |
|---|---|---|---|
| 原生 Windows | 無(Git for Windows 為選用) | 不支援 | 專案和工具都在 Windows 上的人 |
| WSL 2 | 啟用 WSL 2 | 支援 | 希望使用 Linux 工具或在沙箱中工作的人 |
| WSL 1 | 啟用 WSL 1 | 不支援 | 無法使用 WSL 2 的人 |
如果要在 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 啟動程式,而系統的指令碼執行原則會封鎖它。文件提供三種解決方式:使用 npm.cmd 和 claude.cmd 名稱執行命令、在 PowerShell 中改用原生安裝程式,或只允許目前使用者執行本機指令碼:
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此方式有三個習慣會造成問題:
- 使用
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。
安裝成功了嗎?
無論選擇哪種方式,請開啟新的終端機,並執行以下兩個命令:
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。兩種方式的差異:
| 項目 | 使用 Claude 帳戶登入 | Kunavo API 金鑰 |
|---|---|---|
| 需求 | Pro、Max、Team、Enterprise 或 Console 帳戶。免費 Claude.ai 方案不適用。 | sk-kn-… 金鑰和幾個環境變數。不需要訂閱或登入。 |
| 費用 | Pro aylık 20 dolar; yıllık alınırsa aylık 17 dolar, yani peşin 200 dolar. Max aylık 100 dolardan başlıyor. Vergi hariç (Claude 價格頁面, kontrol: 2026年10月3日). | 依使用的 Token 計費,從預付餘額扣除。最低 10 USD;無月費,餘額永久有效。 |
| 付款方式 | Sitesinden alınan planlar yalnızca kredi veya banka kartıyla (Claude 付費方案常見問題, kontrol: 2026年10月3日). | 信用卡(Visa、Mastercard)、Apple Pay、Google Pay、Link。不提供分期付款、Papara 或銀行轉帳/EFT。 |
| 無法使用的功能 | — | Remote Control 和語音聽寫。不開立發票(包括 e-Arşiv)。 |
金鑰方式是 Anthropic 預期的設定方式:ANTHROPIC_BASE_URL 是 Claude Code 的內建變數,官方 Gateway 文件也使用此變數說明如何在 Proxy 或 Gateway 後方執行 Claude Code。您不需要安裝外掛、套用修補程式或使用修改過的用戶端。在 macOS 和 Linux 上,請將以下六行加入 shell 設定檔(~/.zshrc 或 ~/.bashrc):
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 上永久儲存設定前,請先在單一 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"
}
}六個變數與注意事項
| 變數 | 用途 | 注意 |
|---|---|---|
ANTHROPIC_BASE_URL | 要求要傳送至的伺服器 | 僅使用 https://api.kunavo.com。Claude Code 會自行加入 /v1/messages 路徑;若結尾再寫入 /v1,要求就會傳送至 /v1/v1/messages 位址並收到 404。 |
ANTHROPIC_AUTH_TOKEN | 以 sk-kn- 開頭的金鑰 | 會以 Authorization: Bearer 標頭傳送,並立即生效(詳情如下)。 |
ANTHROPIC_MODEL | 主要模型 | 此處的 Claude Sonnet 5 即為 claude-sonnet-5。名稱必須與 Kunavo 模型清單中的名稱完全一致。 |
ANTHROPIC_DEFAULT_OPUS_MODEL | opus 別名所對應的模型 | claude-opus-5-5,也就是 Claude Opus 5.5。此模型需要 Claude Code v2.1.280 或更新版本;若您使用的是舊版本,請執行 claude update。若未設定,該別名會改用 Anthropic 最新的 Opus 模型。 |
ANTHROPIC_DEFAULT_SONNET_MODEL | sonnet 別名所對應的模型 | claude-sonnet-5。若未設定,該別名會要求 Kunavo 未提供的 Sonnet 5.5;/model sonnet、opusplan 的執行階段以及 model: sonnet 子代理程式會收到 404。 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | haiku 別名與背景工作 | claude-haiku-4-5。根據文件,背景功能也會使用此模型執行。 |
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 萬個 token):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: gateway 文件 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 指令會在完全不顯示登入畫面的情況下開啟工作階段;gateway 文件(檢查:2026年10月3日)描述了在設定 ANTHROPIC_AUTH_TOKEN 時的此種行為。如果您看到登入畫面,表示 Claude Code 沒有偵測到金鑰。常見原因是金鑰只存在於專案設定中:在互動模式下,專案的 .claude/settings.json 或 .claude/settings.local.json 檔案中的 env 區塊,會在初次執行精靈及通過資料夾信任提示後才讀取。金鑰必須位於精靈之前就會讀取的位置:Shell 中的 export、使用者層級的 ~/.claude/settings.json,或受管理的設定(managed settings)。
登入後輸入 /status。兩行就能提供足夠資訊:
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 測試位址與金鑰。官方文件的方法是傳送一個輸出 token 的要求;這會從餘額中扣除非常小的金額。指令會從目前的 Shell 讀取變數;若金鑰只存在於設定檔中,請先在此終端機中執行 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 身分,且在啟用
ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN或apiKeyHelper時無法運作。自 v2.1.196 起,當ANTHROPIC_BASE_URL指向 Anthropic 以外的伺服器時,Remote Control 也會停用。 /fast會顯示為關閉。 根據文件,僅設定 bearer token 時,Claude Code 不會詢問快速模式(fast mode)的狀態,並預設為關閉。- MCP 工具搜尋預設為停用。 MCP 文件 (kontrol: 2026年10月3日) özel bir
ANTHROPIC_BASE_URLayarını, tool search kullanılmayan yapılandırmalar arasında sayıyor. /context數字為約略值。 Kunavo/v1/messages/count_tokensuç noktasını sunmuyor; bu durumda Claude Code, gateway 相容性文件 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 付費方案常見問題, kontrol: 2026年10月3日). Kunavo'ya yaptığınız yükleme bu planların yerine geçmez ve onları ödemez. Adımlar:
- 註冊 Kunavo。只需電子郵件地址或 Google 帳戶;註冊時不會要求卡片資訊。
- 在 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。
- Stripe 付款頁面會開啟。請選擇信用卡(Visa、Mastercard)、Apple Pay、Google Pay 或 Link;Apple Pay 與 Google Pay 只有在支援這些服務的裝置與瀏覽器上才會列出。
- 接著在 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 不會開立任何發票,包括電子發票;您的儲值明細會保留在 Billing 頁面。
如果卡片遭拒,請先查看您銀行的行動應用程式:卡片必須開放網路購物與國際交易。只有使用已儲存的卡片或 Link 才能設定自動儲值。餘額沒有到期日,失敗的要求不會收費。所有模型的費率請參閱 Claude API 價格 指南。
一次工作階段需要多少費用?
使用金鑰時,費用完全取決於 token 數量。Claude Code 會在每次要求中重新傳送對話內容;但若內容中不變的開頭部分從快取讀取,則會按低得多的費率計算。下表不是實測結果,而是基於明確假設的計算;也不應視為上限。假設如下:
- 每次要求 40.000 個輸入 token;其中 36.000(%90)從快取讀取,其餘 4.000 寫入快取;
- 每次要求 1.000 個輸出 token;
- 每個工作階段 50 次要求;未計入背景中的 Claude Haiku 4.5 呼叫;
- 對於 Claude Sonnet 5,從快取讀取的費率是輸入費率的 %10,寫入快取則是 1,25 倍。表中的每個模型都使用自身的費率計算。
| 模型 | 一次要求 | 50 次要求 | 50 次要求,沒有快取命中 |
|---|---|---|---|
| Claude Sonnet 5 | $0,019 | $0,95 | $3,15 |
| Claude Opus 5.5 | $0,033 | $1,65 | $6,30 |
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 token 費用計算器(英文)估算自己的用量。Claude Code 價格指南會說明訂閱方案是否比 API 更合適。
錯誤訊息與解決方法
| 訊息 | 原因與解決方法 |
|---|---|
The token '&&' is not a valid statement separator | 您已將 CMD 指令列貼到 PowerShell。請使用 irm … | iex 指令列。 |
「'irm' 無法辨識為內部或外部命令、可執行程式或批次檔。」(英文:'irm' is not recognized as an internal or external command) | 您已將 PowerShell 指令列貼到 CMD。請使用 install.cmd 指令列。 |
A parameter cannot be found that matches parameter name 'fsSL', 'bash' is not recognized as the name of a cmdlet | 您已在 Windows 上執行 macOS/Linux 指令。請使用 PowerShell 指令列。 |
syntax error near unexpected token '<', 403, App unavailable in region | 安裝程式位址回傳了 HTML 頁面或錯誤碼。請檢查 VPN、Proxy 與防火牆;土耳其在支援的國家/地區之列。 |
command not found: claude, 'claude' is not recognized | 安裝資料夾不在 PATH 中。請開啟新的終端機;在 Windows 中,使用上方的 PowerShell 指令加入路徑。 |
EBADENGINE 警告 | Node.js 版本早於 22。安裝不會停止,但建議您更新 Node.js。 |
claude native binary not installed(macOS、Linux) | npm 略過了選用相依項目(--omit=optional 或 optional=false)或安裝指令碼(--ignore-scripts)。請移除這些設定後重新安裝。 |
npm.ps1 cannot be loaded | PowerShell 執行原則阻止 npm 指令碼執行。請執行 Set-ExecutionPolicy 指令,或使用原生安裝程式。 |
Claude Code does not support 32-bit Windows | PowerShell (x86) 已開啟。請開啟一般的「Windows PowerShell」。 |
| 已設定金鑰,但仍出現登入畫面 | Claude Code 沒有讀取金鑰。請將變數寫入 Shell 或 ~/.claude/settings.json 檔案,而不只是專案設定,並開啟新的終端機。 |
401 | 金鑰遭拒。請確認 sk-kn- 金鑰已完整且不含空格地複製、未在 /app/keys 頁面中刪除,且位於 ANTHROPIC_AUTH_TOKEN 中。 |
404 | ANTHROPIC_BASE_URL 以 /v1 結尾,或 Kunavo 沒有要求的模型;例如,固定模型的四個變數尚未設定,而 sonnet 別名要求 Sonnet 5.5。 |
您需要知道的限制
- Kunavo 不會開立發票;也不提供電子發票。
- 付款一次付清:不提供分期付款、Papara 與銀行轉帳/EFT。自動儲值需要已儲存的卡片或 Link。
- 這不是 Claude Pro 或 Max 訂閱,而是按 token 付費的 API。使用金鑰時,Remote Control 與語音聽寫無法使用,
/fast會顯示為關閉,MCP 工具搜尋預設為停用。 - 截至 2026年10月3日,Kunavo 不提供 Sonnet 5.5;若未固定模型,
sonnet別名會回傳 404。 - Claude Code 的官方文件與 Kunavo 整合文件 僅提供英文版本(檢查:2026年10月3日)。
常見問題
如何安裝 Claude Code?
最簡單的方法是 Anthropic 在文件中建議的原生安裝程式。在 macOS、Linux 和 WSL 上執行 curl -fsSL https://claude.ai/install.sh | bash。在 Windows 上,請在 PowerShell 使用 irm https://claude.ai/install.ps1 | iex;在命令提示字元(CMD)中使用 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd。接著開啟新的終端機,使用 claude --version 檢查安裝。原生安裝會在背景自動更新。如果要使用 npm 安裝,則需要 Node.js 22 或更新版本;不要使用 sudo,請使用 npm install -g @anthropic-ai/claude-code@latest 進行更新。
如何在 Windows 上安裝 Claude Code?需要以管理員身分執行嗎?WSL 和 Git 是必要的嗎?
不需要管理員權限;官方文件明確如此說明。WSL 和 Git 也不是必要條件:只要在一般終端機中執行適用於 PowerShell 或 CMD 的安裝行即可。Git for Windows 為選用但建議安裝;如果已安裝,Claude Code 會使用 Git Bash 執行命令,否則會使用 PowerShell。如果需要 Linux 工具或在沙箱中執行命令,請選擇 WSL 2;此時請在 WSL 終端機中安裝 Claude Code,並在該處啟動。開始功能表中的「Windows PowerShell (x86)」是 32 位元程序,即使在 64 位元電腦上也會顯示 32 位元 Windows 錯誤,請勿開啟。
Claude Code 免費嗎?可以不訂閱使用嗎?
免費的 Claude.ai 方案不包含 Claude Code;使用 Claude 帳戶登入需要 Pro、Max、Team、Enterprise 或 Console 帳戶。不訂閱也可以使用:設定 ANTHROPIC_BASE_URL=https://api.kunavo.com 和以 API 金鑰設定的 ANTHROPIC_AUTH_TOKEN 後,Claude Code 會不顯示登入畫面直接啟動,並從 Kunavo 的預付餘額支付所使用的 Token。沒有月費。在此模式中,Remote Control 和語音聽寫無法使用,因為兩者都需要 claude.ai 身分。
Claude Code 的 API 金鑰要在哪裡輸入?ANTHROPIC_BASE_URL 必須以 /v1 結尾嗎?AUTH_TOKEN 還是 API_KEY?
結尾不應包含 /v1。Claude Code 會自行附加 /v1/messages 路徑;如果位址以 /v1 結尾,請求會前往 /v1/v1/messages 並回傳 404。請將變數寫入 shell 設定檔(~/.zshrc、~/.bashrc 或 PowerShell 中的 $PROFILE),或使用者設定檔 ~/.claude/settings.json 的 env 區塊;Windows 上的路徑是 %USERPROFILE%\.claude\settings.json,不是 %APPDATA%。絕對不要寫入專案的 .claude/settings.json,因為該檔案會提交至儲存庫。Kunavo 會從 Authorization: Bearer 和 x-api-key 標頭讀取金鑰,因此兩個變數都可使用。我們建議使用 ANTHROPIC_AUTH_TOKEN,因為會立即生效;ANTHROPIC_API_KEY 在互動模式中會要求一次確認,若遭拒絕則會靜默忽略(若要重新啟用,請前往 /config → Use custom API key)。
為什麼要設定 ANTHROPIC_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL 和 ANTHROPIC_DEFAULT_SONNET_MODEL?
如果不設定,Claude Code 會使用隨 Anthropic 新模型推出而變動的別名。根據官方模型設定文件(檢查日期:2026年10月3日),API 使用者的預設模型和 opus 別名指向 Opus 5.5,sonnet 別名指向 Sonnet 5.5。Kunavo 目前(截至 2026年10月3日)不提供 Sonnet 5.5,因此 sonnet 請求會回傳 404:/model sonnet、opusplan 的執行階段,以及設定為 model: sonnet 的子代理都無法運作。預設的 Opus 5.5 可以運作,但比 Claude Sonnet 5 模型昂貴。固定設定後,主模型和 sonnet 別名會是 claude-sonnet-5,opus 別名會是 claude-opus-5-5,haiku 別名和背景工作會是 claude-haiku-4-5;您會清楚知道是哪個模型回應,以及依哪個費率計費。Opus 5.5 需要 Claude Code v2.1.280 或更新版本;如果版本較舊,請執行 claude update。
如何使用 /status 檢查 Claude Code 是否使用 API 金鑰?
在 Claude Code 工作階段中輸入 /status。「Anthropic base URL」行應顯示 https://api.kunavo.com,「Auth token」行應顯示 ANTHROPIC_AUTH_TOKEN 名稱。如果看到的是 claude.ai 帳戶的「Login method」行,表示變數未被讀取:請結束工作階段、開啟新的終端機,並檢查您將變數寫入的位置。
如何從土耳其付款?價格以土耳其里拉還是美元計算?
Stripe 付款頁面提供卡片(Visa、Mastercard)、Apple Pay、Google Pay 和 Link。價格以美元計算;Stripe 可能會以里拉顯示金額,此時匯率已包含買方支付的 2–4% 換匯費。若選擇以美元付款,則不會產生此費用,但銀行本身的匯率和費用仍適用。最低儲值 10 USD,沒有月費,餘額不會過期。自動儲值僅能透過已儲存的卡片或 Link 使用。Kunavo 不開立發票(包括 e-Arşiv);儲值記錄會顯示在 Billing 頁面。
可以使用分期付款、Papara、銀行轉帳/EFT 或 Troy 卡付款嗎?這筆付款可以支付 Claude Pro 嗎?
不可以。Kunavo 不提供分期付款,也不支援 Papara、銀行轉帳/EFT 或 PayPal。Troy 不在 Stripe 文件列出的卡片品牌中;請使用帶有 Visa 或 Mastercard 標誌的卡片。如果卡片遭拒,請從銀行應用程式確認是否允許網路購物和國際交易。這筆儲值只會用於 Kunavo API 餘額,不會支付 Claude Pro 或 Max 訂閱。從 Anthropic 網站購買的訂閱則只能使用信用卡或簽帳金融卡付款。