OceanBase MaaSを使用したClaude Codeの利用

ターミナルを使用してClaude Codeをインストール、設定、起動します。コマンドラインを使い慣れている開発者に適しています。

Claude Codeのインストール

古いバージョンのアンインストール(既にインストール済みの場合)

npmまたはpnpmを使用してClaude Codeをインストール済みの場合、ネイティブインストールに移行できます。

claude install

古いバージョンをアンインストールする必要がある場合は、インストール方法に応じて以下のコマンドのいずれかを実行してください。

npm uninstall -g @anthropic-ai/claude-code
# または
pnpm uninstall -g @anthropic-ai/claude-code

インストール方法

インストールスクリプトまたはHomebrewを使用してClaude Codeをインストールできます。

• インストールスクリプトの使用(推奨)

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

• Homebrewの使用 (brew upgrade claude-code で手動でアップグレードする必要があります)

brew install --cask claude-code

インストールが完了したら、claude doctor を実行してインストール状態を確認します。

手順

MaaS APIキーの取得

OceanBase MaaSコンソールで、または社内プロセスによりAPIキーを申請します。形式は通常 sk_xxxx です。APIキーは大切に保管し、コードリポジトリには送信しないでください。具体的な操作については、AI APIキーの管理を参照してください。

Shell環境変数の設定（推奨）

Shell設定ファイルを使用して環境変数を設定することで、端末を開くたびにClaude Codeが自動的にMaaSゲートウェイのアドレスとAPIキーを読み取るようにします。

1. 現在使用しているShellを確認します。

   echo "$SHELL"
   

   • 出力が /bin/zsh の場合：エディタを使用して ~/.zshrc を開きます。例えば、nano ~/.zshrc または vim ~/.zshrc を実行します。
   • 出力が /bin/bash の場合：エディタを使用して ~/.bashrc を開きます。例えば、nano ~/.bashrc または vim ~/.bashrc を実行します。

2. Shell設定ファイル（zshを例として）を開き、以下の内容をファイルの末尾に追加します。

   説明

   sk_xxxx をMaaSコンソールから取得した実際のAPIキーに置き換えてください。APIキーの取得方法については、AI APIキーの管理を参照してください。

   # ============= OceanBase MaaS + Claude Code 設定 =============
   # Claude Code のリクエストをAnthropic公式サービスではなくMaaSゲートウェイにルーティングする
   
   # コア設定：ゲートウェイアドレスと認証情報
   export ANTHROPIC_BASE_URL="https://ai-api-g.oceanbase.com/api"
   export ANTHROPIC_AUTH_TOKEN="sk_xxxx"   # ご自身のMaaS APIキーに置き換えてください
   
   # 矛盾を回避する：ローカルにANTHROPIC_API_KEYが設定されている場合は、明示的にクリアしてください
   export ANTHROPIC_API_KEY=""
   
   # パフォーマンス最適化（強く推奨）：不要なトラフィックと実験的機能を無効にして、レイテンシを低減する
   export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
   
   # オプション：APIリクエストのタイムアウト時間（ミリ秒）
   export API_TIMEOUT_MS="30000000"
   
   # オプション：デフォルトのモデルを指定する（詳細は下記「モデル設定」を参照）
   export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
   export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
   export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
   

3. 設定を有効にします。

   source ~/.zshrc   # zsh
   # または
   source ~/.bashrc  # bash
   # またはターミナルを再起動する
   

環境変数の説明

Claude Codeの起動

cd /path/to/your/project
claude

初回起動時、Claude Codeは以下の操作を実行します：

1. 環境変数からANTHROPIC_AUTH_TOKENを読み取ります。
2. ANTHROPIC_BASE_URLで指定されたMaaSゲートウェイを介して認証を完了します。
3. 追加のログイン操作を行うことなく使用できます。

command not found: claudeというメッセージが表示された場合は、上記の手順でグローバルインストールが完了しているか確認してください。

接続の検証

Claude Codeのプロンプトに /status と入力すると、以下のような内容が表示されます。

Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://ai-api-g.oceanbase.com/api

• Auth token が ANTHROPIC_AUTH_TOKEN として表示されている場合、認証情報が環境変数から読み取られたことを意味します。
• Anthropic base URL にはMaaSゲートウェイのアドレスが表示されます。

モデルの設定

ANTHROPIC_DEFAULT_*_MODEL が設定されていない場合、Claude Codeは組み込みのClaudeデフォルトモデルマッピングを使用します。

Claudeモデルのエイリアスの使用（推奨）

公式Claudeモデルについては、Claude Codeが認識できるモデルエイリアス（例：claude-sonnet-4-6）を使用することを推奨します。これにより、1Mコンテキストやeffort制御などのネイティブ機能を正しく有効にできます。

export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"    # クイックモード
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"  # バランスモード
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"      # パワーモード

設定を変更した後、source ~/.zshrc を実行してClaude Codeを再起動します。

セッション内では、/model コマンドを使用して現在のモデルを確認または切り替えることができます。

タブVS Code拡張機能

VS CodeにClaude Code拡張機能をインストールし、IDE経由で使用することができます。グラフィカル操作を好む開発者に適しています。

Claude Code VS Code拡張機能

コマンドライン以外に、VS CodeにClaude Code Extensionをインストールすることもできます。

settings.jsonの設定

VS Codeの設定でEdit in settings.jsonをクリックし、以下の設定を追加します。

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://ai-api-g.oceanbase.com/api"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk_xxxx"
    },
    {
      "name": "ANTHROPIC_API_KEY",
      "value": ""
    },
    {
      "name": "API_TIMEOUT_MS",
      "value": "30000000"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
      "value": "1"
    }
  ]
}

設定の優先順位：VS Codeのsettings.jsonに記載されている環境変数は、Shellの設定よりも優先されます。拡張機能を使用する場合は、設定を一箇所で管理し、競合を避けることをお勧めします。

使用上のヒント：

• 初回使用時は、ワークスペースを信頼する（Trust This Folder）必要があります。
• モデルの切り替えには /model を、接続状態の確認には /status を使用します。
• 設定を変更した後は、VS Codeを完全に終了して再起動する必要があります。