Claude Code

ワンクリック接続または環境変数で Claude Code を HopBase に接続します。

Claude Code は Anthropic の公式 CLI です。初回導入にはコンソールの「ワンクリック接続」を、複数のプロバイダーを管理する場合は CC Switch を、すでに環境変数を自分で管理している場合は手動設定を使用してください。

方法	適した場面	内容
ワンクリック接続(推奨)	初回セットアップ	Claude Code をインストールし、`~/.claude/settings.json` をバックアップした上で書き込み、キーを検証
CC Switch	GUI での設定や複数プロバイダーの管理	Claude Code のプロバイダー設定をインポート・切り替え
手動設定	既存の環境変数管理フローがある場合	Base URL とキーの環境変数を直接設定

推奨:コンソールからのワンクリック接続

環境変数の知識は不要です。Windows、macOS、Linux に対応しています。

ワンクリックボタンを見つける

コンソールにサインインし、APIキーを開いて、キーの横にあるワンクリック接続を選択します。

使用中のシステム用のコマンドをコピーする

Claude Code を選択し、macOS / Linux または Windows PowerShell を選んでから、接続コマンドを生成をクリックしてコマンドをコピーします。

ターミナルに貼り付けて Enter を押す

macOS では「ターミナル」を、Linux では任意のターミナル(curl が必要です)を、Windows では「PowerShell」を開きます。スクリプトは必要に応じて Claude Code をインストールし、既存の設定をバックアップした上で HopBase の設定を書き込み、接続を検証します。

Claude Code を起動する

設定が成功したら、新しいターミナルウィンドウを開いて claude を実行します。

このコマンドには API キー自体ではなく、15 分で失効する使い切りの連携トークンが含まれています。

ワンクリック接続は設定ファイルに書き込みます：

スクリプトは既存のファイルを settings.json.bak.<timestamp> としてバックアップした上で、ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN を ~/.claude/settings.json の env ブロックにマージします。Claude Code はこのファイルの値を使用するため、シェルで設定した同名の環境変数は効果を持ちません。キーやアドレスを変更する場合は、このファイルを編集するか、ワンクリック接続を再実行してください。手動設定と併用しないでください。

CC Switch によるデスクトップ設定

CC Switch ガイドでは、macOS / Windows / Linux へのインストール、HopBase コンソールからの Claude Code または Codex CLI のインポート、プロバイダーの切り替え、GLM-5.3 のローカルルーティングについて説明しています。

手動設定

一時的な設定は現在のターミナルウィンドウのみに適用されます:

export ANTHROPIC_BASE_URL=https://api.hop-base.com
export ANTHROPIC_AUTH_TOKEN=sk-your-key

claude

永続的な設定はシェルの起動ファイルに追加します:

# zsh (the macOS default)
echo 'export ANTHROPIC_BASE_URL=https://api.hop-base.com' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-your-key' >> ~/.zshrc
source ~/.zshrc

# bash (common on Linux; use this instead of the zsh block)
echo 'export ANTHROPIC_BASE_URL=https://api.hop-base.com' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-your-key' >> ~/.bashrc
source ~/.bashrc

モデルを切り替える

Claude Code のセッション内で /model と入力すると、モデルを選択するか ID を直接入力できます。起動時に --model を指定する方法や、環境変数 ANTHROPIC_MODEL を設定する方法もあります(ワンクリック接続を使った場合は ~/.claude/settings.json の env ブロックに追加してください)。使用するのは、現在のキーで GET /v1/models を呼んだ結果に含まれる ID のみにしてください。

# Switch inside a session (enter /model alone to list models)
/model claude-opus-5

# Or choose a model at startup
claude --model claude-sonnet-5

グループを選択する

キー作成時に表示されるグループのメニューが正となります。現在公開されている Claude グループはいずれも同じモデルを提供し、想定するクライアントが異なります:

グループ	想定クライアント
Claude Max(公式フル枠)	Claude Code、SDK、エディタ、サードパーティクライアント
Claude Max(公式フル枠)- 期間限定特価	上の行と同じ内容を期間限定で提供
Claude Max（ccmax）	Claude Code クライアント専用。このキーで SDK、curl、エディタ、サードパーティクライアントから呼び出すと失敗します

Claude グループのキーを使用してください：

Claude グループ(Claude Max 系列)のキーを使用してください。よくある誤りは、Base URL に /v1 を追加してしまいリクエストが /v1/v1/messages になってしまうケースや、Claude のキーで OpenAI プロトコルのエンドポイント(/v1/chat/completions、/v1/responses)を呼び出してしまうケースです。どちらも 404「現在のプラットフォームではこの API パスはサポートされていません」が返ります。Claude Code の count_tokens リクエストも同時実行数にカウントされます。上限については同時実行数、タイムアウト、課金を参照してください。設定がうまくいかない場合はトラブルシューティングを参照してください。

次のステップ

CC Switch: 複数のプロバイダーやキーを切り替える
エディタ / IDE: Cursor、Cline、Continue で Claude モデルを使う
トラブルシューティング: エラーメッセージから対処法を探す

このページの内容