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

# Olostep CLIをAIエージェントで使用する

> Claude Code、Cursor、Codexなどのコーディングエージェントがolostepコマンドを実行する方法。

AIコーディングエージェントは、他のコマンドと同様に`olostep`を実行できます。CLIは、コーディングエージェントがそれを実行するときに気付き、人ではなくプログラムのために動作します。

## 設定する

**1. CLIをインストールして自分でサインインする**

```bash theme={null}
curl -fsSL https://cli.olostep.com | sh
olostep login
```

エージェントはこのコンピュータでのあなたのサインインを使用します。CIでは、代わりに`OLOSTEP_TOKEN`を設定してください。[認証](https://docs.olostep.com/cli/authentication.md#scripts-ci-and-agents)を参照してください。

**2. エージェントにCLIガイドを提供する**

```bash theme={null}
olostep skill get olostep-cli --write .claude/skills
```

これにより、`.claude/skills/olostep-cli/SKILL.md`が書き込まれます：CLIの実行方法、終了コード、各コマンドのフラグとJSON出力スキーマ。エージェントのスキルフォルダを`.claude/skills`の代わりに使用してください。

**3. エージェントに--jsonを使用するように指示する**

エージェントは`--json`を使用してコマンドを実行し、JSONを読み取るべきです。人間向けの出力は人用であり、変更される可能性があります。

## エージェントに対するCLIの動作

CLIは、ターミナルがない場合、または`CLAUDECODE`、`CURSOR_AGENT`、`CODEX_CI`、`AI_AGENT`のいずれかが設定されている場合に、エージェントの実行として扱います。その場合：

* コマンドなしの`olostep`は、ウェルカム画面ではなくヘルプを表示します。
* プロンプトは表示されません。サインインが必要なコマンドはコード`3`で終了し、stderrでエージェントに`olostep login`を実行するか`OLOSTEP_TOKEN`を設定するように指示します。
* 削除または上書きする可能性のあるコマンドは、`--yes`を渡さない限りコード`4`で終了します。
* `olostep keys reveal`はキーを表示しません。`--write-env <file>`を使用してgitで無視されるenvファイルに保存してください。
* `olostep chat`はプレーンテキストとして返信を表示し（`--plain`がオン）、メッセージが必要です。
* アップデート通知は表示されません。

| 終了コード | エージェントがすべきこと |
| - | - |
| `0` | 出力を読む。 |
| `1` | stderrのエラーを読む。 |
| `2` | `olostep <command> --help`でコマンドを確認する。 |
| `3` | 人に`olostep login`を実行するよう依頼する。 |
| `4` | 人と確認してから`--yes`で再実行する。 |
| `5` | サーバーに接続できませんでした。後で再試行してください。 |

## 適切なコマンドを見つける

```bash theme={null}
olostep help monitor pause        # 名前または説明にすべての単語が含まれるコマンド
olostep tools --search crawl      # "crawl"を言及するツール
olostep tools crawl_create        # 1つのツールの完全な入力と出力スキーマ
```

## `olostep skill`

スキルは、1つのタスクのための短い指示です。リスト化、読み取り、またはエージェントのスキルフォルダに書き込むことができます：

```bash theme={null}
olostep skill list
olostep skill get credit-usage
olostep skill get olostep-cli dashboard --write .claude/skills
olostep skill get olostep-cli --json
```

| スキル | カバーする内容 |
| - | - |
| `olostep-cli` | `olostep`コマンドラインの使用方法。CLIのコマンドから生成されます。 |
| `credit-usage` | クレジット残高、プラン、クレジットの有効期限、日次使用量。 |
| `dashboard` | ダッシュボード機能：アカウント、請求、チーム、APIキー、ログ、ジョブ、パーサー、モニター、エージェント、サポート、統合。 |

`olostep skill list`は現在のリストを表示します。フラグについては[`olostep skill`](https://docs.olostep.com/cli/reference/cli-commands#olostep-skill)を参照してください。

## `olostep tools`

すべてのCLIコマンドはOlostepサーバー上のツールを呼び出します。`olostep tools`はそれらをリストし、変更を加えるものをマークします：

```bash theme={null}
olostep tools
olostep tools --json
```

## フィードバックを提供する

コマンドが失敗したり、欠落していたり、混乱している場合、エージェントはOlostepチームに伝えることができます。これはサインインなしで動作します：

```bash theme={null}
olostep feedback --about tooling --message "crawl create rejected --depth 0"
```

CLI自体には`--about tooling`を、Olostepには`--about product`を使用してください。キー、パスワード、個人情報を含めないでください。

## ターミナルの代わりにMCP

エージェントがMCPをサポートしている場合、直接Olostepに接続できます。[MCPサーバー](https://docs.olostep.com/integrations/mcp-server.md)を参照するか、クライアントのセットアップを印刷してください：

```bash theme={null}
olostep integrations config --client claude_code
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.