Claude Code

​

2 つの連携方法

​

オプション A: 環境変数による Direct API 接続

​

前提条件

• Claude Code がインストール済みであること (クイックスタート)
• cloud.sambanova.ai で取得した SambaNova API キー

​

セットアップ

export ANTHROPIC_BASE_URL="https://api.sambanova.ai"
export ANTHROPIC_API_KEY="<your-sambanova-api-key>"  # from cloud.sambanova.ai/apis
export ANTHROPIC_MODEL="MiniMax-M2.7"
# Route Claude Code's background/"Haiku" tasks to SambaNova too
export ANTHROPIC_DEFAULT_HAIKU_MODEL="MiniMax-M2.7"

claude

​

トラブルシューティング

​

オプション B: プラグイン – Claude が計画し、SambaNova が実行

​

前提条件

• Python 3.11 以上が PATH 上にあること – 3.10 ではインストールフックが警告なしに失敗します
• opencode (curl -fsSL https://opencode.ai/install | bash)
• SambaNova API キーを、Claude Code の起動前に SAMBANOVA_API_KEY としてエクスポートしておくこと。API キーと URL をご参照ください
• Claude Code CLI とそのモデルへのアクセス

​

環境の確認

python3 --version && { opencode --version; } && [ -n "$SAMBANOVA_API_KEY" ] && echo OK

​

セットアップ

1. Claude Code にプラグインをインストールします。
   /plugin marketplace add https://github.com/sambanova/sambanova-plugin-cc
   /plugin install sambanova-plugin-cc
   
2. Claude Code を再起動します (または /reload-plugins を実行します)。
3. インストールを確認します。
   /list-models
   
   プラグインには古いデフォルトモデルが同梱されている場合があります。次のステップで /update-model MiniMax-M2.7 を実行し、現在の推奨モデルを使用してください。
4. 現在のモデルを登録します。
   /model-info                  # browse the SambaNova platform catalogue
   /update-model MiniMax-M2.7   # add it to your local registry
   /list-models                 # confirm
   
   MiniMax-M2.7 の場合は、提案されるサンプリングパラメータ (temperature=1.0、top_p=0.95) をそのまま受け入れてください。

​

Claude と SambaNova によるサブエージェントの実行

​

機能概要

​

デモ 1 – SambaNova エンドツーエンド

mkdir -p ~/sambanova-demo && cd ~/sambanova-demo

/code MiniMax-M2.7 ~/sambanova-demo "Create a minimalist, pet-friendly 'hello world' landing page in this directory. One index.html, one style.css, no JS frameworks. Soft pastel palette, a friendly paw-print emoji, a short tagline ('Hello, friend'), and a single call-to-action button. Keep it under 80 lines of HTML+CSS combined. Open index.html when done so I can preview it."

open ~/sambanova-demo/index.html

​

デモ 2 – Claude が計画し、SambaNova が実行

Read index.html and style.css in ~/sambanova-demo. Write PLAN.md describing how to extend this landing page into a “pet adoption finder” demo:

• A gallery of 6 placeholder pet cards (name, species, one-line bio) in CSS grid
• A search input that filters cards by name (vanilla JS, no frameworks)
• A dark-mode toggle that persists in localStorage

Include exact file layout, the JS event handlers needed, and a verification checklist a human can run in the browser. Don’t modify any code yet.

計画も SambaNova に任せたい場合: まず /update-model gemma-4-31B-it でプランナーモデルを登録し、このセッションで計画を書く代わりに、計画の作成自体を委任します: /code gemma-4-31B-it ~/sambanova-demo "<sample_plan_as_above>"。ステップ 2 (MiniMax-M2.7 での実行) は変わりません。これで計画と実行の両方が SambaNova 上で動作します。

/code MiniMax-M2.7 ~/sambanova-demo "Read PLAN.md and execute every step. After each step, list which acceptance criteria from the plan are now satisfied. Open index.html at the end so I can verify in the browser."

open ~/sambanova-demo/index.html

​

デモ 3 – MCP を活用した、最新ライブラリドキュメントに基づく計画

Context7 のインストール (コマンド 1 つ)

npx ctx7 setup --claude

/mcp

タスク内容

ステップ 1 – Claude が Context7 を使って計画

Use the Context7 MCP server to look up current docs for the date-fns library – specifically formatDistanceToNow with the addSuffix option, and how to load date-fns in a plain browser page via its UMD CDN build (the dateFns global). Then update ~/sambanova-demo/PLAN.md with a “Phase 2: relative date labels” section describing how to give each pet card in the existing finder a fixed data-added ISO date and render an “Added X days ago” label computed from it on load. Use the up-to-date API from Context7 – not what you remember. Quote the exact <script> CDN tag, the global function call, and addSuffix usage verbatim from the docs, and include a verification step a human can run in the browser.

計画も SambaNova に任せたい場合: ここでの注意点として、/code のサブエージェントは MCP にアクセスできないため、gemma-4-31B-it 自身は Context7 を呼び出せません。上記の resolve-library-id → query-docs の取得は Claude に行わせ、解決済みの API をプロンプトに貼り付けた上で、計画の文書化のみを委任します: /code continue gemma-4-31B-it ~/sambanova-demo "<same_plan_as_above>" (事前に /update-model gemma-4-31B-it で登録してください)。Claude が MCP のゲートウェイとなり、gemma-4-31B-it が計画を書きます。

ステップ 2 – SambaNova への引き渡し

/code MiniMax-M2.7 ~/sambanova-demo "Read PLAN.md 'Phase 2' and execute it. After loading, open index.html so I can confirm each card shows an 'Added X days ago' label."

ステップ 3 – 動作確認

open ~/sambanova-demo/index.html

​

MCP サーバーとの組み合わせ

例: Claude が Atlassian MCP サーバー経由で Jira チケット PROJ-1234 を読み、リンクされた Confluence の設計ドキュメントを取得して、自己完結した PLAN.md を作成します。その後 /code MiniMax-M2.7 … がそれを実行します。SambaNova の実行モデルは Jira の認証情報に一切触れません。

例: /code が /tmp/exec-summary.md を書き出します。Claude がそれを読み、GitHub MCP サーバー経由で PR を作成し、Jira チケットにコメントし、Slack チャンネルに投稿します。すべて現在のセッションから実行できます。

例: /code MiniMax-M2.7 ~/project "Implement PLAN.md, run tests, then run 'gh pr create --fill' to open a draft PR."

​

ヒント

• cwd には絶対パスを使用する – シェルの境界を越えると ~ の展開は信頼できません。
• サブエージェントに検証を指示する (「index.html を開いて確認して」等)。指示しないと、ファイルを編集しただけで止まります。
• git diff や grep の結果をプロンプトで事前に解決しない – サブエージェント自身に実行させます。
• モデル ID はプレフィックスなしで指定します。sambanova/<id> の形式は使用しません。
• open は macOS 用です。Linux では xdg-open、Windows では start を使用してください。

​

よくある注意点

​

参考情報

• SambaCloud モデル – 現行のモデル ID とコンテキスト長
• Function calling – サブエージェントを駆動できるモデルの一覧
• API キーと URL – SAMBANOVA_API_KEY の生成方法
• プラグインのソース – sambanova-plugin-cc
• SambaCloud – cloud.sambanova.ai
• OpenCode ドキュメント – opencode.ai/docs
• Claude Code プラグイン – docs.claude.com
• Model Context Protocol – modelcontextprotocol.io