💻 Claude Code - AI ターミナルコーディングアシスタント¶
このページでは、Anthropic Claude Code CLI を agtcloud ゲートウェイ 経由で利用するための設定方法を説明します。内容は以下の通りです:
- コンソールで専用トークンを作成する
- Claude Code をインストールする
- 環境変数を設定し、Claude Code を
https://api-cs-al.naci-tech.com/ゲートウェイ経由にする
1️⃣ コンソールで Claude Code 用トークンを作成¶
- トークン管理ページを開きます:
https://api-cs-al.naci-tech.com/console/token - トークン作成 をクリックします。
- グループ/タグ で、グループ
claude codeを選択するか新規作成します。 - 推奨:利用状況の集計や権限管理をしやすくするため、専用グループとして分けて運用してください。
2️⃣ Claude Code をインストール¶
Claude Code は Anthropic 公式のターミナル型コーディングアシスタントです。macOS / Linux / Windows(PowerShell / WSL を含む)に対応しています。
OS に合わせて、以下のいずれかの方法でインストールしてください。
macOS / Linux / WSL(推奨:公式インストールスクリプト)¶
インストール後、ターミナルを再起動してから以下を実行します:
バージョンが表示されればインストール成功です。
Windows(PowerShell)¶
PowerShell で実行します:
次のコマンドで確認できます:
その他の方法(任意)¶
パッケージマネージャーを使いたい場合は、以下も利用できます(どれか 1 つ):
- npm(Node.js ≥ 18)
- Homebrew(macOS)
3️⃣ agtcloud ゲートウェイ向け環境変数を設定¶
agtcloud ゲートウェイ経由で Claude Code を利用するには、以下の環境変数を設定します。
macOS / Linux(bash / zsh)¶
ターミナルで実行します(<YOUR_TOKEN> をコンソールで作成したトークンに置き換えてください):
export ANTHROPIC_BASE_URL="https://api-cs-al.naci-tech.com/"
export ANTHROPIC_AUTH_TOKEN="<YOUR_TOKEN>"
export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"
メモ: -
ANTHROPIC_MODELは利用したいモデル名に置き換え可能です。
- Claude Code へ入った後に/model <model_name>で一時的に切り替えることもできます(例:/model claude-3-5-sonnet-20241022)。
毎回の起動で自動的に有効にするには、shell の設定ファイルへ追記するのがおすすめです(例):
echo 'export ANTHROPIC_BASE_URL="https://api-cs-al.naci-tech.com/"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="<YOUR_TOKEN>"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"' >> ~/.zshrc
source ~/.zshrc
bash を使っている場合は、~/.zshrc を ~/.bashrc に置き換えてください。
Windows(PowerShell)¶
現在のセッションのみ有効にする場合:
$env:ANTHROPIC_BASE_URL = "https://api-cs-al.naci-tech.com/"
$env:ANTHROPIC_AUTH_TOKEN = "<YOUR_TOKEN>"
$env:ANTHROPIC_MODEL = "claude-sonnet-4-5-20250929"
永続化(ユーザー環境変数)する場合:
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api-cs-al.naci-tech.com/", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<YOUR_TOKEN>", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-5-20250929", "User")
PowerShell を開き直すと反映されます。
4️⃣ agtcloud ゲートウェイ経由になっているか確認¶
- 環境変数を設定したターミナルで、以下を実行します:
- 任意のプロジェクトディレクトリに入り、簡単な依頼を試します(例:カレントディレクトリのコードを読ませる)。
- agtcloud コンソールに戻り、使用ログ に呼び出しが記録されていること、グループが
claude codeになっていることを確認します。
コンソールで記録が確認できれば、Claude Code は agtcloud ゲートウェイ経由で正常に利用できています。