Claude Code

​

クイックスタート

​

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

​

ローカルインストール

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

irm https://claude.ai/install.ps1 | iex

​

npm でインストールする

npm install -g @anthropic-ai/claude-code

​

2. AIHubMix API を設定する

1. ANTHROPIC_BASE_URL を https://aihubmix.com に設定します
2. ANTHROPIC_AUTH_TOKEN を AIHubMix プラットフォームで取得した API Key に設定します
3. ANTHROPIC_MODEL をモデル一覧で対応している Claude モデルに設定します。例：claude-sonnet-4-5

echo $SHELL

# <AIHUBMIX_API_KEY> を AIHubMix で取得した実際の Key に置き換えてください
echo 'export ANTHROPIC_BASE_URL="https://aihubmix.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="<AIHUBMIX_API_KEY>"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-5"' >> ~/.zshrc

# <AIHUBMIX_API_KEY> を AIHubMix で取得した実際の Key に置き換えてください
echo 'export ANTHROPIC_BASE_URL="https://aihubmix.com"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="<AIHUBMIX_API_KEY>"' >> ~/.bash_profile
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-5"' >> ~/.bash_profile

source ~/.zshrc

source ~/.bash_profile

echo $ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
echo $ANTHROPIC_MODEL

REM <AIHUBMIX_API_KEY> を AIHubMix で取得した実際の Key に置き換えてください
setx ANTHROPIC_AUTH_TOKEN "<AIHUBMIX_API_KEY>"
setx ANTHROPIC_BASE_URL "https://aihubmix.com"
setx ANTHROPIC_MODEL "claude-sonnet-4-5"

if defined ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%

# <AIHUBMIX_API_KEY> を AIHubMix で取得した実際の Key に置き換えてください
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<AIHUBMIX_API_KEY>", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://aihubmix.com", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-5", [EnvironmentVariableTarget]::User)

if ($env:ANTHROPIC_AUTH_TOKEN) { "ANTHROPIC_AUTH_TOKEN is set" }
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL

​

3. 設定を検証する

curl https://aihubmix.com/v1/messages \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "1+1, output only the answer"}]
  }'

curl.exe https://aihubmix.com/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-4-5\",\"max_tokens\":16,\"messages\":[{\"role\":\"user\",\"content\":\"1+1, output only the answer\"}]}"

claude -p "1+1, output only the answer" --model claude-sonnet-4-5

​

4. 使い始める

$ cd /path/your-project
> claude

1. ユーザーホームの .claude.json を探します。
   • macOS / Linux: ~/.claude.json
   • Windows: C:\Users\%USERNAME%\.claude.json
2. hasCompletedOnboarding を true に設定します。

{
  "hasCompletedOnboarding": true
}

3. 保存してから、ターミナルで claude を再実行します。

​

（任意）モデル設定の追加方法

1. 会話中： /model <モデル名> で一時的にモデルを切り替えます。

/model claude-sonnet-4-5

2. Claude Code 起動時： claude --model <モデル名> で単一セッションのモデルを指定します。

claude --model claude-sonnet-4-5

3. 環境変数： タスクの複雑さに応じてモデル階層を設定します。

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

• ANTHROPIC_DEFAULT_OPUS_MODEL：複雑な推論やアーキテクチャ設計向け。
• ANTHROPIC_DEFAULT_SONNET_MODEL：コーディングや機能実装向け。
• ANTHROPIC_DEFAULT_HAIKU_MODEL：簡単なチェックやファイル検索向け。

4. settings.json： Claude Code のユーザー設定ファイル（macOS/Linux は ~/.claude/settings.json、Windows は C:\Users\%USERNAME%\.claude\settings.json）またはプロジェクト設定に書き込みます。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "<AIHUBMIX_API_KEY>",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemini-3.5-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "gemini-3.5-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gemini-3.5-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "gemini-3.5-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gemini-3.5-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "gemini-3.5-flash",
    "ANTHROPIC_MODEL": "gpt-5.5"
  },
  "model": "gpt-5.5"
}

​

CC Switch ではどのように設定しますか？

1. CC Switch を起動し、左側で Claude Code を選択してから “Add Vendor” をクリックします。

2. プリセット一覧から “AiHubMix” を選択します。Claude Code 側の Provider を設定していることを確認してください。

3. “API Key” 欄に実際の Key を入力します。

4. 設定後は、まず claude-sonnet-4-5 をモデル ID として使い、“Add” をクリックして保存します。ヘルスチェックが通ったら、Claude Code 内の /models または /model で他の Claude モデルへ切り替えられます。

5. ホームに戻り、Provider 一覧から “AiHubMix” を選択して “Start” をクリックします。

​

VS Code プラグインではどのように設定しますか？

1. VS Code を起動し、プラグインをインストールします。

2. Ctrl + Shift + P または Cmd + Shift + P を押し、Settings と入力します。

3. Claude Code を検索し、Claude Code: Environment Variable -> Edit in settings.json を開きます。

4. claudeCode.environmentVariables に AIHubMix の情報を入力します。

​

Wechat-Agent-SDK

インストール先：https://github.com/AIhubmix/wechat-agent-sdk

​

FAQ

​

Q: 401 認証エラーが表示される場合は？

• No token provided：Key が送信されていません。Claude Code で /config を開き、Use custom API key の Token 設定を確認してください。
• invalid key: AIHUBMIX_API_KEY：例のプレースホルダーをそのままコピーした可能性があります。AIHubMix コンソールから実際の Key をコピーし直し、ANTHROPIC_AUTH_TOKEN を更新してください。
• this key is not enabled：リクエストは AIHubMix に届いていますが、Key が有効化されていないか権限がありません。AIHubMix コンソールで Key の有効状態、期限、残高、選択した Claude モデルの権限を確認してください。

[Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_MODEL", "User")

​

Q: 400 Incorrect model ID または Bad request (400) が表示される場合は？

​

Q: macOS でインストール後も zsh: command not found: claude が出る場合は？

1. インストール場所を確認します。公式スクリプトは通常、次のいずれかにインストールします。

• ~/.claude/bin
• ~/.local/bin

ls -l ~/.claude/bin
or
ls -l ~/.local/bin | grep claude

2. インストール場所を PATH に追加します。

​

ケース A：~/.claude/bin にインストールされている場合

echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

​

ケース B：~/.local/bin にインストールされている場合

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

3. 確認します。

which claude
claude -v

​

Q: Claude Code が Anthropic サービスに接続できない場合は？

​

その他のリソース

• Github
• npm パッケージ
• 公式ベストプラクティス
• 公式設定ガイド