---
title: "環境"
description: "セッションが起動時に使う名前付きの環境変数プロファイル。agent-manager env で保存し、セッションごとまたはグループごとに選びます。"
canonical: "https://agent-manager.dev/ja/docs/environments/"
last-updated: "2026-11-01"
section: "Documentation"
language: "ja"
source: "agent-manager"
---

# 環境

環境プロファイルは、セッションが起動時に使う名前付きの環境変数です。マネージャー自身の環境の上に載ります。セッションごと、またはグループごとに選びます。コマンドは `agent-manager env` です。

## プロファイル

`env list` は名前とキーを出し、値は出しません。`env show` は `KEY=VALUE` を出します。`env set` は変数を書き、プロファイルがなければ作ります。`env unset` は変数を外します。`env rm` はプロファイルを削除します。`list` と `show` は `--json` を取ります。

```bash
agent-manager env list
agent-manager env show work
agent-manager env set work AWS_PROFILE=work
agent-manager env unset work AWS_PROFILE
agent-manager env rm work
```

名前は 1 から 60 文字で、前後に空白は置けず、制御文字も含められません。キーは文字、数字、`_` で、数字では始められません。`AGENT_MANAGER_` で始まるキーは大文字小文字を問わず拒否されます。マネージャー自身がそれらを置くためです。値に NUL バイトは置けません。

そのプロファイルを使うセッションは、次の起動で変更を拾います。復帰と再起動も含みます。すでに動いているセッションは、起動時の環境のままです。プロファイルを削除すると、それを名指ししているセッションは、再び設定されるまで起動を拒みます。ない名前は拒否され、メッセージは存在するプロファイルを示すか、`agent-manager env set` で作るよう伝えます。

Settings は各プロファイルを名前とキーだけで示し、値は出しません。プロファイルが一つ以上あるまで `environments` の行は隠れます。その行で `enter` を押しても編集は始まりません。変更は `env` コマンドで行うので、トークンは設定画面に出ません。[エクスポート](/ja/docs/config/#export)にプロファイルは含まれません。

## セッションが使うプロファイル

未設定のセッションは、最も近い祖先グループのプロファイルを継ぎます。グループにプロファイルがなければ、自分を作ったセッションのプロファイルを継ぐので、ヘルパーはそのアカウントのままです。どちらもなければ none で起動します。明示した選択が優先し、空の選択は none です。

新規セッションのフォームでは、プロファイルがあるか、グループがすでに一つを名指ししているとき、`env` の行が出ます。触らなければ、その行はグループのものとして示されます。親グループがプロファイルを名指ししているとき、none のままの子グループはそれを継ぎ続け、フォームはそのプロファイルを注記します。行を進めると、子自身のプロファイルが保存されます。新規グループのフォームと、グループ編集カード（`r`）にも、選択肢があるとき同じ行があります。

クイックプロンプトでは、プロファイルがあると `ctrl+g` が新しいセッションの起動プロファイルを切り替えます。env のチップをクリックしても同じです。[クイックプロンプト](/ja/docs/prompt/#keys)にそのキーがあります。

`agent-manager spawn --env` はその起動のプロファイルを指定します。フラグを省くと継承します。空文字列は none です。`create_session` は `environment` で同じ選択を取ります。省くと継承し、空文字列は none です。`host` と一緒には拒否されます。プロファイルはこのマシン上のセッションに適用されるためです。SSH 接続上のセッションにはこの行がなく、クイックプロンプトもそこでは `ctrl+g` を出しません。