> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Agent CLI
> 自分のリポジトリでローカルコーディングエージェントを実行し、CloudThinker Sandbox とワークスペースの承認を通じてクラウドを読み書きします
**プレビュー** — `cloudthinker agent` は macOS と Linux 向けの CloudThinker CLI に同梱され、有料のワークスペースプランが必要です。プレビューへの参加は[こちらからお問い合わせ](https://cloudthinker.io/contact)ください。
`cloudthinker agent` はターミナルで動くコーディングエージェントで、[pi](https://github.com/badlogic/pi-mono) を基盤にしています。ファイルの編集とコマンド実行は自分のマシンで行い、クラウドへはワークスペースのコネクションを使って CloudThinker Sandbox 経由でのみ到達します。
## Agent CLI を使う理由
* **リポジトリはローカルのまま。** モデルのループ、ファイル編集、シェルコマンドはすべて手元のノート PC で動きます。
* **クラウド認証情報をマシンに置かない。** クラウドコマンドは CloudThinker Sandbox で実行され、コネクションの認証情報はその実行のためだけに注入されます。
* **ワークスペースのルールが適用される。** クラウドへの書き込みは、チャットと同じ [Auto Mode](/ja/guide/auto-mode) と承認ルールに従います。
* **すべてのセッションがミラーされる。** チームメイトはブラウザーでセッションを閲覧でき、ワークスペースが監査と課金を行います。
## セッションを開始する
[CloudThinker CLI](/ja/guide/cli/overview) をインストールし、`cloudthinker login` を実行します。認証情報がない場合はエージェントがブラウザーログインを実行します。
```bash theme={null}
cd my-terraform-repo
cloudthinker agent
```
初回実行時に、CLI がプラットフォーム向けのエージェントバンドルをダウンロードし、チェックサムを検証します。
ヘッダーにはワークスペース、ユーザー、セッションのリンク、そしてワークスペースの承認モードが `· Auto` または `· Manual` として表示されます。
**成功状態:** フッターに `◆ 0.00 credits` が表示され、最初のプロンプトを入力できます。
## 2 つの実行環境
エージェントが動く場所は 2 つだけで、どちらを使っているかを常に示します。
| 環境 | そこで動くもの | 認証情報 |
| ------------------------ | ---------------------------------------------- | ------------------------------------------- |
| **自分のマシン** | pi のローカルツール: bash、read、write、edit、grep、find、ls | CloudThinker からの認証情報はなし |
| **CloudThinker Sandbox** | `ct_cloud_read` と `ct_cloud_write` | ワークスペースのコネクション認証情報。実行ごとに注入され、マシンには決して送られません |
コネクションは Sandbox が使える認証情報であり、3 つ目の環境ではありません。エージェントはチャットで Anna が見るのと同じコネクション情報を、毎ターン更新して参照します。ブラウザーで追加したコネクションは次のプロンプトから使えます。
1 つのコマンドで、名前付きの AWS と GCP のコネクションを GitLab と組み合わせて使えます。どのエイリアスを使うかをエージェントに伝えてください。クラウド実行ごとに認証情報とローカルのファイル変更は分離され、新たに宣言された出力ファイルだけがワークスペースに戻り、既存ファイルは上書きされません。
## クラウドツール
| ツール | 用途 | 実行場所 |
| ---------------- | -------------------------------------------------- | --------------------------------- |
| `ct_cloud_read` | バケットの一覧やデプロイの詳細確認など、範囲を限定した読み取り専用の調査 | CloudThinker Sandbox |
| `ct_cloud_write` | ロールアウトの再起動など、名前を挙げられる状態変更コマンド 1 つ | ワークスペースの判断後に CloudThinker Sandbox |
| `ct_ask` | 過去インシデントの記憶、専門エージェント、依存関係のある複数手順など、ワークスペース自体が必要な作業 | Anna、リンクされた会話の中で |
`ct_ask` はセッションごとに Anna のスレッドを 1 つ開き、それを再利用します。`ct_run_status` は承認後に一時停止した実行を再開します。
## クラウド書き込みを承認する
クラウドへの書き込みは呼び出しではなく、ワークスペースが判断するリクエストです。エージェントが要求すると、ターミナルはエディターの上に理由、コネクション、コマンド、ブラウザーリンクを載せたカードを固定表示します。
| 結果行 | 意味 |
| ---------------------------------------------------------------------- | --------------------------------- |
| `auto: allowed (trusted command) · ran in CloudThinker Sandbox · 2.0s` | Auto Mode が許可し、その場で実行された |
| `auto: needs approval` | Auto Mode が人の判断を待って一時停止した |
| `manual: needs approval` | ワークスペースが Manual のため、すべての書き込みが停止する |
| `auto: escalated` | Auto Mode が中止してアラートを上げた。実行はされていない |
| `auto: denied` | ポリシーがブロックした。どの承認でも実行できない |
カードでは **Approve**、**Approve and trust this command**、**Decline** を選べます。Escape で拒否します。判断できるのは[承認者](/ja/guide/approval)だけで、承認者であるチームメイトにはブラウザーにも同じカードが表示されます。
**Approve and trust this command** はそのコマンドをワークスペースのポリシーに記録します。チャットの承認ダイアログにある Trust と同じものです。Auto ではそのコマンドは次回から停止せずに実行されます。Trust にはワークスペースのオーナーまたは管理者権限が必要です。
承認は、書き込みが要求された時点で選ばれていたコネクションをそのまま保持します。コネクションを追加しても保留中の書き込みの範囲は広がりません。アクセス権の削除や、選択済み ID の変更は実行をブロックします。書き込みの結果が不明と報告された場合は、再度要求する前に影響を確認してください。リクエストの再開はコマンドを自動で再実行しません。
## ターミナルでの Auto Mode
Auto Mode はワークスペースが持つ唯一の設定であり、ターミナルは独自のモードを持たず、それを表示するだけです。`/cloudthinker auto` で現在のモードを表示します。`/cloudthinker auto on` または `/cloudthinker auto off` でワークスペース全体を切り替えます。これにはワークスペース設定の編集権限が必要で、チャットでの切り替えと同様に記録されます。
セッション単位の上書きはなく、ノート PC から承認を迂回するフラグもありません。マシン上のローカルコマンドは CloudThinker のゲートを通らず、pi があなたとして実行します。
## 通知
Agent CLI のセッション自体は承認通知を送りません。カードはすでにターミナルとブラウザーの目の前にあるからです。セッションの `ct_ask` スレッドで Anna が出す承認についても同じです。
自分が承認者でない場合は、`/cloudthinker notify` を実行すると、[通知](/ja/guide/notifications)で設定されたチャネル宛に承認リクエストを 1 回だけ送れます。
## コマンド
| コマンド | 動作 |
| ------------------------------ | ------------------------------------- |
| `/cloudthinker about` | バージョン、pi のクレジット、設定ディレクトリ、セッションリンク |
| `/cloudthinker session` | このセッションのファイル数、メッセージ数、トークン数、最後に課金クレジット |
| `/cloudthinker auto [on\|off]` | ワークスペースの承認モードの表示または切り替え |
| `/cloudthinker notify` | 保留中の承認リクエストをワークスペースの承認者へ 1 回送信 |
| `/open` | このセッションをブラウザーで開く |
| `/cloud` | ワークスペース、コネクション、ミラーの状態を表示 |
`/model`、`/fork`、`/settings` など pi 自身のコマンドはそのまま使えます。`/share` と `/thinking` は削除されています。
## セッションミラー
すべてのセッションは **Agent CLI** 会話としてワークスペースにミラーされます。ブラウザーで開くと、リポジトリ、ブランチ、ツール呼び出し、リンクされた Anna スレッドを含む読み取り専用ビューアーが表示されます。セッションを所有するターミナルだけが書き手なので、誰も入力はできません。閲覧権限を持つワークスペースメンバーは読むことができ、削除できるのはワークスペースのオーナーだけです。
トランスクリプトは pi のセッションファイルとして自分のマシンに残ります。そのファイルを再開すると同じ会話が伸び、`/fork` は親を記録した新しい会話を開きます。
## クレジット
フッターはこのセッションに課金されたクレジットを表示します。例: `◆ 1.75 credits`。エージェントがモデルを通貨で価格表示することはありません。フッターにミラーの状態が追加されるのは、`✕ mirror offline, 3 pending` のように対応が必要なときだけです。
## 関連
CloudThinker CLI をインストールしてログイン
ワークスペースの Manual と Auto を選ぶ
承認者とツールの権限
Sandbox が使えるコネクションを設定する