Claude Code

Claude Code は、Anthropicが提供するターミナルで動作するコーディングツールです。 API アドレス、API Key、モデルIDを設定することで、Claude Code で AGTCloud の Anthropic Messages 互換エンドポイントを使用できるようになります。

このチュートリアルでは、Claude Code CLI のみを説明します。モデルが異なれば、ツール呼び出し、拡張思考、実験機能のサポート範囲も異なる場合があります。現在のAPI Keyで利用可能で、Anthropic Messages をサポートするモデルを選択してください。

事前準備

開始前に、次の項目を確認してください。

ターミナル環境と Git を準備します。
AGTCloudに登録してログインします。
API Keys ページでトークンを作成します。
現在のトークンで利用可能な Anthropic プロトコルモデルIDをモデルマーケットプレイスから見つけます。

Claude Codeをインストールする

オペレーティングシステムに対応するインストール方法を選択してください。ネイティブインストールスクリプトは自動的に更新されます。 Homebrew および WinGet のインストールは、それぞれのパッケージマネージャーを通じて手動で更新する必要があります。

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

インストールが完了したら、ターミナルを再度開き、バージョンを確認します。

claude --version
claude doctor

claude doctor は、インストールステータスと設定ファイルをチェックします。 claude が見つからないというメッセージがターミナルに表示された場合は、ターミナルを再度開き、PATH がインストールディレクトリに追加されていることを確認してください。

AGTCloudを設定する

Claude Code は、ANTHROPIC_BASE_URL で指定されたアドレスにリクエストを送信します。ここでは AGTCloud API Origin のみを入力し、最後に /v1 を追加しないでください。Claude Code が単独で /v1/messages を要求するためです。

一時的に設定する

次の設定は、現在のターミナルセッションでのみ有効です。 your-api-key と MODEL_ID を独自のトークンとモデルID に置き換えてください。

unset ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_BASE_URL="https://api.agtcloud.cn"
export ANTHROPIC_API_KEY="your-api-key"
export ANTHROPIC_MODEL="MODEL_ID"

環境変数	機能
`ANTHROPIC_BASE_URL`	Claude Code リクエストをこのページに表示されている AGTCloud API アドレスに向けます
`ANTHROPIC_API_KEY`	`X-Api-Key` ヘッダー経由で AGTCloud API Keyを送信
`ANTHROPIC_MODEL`	このセッションでデフォルトで使用されるモデルIDを指定します

競合する認証変数をクリアする

ANTHROPIC_AUTH_TOKEN がシステムですでに構成されている場合、Claude Code はそれを Bearer Token として使用し、ANTHROPIC_API_KEY を上書きする可能性があります。このチュートリアル構成を使用する前に、この変数をクリアしてください。

永続的に設定する

ターミナルを開くたびに設定を有効にするには、同じ内容をシェル設定ファイルまたは Windows のユーザー環境変数に保存します。API Key はローカルに平文で保存されるため、信頼できる個人のデバイスでのみ使用してください。

~/.zshrc を編集して以下を追加します。

export ANTHROPIC_BASE_URL="https://api.agtcloud.cn"
export ANTHROPIC_API_KEY="your-api-key"
export ANTHROPIC_MODEL="MODEL_ID"

保存後に構成をロードします。

source ~/.zshrc

モデルを選ぶ

MODEL_ID は置き換える必要がある位置だけであり、実際のモデル名ではありません。現在のAPI Keyで利用可能で、Anthropic Messages をサポートしているモデルIDをモデルマーケットプレイスからコピーしてください。

Claude Code を入力した後、/model を実行して、現在のセッションモデルを表示および切り替えることもできます。モデルセレクターがすべての AGTCloud モデルを自動的にリストできるかどうかは、現在の Claude Code バージョンと API Key によって異なります。対象のモデルが表示されない場合は、ANTHROPIC_MODEL でモデルIDを直接指定してください。

起動して接続を確認する

プロジェクトディレクトリへ移動する

cd /path/to/your/project

Claude Codeを起動する

claude

初回起動時に環境変数にAPI Keyを使用するかどうかのプロンプトが表示された場合は、ターミナルプロンプトに従って確認してください。

現在の設定を確認する

Claude Code で実行します。

/status

認証元が API Key であることを確認し、Base URL がこのページに表示されている AGTCloud API アドレスであるかどうかを確認します。 Base URL には重複した /v1 を含めることはできません。

読み取り専用テストを開始する

README.md を含むテストプロジェクトに次のように開きます。

README.mdを読み、プロジェクトの目的を3点で要約してください。ファイルは変更しないでください。

コンテンツは正常に返され、対応する呼び出し履歴が AGTCloud コンソールに表示され、基本的な接続が確立されたことが示されます。

構成チェックが完了したら、簡単な質問を送信して、モデルが適切に応答することを確認できます。

よくある質問

現象	優先して確認する項目	対処方法
`claude` コマンドが見つかりません	インストール結果と `PATH`	ターミナルを再度開き、`claude doctor` を実行し、必要に応じて公式のインストールコマンドを再実行します。
起動後もログインを要求される	API Key が Claude Code が起動されたのと同じ端末で有効になるかどうか	`ANTHROPIC_API_KEY` を確認し、ターミナルを再度開き、再度開始します
API Key は有効になりません	`ANTHROPIC_AUTH_TOKEN`を同時に設定するかどうか	競合変数をクリアし、`/status` 経由で認証ソースを確認します。
`401` を返す	API Key、環境変数とAPI Keyの状態	有効な API Keyを再コピーし、`/status` を通じて認証ソースを確認します。
`403` を返す	トークンの権限、モデルの権限、およびアカウントのステータス	コンソールでトークンとモデルの利用可能な範囲を確認します
`404` を返す	Base URL とモデル ID	Base URL には `https://api.agtcloud.cn` だけを指定し、`/v1` を追加しないでください。モデル ID を再度コピーします
モデルが見つからないか、使用できません	現在の API Key 表示モデルとプロトコルのサポート	Anthropic Messages をサポートするモデルを選択し、`ANTHROPIC_MODEL` で完全な ID を指定します。
一部のツールまたは高度な機能は利用できません	モデルの機能とゲートウェイの互換性	最初に基本的な対話検証を使用します。高度な機能は、選択したモデルと現在の適応結果の影響を受けます。

特定できない問題が発生した場合は、リクエスト時間、モデルID、HTTP ステータス、および機密情報を除いたエラー情報を記録し、エラーとトラブルシューティングを確認してください。完全なAPI Keyを送信しないでください。

セキュリティ上の推奨事項

Claude Code に別の API Keyを作成して、アクセス許可の管理と認証情報の無効化を容易にします。
実際のキーをコード、リポジトリ、スクリーンショット、ログ、または共有スクリプトに書き込まないでください。
共有デバイスまたはチーム環境では、オペレーティングシステムの認証情報管理または組織的に一貫したキー配布スキームを優先します。
API Keyの漏えいの疑いがある場合は、コンソールで直ちに無効にするか削除し、新しいキーを作成する必要があります。

次に API Key、Base URL および認証と Anthropic Messages を続けて参照できます。

このページの内容