# executeCode

IDE 統合 (例えば現在開いているノートブックにバインドされた Jupyter カーネル) が提供するライブカーネルまたはサンドボックス内でコードスニペットを実行します。このツールは、VS Code 拡張などの互換性のある IDE ブリッジと Jupyter カーネルが選択された状態で Claude Code が実行されているときにのみ存在します。

## 使用タイミング

- アクティブな Jupyter カーネルにすでにロードされた状態に対して、素早い計算、データ検査、またはプロットを実行。
- コードスニペットをノートブックセルに貼り付ける前に検証。
- カーネルに存在するがディスクにシリアライズされていないインメモリデータフレーム、変数、またはモデルを探索。
- ユーザーが IDE でインラインでレンダリングしたいチャートや数値結果を生成。

`Bash` で `python script.py` を実行する方がよいスタンドアロンスクリプトや、新しいカーネルをまたいで永続化する必要があるコードには使用しないでください。

## パラメータ

- `code` (string, required): 現在のカーネルで実行するコード。ノートブックセルに貼り付けられたように実行されます — 定義された変数はカーネルが再起動されるまで永続化されます。
- `language` (string, optional): IDE ブリッジが複数のカーネルをサポートする場合のスニペットの言語。最もよく省略されます。アクティブカーネルの言語 (通常 Python) がデフォルトです。

## 例

### 例 1: インメモリデータフレームを検査

```
executeCode(
  code="df.head()\nprint(df.shape)\nprint(df.dtypes)"
)
```

カーネルにすでにロードされたデータフレームの最初の行、形状、列 dtype を返します。

### 例 2: 素早い数値チェック

```
executeCode(
  code="import numpy as np\nnp.mean([1, 2, 3, 4, 5])"
)
```

ノートブックセルを作成せずにワンオフの計算を実行します。

## 注意事項

- `executeCode` は IDE ブリッジツールです。Claude Code のプレーンなターミナルセッションでは利用できません。セッションがカーネルを公開する IDE (例えば VS Code Jupyter 拡張) に接続されている場合にのみ表示されます。
- 状態はカーネルに永続化されます。1 つの `executeCode` 呼び出しで定義された変数は、後の呼び出し、ノートブックセル、ユーザーに引き続き見えます — 副作用に注意してください。
- 長時間実行またはブロッキングコードはカーネルをブロックします。スニペットは短く保ってください。数分の作業には、実際のスクリプトを書いて `Bash` で実行してください。
- 出力 (stdout、戻り値、画像) はセッションに返されます。非常に大きな出力は IDE ブリッジによって切り詰められる可能性があります。
- ファイル編集には `Edit`、`Write`、または `NotebookEdit` を優先してください — `executeCode` はソースファイルを作成する代替ではありません。
