> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sambanova.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# term-llm

[term-llm](https://term-llm.com) は、Go で書かれたオープンソースのターミナルファーストな AI ランタイムです。自然言語を実行可能なシェルコマンドに変換し、ツールや MCP サーバーを備えた永続的なチャットを実行し、モデルの支援を受けてファイルを編集できるほか、エージェント、スキル、セッション、ジョブ、ローカルの自動化にも対応しています。以下の手順に従って、term-llm を SambaCloud でホストされているモデルに接続してください。

## 前提条件

作業を始める前に、以下の環境を準備してください。

* [SambaCloud](https://cloud.sambanova.ai/?utm_source=termllm\&utm_medium=external\&utm_campaign=cloud_signup) アカウントと [API キー](https://cloud.sambanova.ai/apis?utm_source=termllm\&utm_medium=external\&utm_campaign=cloud_signup)
* macOS、Linux、または WSL 上の POSIX シェル
* Go 1.22 以降 (ソースからビルドする場合のみ)

## セットアップ

<Steps>
  <Step title="term-llm のインストール">
    公式インストールスクリプトを使用して term-llm をインストールします。

    ```bash theme={}
    curl -fsSL https://raw.githubusercontent.com/samsaffron/term-llm/main/install.sh | sh
    ```

    または Go でインストールします。

    ```bash theme={}
    go install github.com/samsaffron/term-llm@latest
    ```

    `term-llm --version` が `command not found` を返す場合 (macOS でよく発生します) は、インストールディレクトリを `PATH` に追加します。

    ```bash theme={}
    export PATH="$HOME/.local/bin:$PATH"
    ```

    この変更を永続化するには、同じ行を `~/.zshrc` (macOS のデフォルト) または `~/.bashrc` に追記し、ターミナルを再起動するか `source ~/.zshrc` を実行します。
  </Step>

  <Step title="SambaNova API キーの設定">
    SambaCloud の API キーをエクスポートします。

    ```bash theme={}
    export SAMBANOVA_API_KEY=<your-api-key>
    ```

    あるいは、`~/.config/term-llm/config.yaml` の `providers.sambanova.api_key` に API キーを直接設定することもできます。
  </Step>

  <Step title="SambaNova をデフォルトプロバイダーに設定">
    SambaNova をデフォルトプロバイダーとして設定し、使用するモデルを設定します。

    ```bash theme={}
    term-llm config set default_provider sambanova
    term-llm config set providers.sambanova.model gpt-oss-120b
    term-llm config set providers.sambanova.fast_model Meta-Llama-3.3-70B-Instruct
    ```

    これらのコマンドは、`~/.config/term-llm/config.yaml` が存在しない場合は作成し、その場で編集します。`term-llm config set providers.sambanova.model <TAB>` でモデル ID をタブ補完できます。

    または、`~/.config/term-llm/config.yaml` を直接編集します。

    ```yaml theme={}
    default_provider: sambanova

    providers:
      sambanova:
        model: gpt-oss-120b
        fast_model: Meta-Llama-3.3-70B-Instruct
    ```
  </Step>

  <Step title="SambaNova モデルの利用開始">
    設定したプロバイダーを使用してプロンプトを実行します。

    質問をします。

    ```bash theme={}
    term-llm ask "Explain RDUs"
    ```

    自然言語をシェルコマンドに変換します。

    ```bash theme={}
    term-llm exec "Find all Go files modified today"
    ```

    対話型セッションを開始します。

    ```bash theme={}
    term-llm chat
    ```

    1 回のリクエストに限り、設定済みのモデルを上書きするには、次のように実行します。

    ```bash theme={}
    term-llm ask \
      --provider sambanova:Meta-Llama-3.3-70B-Instruct \
      "Summarize this repository"
    ```
  </Step>
</Steps>

## 利用可能なモデル

チャットに対応したすべての SambaNova モデルを、コンテキストウィンドウと料金情報とともに一覧表示します。

```bash theme={}
term-llm models --provider sambanova
```

term-llm には、SambaNova の公開料金情報と同期された料金表が同梱されています。

## ビデオチュートリアル

以下のビデオでは、term-llm のインストール、SambaNova の設定、SambaCloud モデルの利用開始までを紹介しています。

<video src="https://mintcdn.com/sambanova-systems/FjYi4s0Yh0wdhmFE/videos/term-llm-setup.mp4?fit=max&auto=format&n=FjYi4s0Yh0wdhmFE&q=85&s=129cec3d998ce50691fc29c535ef044d" controls data-path="videos/term-llm-setup.mp4" />

## トラブルシューティング

インストール後に `term-llm` が見つからない場合 (macOS でよく発生します) は、インストールディレクトリを `PATH` に追加します。

```bash theme={}
export PATH="$HOME/.local/bin:$PATH"
```

この変更を永続化するには、同じ行を `~/.zshrc` (macOS のデフォルト) または `~/.bashrc` に追記し、ターミナルを再起動するか `source ~/.zshrc` を実行します。

`SAMBANOVA_API_KEY` が認識されない場合は、キーが設定されており、リテラルの山括弧が含まれていないことを確認します。

```bash theme={}
echo "${SAMBANOVA_API_KEY:0:10}..."
```

出力が空または不正な場合は、API キーを再度エクスポートするか、[SambaCloud ポータル](https://cloud.sambanova.ai/apis?utm_source=termllm\&utm_medium=external\&utm_campaign=cloud_signup)で新しいキーを生成してください。

設定したモデルが利用できずリクエストが失敗する場合は、現在の SambaNova モデルを一覧表示します。

```bash theme={}
term-llm models --provider sambanova
```

その後、`~/.config/term-llm/config.yaml` の `model:` フィールドを、一覧に表示されたモデル ID のいずれかに更新します。

`~/.config/term-llm/config.yaml` が存在しない場合は、先に設定ディレクトリを作成します。

```bash theme={}
mkdir -p ~/.config/term-llm
```

## 参考情報

* [term-llm ドキュメント](https://term-llm.com)
* [プロバイダーとモデルのリファレンス](https://term-llm.com/reference/providers-and-models/)
* [設定リファレンス](https://term-llm.com/reference/configuration/)
* [GitHub リポジトリ](https://github.com/samsaffron/term-llm)
* [対応 SambaCloud モデル](/docs/ja/models/sambacloud-models)
