# Claude Code 串接指南

## 使用前提與開放範圍

先依官方說明安裝 Claude Code，執行 claude --version 確認版本。本頁設定 CLI，並非 Claude Desktop。需要本站金鑰、可用餘額，以及已驗證 Anthropic Messages、串流與工具呼叫的 Claude 模型。影片模型或僅支援 OpenAI 協定的文字模型無法替代。以下為預留串接範本，不代表所有 Claude Code 功能已實測通過。

## 在目前終端設定

在本機替換兩個佔位符。ANTHROPIC_BASE_URL 填根位址，不加 /v1；ANTHROPIC_AUTH_TOKEN 將本站金鑰作為 Bearer token 傳送。測試前排除其他閘道環境變數或舊設定的干擾。

```bash
export ANTHROPIC_BASE_URL="https://u9ai.ai"
export ANTHROPIC_AUTH_TOKEN="YOUR_U9AI_API_KEY"
export ANTHROPIC_MODEL="YOUR_CLAUDE_MODEL_ID"
claude --model "$ANTHROPIC_MODEL"
```

```powershell
$env:ANTHROPIC_BASE_URL = "https://u9ai.ai"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_U9AI_API_KEY"
$env:ANTHROPIC_MODEL = "YOUR_CLAUDE_MODEL_ID"
claude --model $env:ANTHROPIC_MODEL
```
## 設定後驗收

在 Claude Code 執行 /status，確認目前閘道與模型。先發送短問題，再於臨時目錄驗證一次檔案讀取及完整工具呼叫往返。僅通過 /models 查詢不能證明這些功能正常。小額測試同樣可能扣款。

## 長期設定與專案檔案

終端驗證成功後，可將非敏感的位址與模型設定合併到現有使用者設定。金鑰應以本機私密設定或金鑰管理工具保存，請勿提交到 .claude/settings.json 或 CLAUDE.md。環境變數僅在目前終端工作階段生效。CLAUDE.md 提供專案指示，不能代替驗證或自動完成閘道設定。

## 下載與官方參考

下載[完整串接 MD](/zh-TW/docs/claude-code.md)或 [CLAUDE.md 專案指示範本](/zh-TW/docs/CLAUDE.md)，與既有規則合併，請勿覆寫原檔。

[官方閘道設定](https://code.claude.com/docs/en/llm-gateway-connect) · [官方相容範圍](https://code.claude.com/docs/en/llm-gateway)。Token 計數、提示詞快取與背景模型仍須依實際供應商逐項驗證。