> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用 Claude Code 搭配 CometAPI

> 使用本指南透過 Anthropic 相容的憑證、base URL 設定與 Claude model ID，將 Claude Code 設定為使用 CometAPI。

使用本指南將 [Claude Code](https://code.claude.com/docs/en/overview) 連接到 CometAPI。

官方參考資料：

* [Claude Code Overview](https://code.claude.com/docs/en/overview)
* [Claude Code Getting Started](https://code.claude.com/docs/en/getting-started)

<Note>
  model 可用性會隨時間變動。目前的 Claude model ID，請查看
  [CometAPI Models page](/zh-Hant/overview/models)。
</Note>

## 先決條件

* 從你的 [dashboard](https://www.cometapi.com) 取得的 CometAPI 金鑰（以 `sk-` 開頭）
* 已安裝 Git
* 支援的作業系統：macOS、Linux 或 Windows

## 安裝 Claude Code

<Steps>
  <Step title="執行官方安裝程式">
    <Tabs>
      <Tab title="macOS / Linux">
        ```bash theme={null}
        curl -fsSL https://claude.ai/install.sh | bash
        ```
      </Tab>

      <Tab title="Homebrew">
        ```bash theme={null}
        brew install --cask claude-code
        ```
      </Tab>

      <Tab title="Windows">
        PowerShell:

        ```powershell theme={null}
        irm https://claude.ai/install.ps1 | iex
        ```

        CMD:

        ```batch theme={null}
        curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
        ```

        <Info>Windows 需要先安裝 [Git for Windows](https://git-scm.com/downloads/win)。</Info>
      </Tab>
    </Tabs>
  </Step>

  <Step title="驗證安裝">
    ```bash theme={null}
    claude --version
    ```
  </Step>
</Steps>

## 設定 CometAPI 端點

建立或編輯設定檔：

* macOS / Linux：`~/.claude/settings.json`
* Windows：`%USERPROFILE%\.claude\settings.json`

```json theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-cometapi-key",
    "ANTHROPIC_BASE_URL": "https://api.cometapi.com"
  }
}
```

將 `sk-your-cometapi-key` 替換為你實際的 CometAPI 金鑰，然後啟動 Claude Code：

```bash theme={null}
cd your-project
claude
```

## 疑難排解

<AccordionGroup>
  <Accordion title="settings.json 未生效">
    1. 完全重新啟動你的終端機：關閉所有視窗後再重新開啟。
    2. 如果仍然無法運作，請建立 `~/.claude.json` 並加入：

    ```json theme={null}
    {
      "hasCompletedOnboarding": true
    }
    ```

    3. 作為備用方案，直接匯出環境變數：

    ```bash theme={null}
    # Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
    export ANTHROPIC_AUTH_TOKEN="sk-your-cometapi-key"
    export ANTHROPIC_BASE_URL="https://api.cometapi.com"
    ```
  </Accordion>

  <Accordion title="Invalid API Key 或 Please run /login">
    請檢查 `~/.claude/settings.json` 是否存在，且 JSON 格式有效，沒有尾隨逗號，並使用正確的引號。可於 [jsonlint.com](https://jsonlint.com) 驗證。
  </Accordion>

  <Accordion title="使用了快取的官方憑證">
    Claude Code 會優先使用已快取的官方憑證。請在 Claude Code 內執行 `/logout`，將其關閉後再重新啟動。

    如果仍然失敗，請移除快取的驗證檔案：

    ```bash theme={null}
    rm -rf ~/.config/claude-code/auth.json
    ```
  </Accordion>

  <Accordion title="狀態顯示為 offline">
    Claude Code 會透過 Google 檢查連線狀態。`offline` 表示無法連上 Google。這不影響 CometAPI 的使用。
  </Accordion>

  <Accordion title="Fetch 或網頁瀏覽失敗">
    Claude Code 的 Fetch 功能會先呼叫 Anthropic 的原生服務，而這需要可直接存取網際網路。你可能需要設定系統層級的代理。
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/claude-code#howto",
        "name": "使用 Claude Code 搭配 CometAPI",
        "description": "使用本指南透過相容 Anthropic 的憑證、base URL 設定和 Claude model ID 來設定 Claude Code 與 CometAPI。",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-1",
            "position": 1,
            "name": "檢查先決條件",
            "text": "完成「使用 Claude Code 搭配 CometAPI」指南中的「檢查先決條件」步驟。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-2",
            "position": 2,
            "name": "安裝 Claude Code",
            "text": "完成「使用 Claude Code 搭配 CometAPI」指南中的「安裝 Claude Code」步驟。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-3",
            "position": 3,
            "name": "設定 CometAPI 端點",
            "text": "完成「使用 Claude Code 搭配 CometAPI」指南中的「設定 CometAPI 端點」步驟。"
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI 文件",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "整合",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "使用 Claude Code 搭配 CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/claude-code"
          }
        ]
      }
    ]
    }
    `}
</script>