> ## 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.

# CometAPI で Claude Code を使う

> このガイドでは、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>
  利用可能なモデルは時間とともに変化します。現在の Claude model ID については、
  [CometAPI Models page](/ja/overview/models) を確認してください。
</Note>

## 前提条件

* [dashboard](https://www.cometapi.com) で取得した CometAPI キー（`sk-` で始まります）
* Git がインストールされていること
* 対応 OS: 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. 代替手段として、環境変数を直接 export してください:

    ```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 または Web ブラウジングが失敗する">
    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": "CometAPI で Claude Code を使う",
        "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": "CometAPI で Claude Code を使うガイドの「前提条件を確認する」手順を完了してください。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-2",
            "position": 2,
            "name": "Claude Code をインストールする",
            "text": "CometAPI で Claude Code を使うガイドの「Claude Code をインストールする」手順を完了してください。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-code#step-3",
            "position": 3,
            "name": "CometAPI エンドポイントを設定する",
            "text": "CometAPI で Claude Code を使うガイドの「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": "CometAPI で Claude Code を使う",
            "item": "https://apidoc.cometapi.com/integrations/claude-code"
          }
        ]
      }
    ]
    }
    `}
</script>