跳至主要內容
開發者資源
開發者資源

Claude Code

安裝 Claude Code，將其連接至 RunAPI，選擇模型，並驗證配置。

檢視 Markdown

概覽

Claude Code 是一款適用於終端的智能編碼工具。本指南 安裝 CLI，將其 Anthropic 相容請求指向 RunAPI， 選擇 RunAPI 模型並驗證連接。

開始之前

安裝

在 macOS、Linux 或 WSL 上使用官方原生安裝程式，然後確認 指令可正常使用：

SHELL 
curl -fsSL https://claude.ai/install.sh | bash
claude --version

如需 Homebrew、WinGet 及特定平台要求，請使用 官方安裝指南。

配置 RunAPI

首次測試時，請在當前 shell 中匯出 Base URL、API 金鑰及模型：

SHELL 
export ANTHROPIC_BASE_URL=https://runapi.ai
export ANTHROPIC_API_KEY=YOUR_RUNAPI_API_KEY
export ANTHROPIC_MODEL=YOUR_RUNAPI_MODEL_ID

若要將這些值套用至您用戶的每個 Claude Code 會話，請將其置於 ~/.claude/settings.json 中的 env 物件內：

JSON 
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://runapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID"
  }
}

請勿將真實金鑰存入 .claude/settings.json，該檔案用於可能被提交的專案設定。有關配置範圍及優先順序，請使用 Claude Code 設定參考。

選擇模型

將 YOUR_RUNAPI_MODEL_ID 替換為模型目錄中的確切識別符。ANTHROPIC_BASE_URL 用於變更請求的傳送目標，並不用於選擇模型。您亦可以 claude --model YOUR_RUNAPI_MODEL_ID 啟動單次對話，或在對話期間執行 /model。

驗證

執行安裝及配置檢查，然後傳送一個簡短提示：

SHELL 
claude --version
claude doctor
claude

在 Claude Code 內，執行 /status 以確認已載入的設定及使用中的模型。對 Describe this repository in one sentence. 的正常回應確認 RunAPI 連接正常運作。

疑難排解

  • 找不到 claude： 請重新開啟終端機並按照官方安裝疑難排解進行操作。
  • 設定未載入： 請使用 claude doctor 驗證 ~/.claude/settings.json，然後使用 /status 檢查已載入的來源。
  • 身份驗證失敗： 請確認 ANTHROPIC_API_KEY 包含一個有效的 RunAPI 金鑰。請透過身份驗證指南建立或輪換金鑰。
  • 模型不可用： 請從模型目錄複製確切的識別碼，然後開始新的會話。已恢復的會話可能保留其先前的模型。
  • 請求使用了另一個端點： 請在更改環境變數後開啟新的終端機，並檢查是否存在優先級更高的 Claude Code 設定。

後續步驟

使用 LLM API 快速入門 了解協定行為，使用 Anthropic Messages API 參考 查看請求欄位。若要將 RunAPI 工具新增至 Claude Code，請繼續參閱 MCP 概覽。