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

# Claude Code

> このガイドでは、Harogoを使ったClaude Codeを数分で使い始める方法を説明します。

> [!NOTE]
>
> **このガイドは Claude シリーズのみを対象としています。** Claude Code では Claude シリーズ（Claude Opus 5.5、Claude Sonnet 5.5、Claude Sonnet 5、Claude Fable 5.1、Claude Haiku 5.5）と、制限のないモデル（GLM、Qwen、Kimi、MiniMax、DeepSeek）を利用できます。GPT シリーズは Claude Code では利用できません。[Codex](https://docs.harogo.ai/ja/codex.md) をご覧ください。

### 1. Claude Codeをインストールする

#### ローカルインストール

```shellscript macOS theme={null}
curl -fsSL https://claude.ai/install.sh | bash
```

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

#### npmでインストールする

[Node.js 18以降](https://nodejs.org/en/download/)が必要です

```shellscript theme={null}
npm install -g @anthropic-ai/claude-code
```

### 2. Harogo APIを設定する

Anthropic互換APIを通じてHarogoのモデルサービスに接続するには、次の環境変数を設定します。

1. `ANTHROPIC_BASE_URL`を`https://api.harogo.ai/`に設定します
2. `ANTHROPIC_AUTH_TOKEN`を[Harogoプラットフォーム](https://console.harogo.ai/keys)で取得したAPIキーに設定します
3. `ANTHROPIC_MODEL`をHarogoが対応しているClaudeモデル（例：`claude-sonnet-5`）に設定します。

> [tab] macOS
>
> 1. ターミナルで次のコマンドを実行し、デフォルトのシェルを確認します。
>
> ```shellscript theme={null}
> echo $SHELL
> ```
>
> 2. シェルの種類に応じて環境変数を設定します。
>
> ```shellscript Zsh theme={null}
> # <HAROGO_API_KEY> をHarogoプラットフォームで取得した実際のキーに置き換えてください
> echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.zshrc
> echo 'export ANTHROPIC_AUTH_TOKEN="<HAROGO_API_KEY>"' >> ~/.zshrc
> echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.zshrc
> ```
>
> ```shellscript Bash theme={null}
> # <HAROGO_API_KEY> をHarogoプラットフォームで取得した実際のキーに置き換えてください
> echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.bash_profile
> echo 'export ANTHROPIC_AUTH_TOKEN="<HAROGO_API_KEY>"' >> ~/.bash_profile
> echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.bash_profile
> ```
>
> 3. ターミナルで次のコマンドを実行し、環境変数を反映させます。
>
> ```shellscript Zsh theme={null}
> source ~/.zshrc
> ```
>
> ```shellscript Bash theme={null}
> source ~/.bash_profile
> ```
>
> 4. 新しいターミナルを開き、次のコマンドを実行して環境変数が反映されていることを確認します。
>
> ```shellscript theme={null}
> echo $ANTHROPIC_BASE_URL
> test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
> echo $ANTHROPIC_MODEL
> ```

> [tab] Windows
>
> Windowsでは、CMDまたはPowerShellを使って、HarogoのBase URLと[APIキー](https://console.harogo.ai/keys)を環境変数として設定できます。
>
> > [tab] CMD
> >
> > 1. CMDで次のコマンドを実行し、環境変数を設定します。
> >
> > ```shellscript theme={null}
> > REM <HAROGO_API_KEY> をHarogoプラットフォームで取得した実際のキーに置き換えてください
> > setx ANTHROPIC_AUTH_TOKEN "<HAROGO_API_KEY>"
> > setx ANTHROPIC_BASE_URL "https://api.harogo.ai"
> > setx ANTHROPIC_MODEL "claude-sonnet-5"
> > ```
> >
> > 2. 新しいCMDウィンドウを開き、次のコマンドを実行して環境変数が反映されていることを確認します。
> >
> > ```shellscript theme={null}
> > if defined ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set
> > echo %ANTHROPIC_BASE_URL%
> > echo %ANTHROPIC_MODEL%
> > ```
>
> > [tab] PowerShell
> >
> > 1. PowerShellで次のコマンドを実行し、環境変数を設定します。
> >
> > ```shellscript theme={null}
> > # <HAROGO_API_KEY> をHarogoプラットフォームで取得した実際のキーに置き換えてください
> > [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<HAROGO_API_KEY>", [EnvironmentVariableTarget]::User)
> > [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.harogo.ai", [EnvironmentVariableTarget]::User)
> > [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5", [EnvironmentVariableTarget]::User)
> > ```
> >
> > 2. 新しいPowerShellウィンドウを開き、次のコマンドを実行して環境変数が反映されていることを確認します。
> >
> > ```shellscript theme={null}
> > if ($env:ANTHROPIC_AUTH_TOKEN) { "ANTHROPIC_AUTH_TOKEN is set" }
> > echo $env:ANTHROPIC_BASE_URL
> > echo $env:ANTHROPIC_MODEL
> > ```

> [!NOTE]
>
> CC SwitchでClaude Codeを管理する場合は、グローバルな`ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_MODEL`を別途設定しないことをおすすめします。システムレベルまたはユーザーレベルの環境変数がCC Switchの書き込んだプロバイダー設定を上書きすることがあり、画面上では正しいプロバイダーが選択されているのに、Claude Codeは実際には古いキーやモデルで動作し続ける、という状態になります。

### 3. 設定を確認する

環境変数またはCC Switchの設定が終わったら、長いセッションを始める前に、まず最小限のリクエストを1回送信して、キー、モデル、Anthropic互換エンドポイントがすべて正常に動作することを確認してください。

```bash macOS/Linux theme={null}
curl https://api.harogo.ai/v1/messages \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "1+1, output only the answer"}]
  }'
```

```powershell Windows theme={null}
curl.exe https://api.harogo.ai/v1/messages `
  -H "content-type: application/json" `
  -H "anthropic-version: 2023-06-01" `
  -H "x-api-key: $env:ANTHROPIC_AUTH_TOKEN" `
  -d "{\"model\":\"claude-sonnet-5\",\"max_tokens\":16,\"messages\":[{\"role\":\"user\",\"content\":\"1+1, output only the answer\"}]}"
```

### 4. Claude Codeを使い始める

設定が完了したら、作業ディレクトリに移動し、ターミナルで`claude`コマンドを実行して使い始めます。

```bash theme={null}
$ cd /path/your-project
> claude
```

起動時に`Not logged in · Please run /login`と表示される場合や、Anthropicのログインフローに進んでしまう場合は、通常、Claude Codeが有効なHarogo設定を読み込めていないか、初回のオンボーディングが完了していないことが原因です。まず前のステップの最小リクエストが`2`を返すことを確認し、`ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_MODEL`が古いグローバル環境変数で上書きされていないか確認してください。キーが有効であることを確認したうえで、それでもログインフローに進んでしまう場合は、次の手順で初回のオンボーディングをスキップできます。

![Claude Codeの初回起動時にログインするか続行するかを尋ねるターミナル画面](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/cc-7.avif?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=80bd9b41f8af28fa7679659117d6266c)

1. ホームディレクトリにある`.claude.json`ファイルを探します。
   * macOS / Linux: `~/.claude.json`
   * Windows: `C:\Users\%USERNAME%\.claude.json`
2. `hasCompletedOnboarding`フィールドを`true`に設定します

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

3. ファイルを保存し、ターミナルで`claude`を再度実行します。

#### （任意）モデルを設定するその他の方法

Claude Codeでは次の方法でモデルを設定できます。**優先度の高い順に並べており**、優先度の高い設定が低い設定を上書きします。

1. **会話中：** `/model <model-name>`コマンドを実行してモデルを切り替えます。一時的に切り替えたい場合に便利です。

```text theme={null}
/model claude-sonnet-5
```

2. **Claude Codeの起動時：** `claude --model <model-name>`を実行してモデルを指定します。1回のセッションだけに適用したい場合に便利です。

```text theme={null}
claude --model claude-sonnet-5
```

3. **環境変数を設定する：** タスクの複雑さに応じて異なるレベルのモデルを設定しておくと、Claude Codeがタスクに合ったモデルを自動で選択します。グローバルに適用されます。

```shellscript theme={null}
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"
```

各変数の用途は次のとおりです。

* `ANTHROPIC_DEFAULT_OPUS_MODEL`：複雑な推論、アーキテクチャ設計などの高難度タスク向け。
* `ANTHROPIC_DEFAULT_SONNET_MODEL`：コードの作成、機能の実装などの日常的なタスク向け。
* `ANTHROPIC_DEFAULT_HAIKU_MODEL`：構文チェック、ファイル検索などの簡単なタスク向け。

4. **settings.jsonで永続的に設定する：** Claude Codeのユーザー設定ファイル（例：`~/.claude/settings.json`、Windowsでは`C:\Users\%USERNAME%\.claude\settings.json`）またはプロジェクトレベルの設定にモデル設定を書き込むと、ユーザーレベルまたはプロジェクトレベルで永続的に設定できます。

## CC Switchで設定する

1. CC Switchを起動し、左側で**Claude Code**を選択してから「プロバイダーを追加」（Add Provider）をクリックします。

![CC Switchのホーム画面にあるプロバイダー追加の入り口](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/1.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=3a0a45652c18bbabd158f7e3a17a8dce)

2. プリセット一覧から、プロバイダーとして「カスタム設定」（Custom Configuration）を選択します。

![CC Switchのプロバイダープリセット一覧でCustom Configurationを選択する画面](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_16.51.01.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=2d63af589968a3f94173587919cbf9a2)

3. プロバイダー名、APIキー、エンドポイント（[https://api.harogo.ai](https://api.harogo.ai)）などを入力します。すべて入力したら「追加」（Add）をクリックします。

![CC Switchのプロバイダー設定フォームでAPIキーを入力する画面](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_16.55.17.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=37caaae4e1ccd895dbe089f656e55751)

4. ホーム画面に戻り、プロバイダー一覧から「harogo」を選択して「使用」（Use）をクリックします。

![CC Switchのホーム画面でharogoを選択してUseをクリックする画面](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.00.16.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=78acb5f499057ae22c6e97c4d770f499)

> ![Claude Codeのターミナルでstatusコマンドとmodelsコマンドを使ってモデル設定を確認する画面](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.03.17.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=192f4da074881e069682f2c9da8b3cd9)
>
> ![I Shot 2026 08 07 17 04 52](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.04.52.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=a8f4c213e6115c8c874979a1d7b0c388)
>
> ヒント：ターミナルでClaude Codeを開いたら、<kbd>/status</kbd>と入力するとモデルIDを確認でき、<kbd>/models</kbd>と入力すると設定済みの別のモデルを選択できます。

> [!WARNING]
>
> CC Switchに「システム環境変数の競合を検出しました」（System environment variable conflict detected）と表示された場合は、まず`ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_MODEL`に対処してください。これらのグローバル変数は現在のプロバイダー設定を上書きします。`ANTHROPIC_AUTH_TOKEN=<HAROGO_API_KEY>`のようなプレースホルダー値が残っていると、認証がそのまま失敗します。グローバル変数が不要であることを確認したら、CC Switchで競合している項目を削除するか、システム/ユーザーの環境変数を手動で削除してから、ターミナルを再起動してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.