📋 準備手順
始める前に、以下の点をご確認ください。
- Kozeアカウントを登録し、ログイン済み
- API管理ページでAPIキーを作成済み
- Claude Codeをインストール済み(
npm install -g @anthropic-ai/claude-code)
🚀 ステップ1:環境変数の設定
ターミナルで以下のコマンドを実行し、APIアドレスとキーを環境変数として設定してください。
# KozeプロキシアドレスをベースURLに設定
export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1'
# Kozeバックエンドで作成したAPIキーを設定
export ANTHROPIC_AUTH_TOKEN="あなたのAPIキー"
💡 ヒント:
https://api.kozeai.comを実際のサービスドメインに置き換えてください。 APIキーは、「API管理 → 既存のキー」ページで確認または作成できます。
🔧 ステップ2:VS Codeプラグインの設定(オプション)
VS Code用のClaudeプラグインを使用している場合は、`~/.claude/config.json`で設定する必要があります。
{
"primaryApiKey": "APIキー",
"apiBaseUrl": "https://api.kozeai.com/v1"
}
ファイルが存在しない場合は、手動で作成してください。
- macOS / Linux:
~/.claude/config.json - Windows:
C:\Users\Yourユーザー名\.claude\config.json
🎯 ステップ3:Claude Codeの起動
環境変数を設定したら、ターミナルで直接起動します。
claude
Claude Codeは、設定したKozeプロキシアドレスを自動的に使用してリクエストを行います。
📌 環境変数の永続化
ターミナルを開くたびに変数をリセットするのを避けるため、シェル設定ファイルに変数を書き込むことをお勧めします。
# Bashユーザー
echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN='your API key' >>> ~/.bashrc
source ~/.bashrc
# Zshユーザー
echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN='your API key' >> ~/.zshrc
source ~/.zshrc
✅ 接続確認
Claude Codeを起動後、通常のダイアログ画面が表示されれば、設定は成功です。
Kozeの「利用統計」ページで、リアルタイムの通話記録を確認できます。⚠️よくあるご質問
| 問題 | 解決策 |
|---|---|
| ヒント:無効なAPIキー | APIキーが正しくコピーされているか、余分なスペースが入っていないか確認してください。 |
| 接続タイムアウト | ベースURLが正しく、末尾に/v1が含まれているか確認してください。 |
| 利用できないモデル | Kozeで、現在のパッケージで利用可能なモデルの一覧を確認してください。モデルロビー |
