結論
Warp(ワープ)とは、コマンドと出力を「ブロック」単位で区切って扱え、AI のエージェント(Warp Agent)にコマンドの実行やコードの修正を頼めるターミナルアプリです。macOS・Windows・Linux に対応し、Free プラン($0)から使えます。サインインは任意で、Mac は brew install --cask warp、Windows は winget install Warp.Warp で入れられます。2026年11月18日時点の公式の説明では、Warp は「オープンソースの Agentic Development Environment」と位置づけられ、ターミナルの名前は「Warp Terminal」です。
この記事でわかること
- Warp とは何か、対応 OS・シェル、OS 別のインストールとアンインストール
- ブロック・入力エディタ・コマンドパレット・AI の機能と料金プラン
- テーマの YAML と settings.toml を手元で点検した結果と、症状表・判断表
この記事で実際に動かしたものは、公式ドキュメントに載っているテーマの YAML・settings.toml・ワークフローの YAML を読み込んで項目と形を点検する Python と、rc ファイルで Warp を見分ける bash の条件文です。Warp 本体の操作は公式の記載どおりに書いています。Warp の中でコマンドとエージェントがどうつながるかを先に図で示します。
flowchart TD
I[入力エディタ] -->|Enter| S[シェル<br>bash zsh fish pwsh]
S --> B[ブロック<br>コマンドと出力]
I -->|Cmd+I / Ctrl+I| A[Warp Agent]
A --> P{権限の設定<br>聞く or 任せる}
P -->|許可| S
B -->|出力を読む| A
よく調べられることの答えを先にまとめます。
| 知りたいこと | 答え | 詳しい節 |
|---|---|---|
| Warp terminal とは | ブロックで出力を区切り、AI のエージェントも使えるターミナル。クライアントはオープンソース | Warpとは |
| Warp の対応 OS | macOS(10.14 以降・Metal 対応)、Windows(x86_64・ARM64)、Linux(x86_64・ARM64) | 対応OSとシェル |
| Warp のインストール | Mac は brew、Windows は winget、Linux は .deb・.rpm・AppImage | インストール |
| サインインは必要? | 任意。初回の起動時だけネット接続が要り、その後はオフラインでも動く(AI は使えない) | インストール |
| Warp は無料? | Free は $0。Build $20/月、Max $200/月、Business $50/席・月 | 料金プラン |
| AI の使い方 | Cmd+I(Windows・Linux は Ctrl+I)で Agent Mode。コマンドの実行は権限の設定しだい | AI機能 |
| Warp の日本語 | 画面の表示は英語のみ。日本語の文字は出力と入力欄で表示できる | 症状表 |
| テーマ・設定の場所 | テーマは YAML、設定は settings.toml(保存すると即反映) | テーマとsettings.toml |
| Windows Terminal・iTerm2 との違い | ブロックと AI が組み込み。iTerm2 は Mac 専用・GPL v2 の無料ソフト | 違い |
確認環境:製品の位置づけ・対応 OS・インストール・機能・ショートカット・料金・データの扱いは、Warp の公式サイト(warp.dev・料金のページ)と公式ドキュメント(docs.warp.dev)、GitHub の warpdotdev/warp の README を1ページずつ読んで照合しました(参考・出典の各ページ)。比べる相手は、iTerm2 の公式サイトと Microsoft Learn の Windows Terminal のドキュメントで確かめています。手元では Ubuntu 24.04.5 LTS・Python 3.13.18(PyYAML 6.0.3・標準の tomllib)・GNU bash 5.2.21 で、公式ドキュメントに載っているテーマの YAML・settings.toml・ワークフローの YAML をファイルに写して読み込み、必須の項目・色の形・文字と背景のコントラスト比を点検しました。Warp はデスクトップアプリで、この環境には画面が無いため、Warp 本体の動作はこの環境では確かめていません。サインイン・AI のモデルの呼び出し・課金もしていません。公式のテーマ集(GitHub の warpdotdev/themes)の一括取得は、この環境の接続の制限で拒否されたため、公式ドキュメントに載っている見本だけで点検しています。公式ページは取得ツールで読んだため、画面の名前は取得した文面にそのまま出た英語の語だけを「」で書いています。図は mermaid 11.16.0 で描画を確かめました(確認日 2026年11月18日)。
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「Warpとは|AIつきターミナルの使い方・料金・インストール」
Warpとは(AIつきターミナル・今の位置づけ)
この節では、Warp がどんなアプリで、2026年11月時点で提供元がどう位置づけているのかが分かります。
Warp は、ターミナル(コマンドを打つ画面)に、ブロック・IDE のような入力欄・AI のエージェントを組み込んだアプリです。公式ドキュメントのトップは Warp を「open-source Agentic Development Environment」と説明し、GitHub の README は「an agentic development environment, born out of the terminal」(ターミナルから生まれた、エージェントで開発する環境)と書いています。
1ブロック
1回のコマンドとその出力を1つのまとまりにする。まとまりごとにコピー・検索・共有・再実行ができる。
2入力エディタ
マウスでカーソルを置ける、複数行を編集できるなど、コードエディタのような入力欄。
3Warp Agent
公式の説明は「Warp's built-in coding agent」。複数の手順の作業を進め、コマンドを実行して出力を読み、次の手を決める。
製品の構成(2026年11月18日時点)
公式サイトでは、Warp の製品として次のものが並んでいます。この記事で扱うのは、主に Warp Terminal です。
| 名前 | 公式の説明(要旨) | この記事での扱い |
|---|---|---|
| Warp Terminal | AI を使う開発のために作られた、オープンソースのターミナル | 中心に扱う |
| Warp Agent CLI | どのターミナルでも動くコーディングエージェント。warp コマンドで会話を始める |
名前と削除の方法だけ |
| Warp Factories | ソフトウェア開発を自動で進める仕組み。早期アクセス(申し込み制) | 料金の表に名前だけ |
オープンソースになった範囲
GitHub の README によると、Warp のクライアントのコードは warpdotdev/warp で公開されており、UI のフレームワーク(warpui_core と warpui)は MIT ライセンス、それ以外は AGPL v3 です。インストールの公式ページは、ソースからビルドした warp-oss は自動更新が無く、普段使いには公式のビルドを使うよう案内しています。ライセンスの条件を自分の使い方に当てはめるときは、提供元の README とライセンスの原文を確かめることを勧めます(社内で配布する場合は所属先の決まりも確かめます)。
Warpの対応OSとシェル
この節では、Warp が動く OS と、中で使えるシェルの種類が分かります。
Warp は macOS・Windows・Linux で動き、シェルは bash・zsh・fish・PowerShell が中心です。公式のインストールのページの記載は次のとおりです。
| OS | 対応(公式の記載) | 使えるシェル |
|---|---|---|
| macOS | Intel・Apple シリコン。macOS 10.14 以降、Metal に対応したハードウェア | bash・fish・zsh・PowerShell(pwsh) |
| Windows | x86_64・ARM64(最小の版はページに記載なし) | PowerShell 7(既定)・PowerShell 5・WSL2・Git Bash |
| Linux | x86_64・ARM64。Debian/Ubuntu、RHEL/Fedora/CentOS、Arch、openSUSE/SLE の系統 | bash・fish・zsh・PowerShell(pwsh) |
- fish は 3.6 以上、macOS の PowerShell は 7.0 以上を入れるよう案内されています。
- ログインシェルが対応していない場合は、案内の帯を出して既定のシェル(macOS は zsh、Windows は PowerShell、Linux は bash)を読み込みます。
- Windows のコマンド プロンプト(cmd)の扱いはページによって記載が違います。「Supported shells」のページは「Windows Command Prompt (cmd.exe) is not currently supported.」と書き、「Windows Terminal から移る」ページは対応するシェルに Command Prompt(cmd)を挙げています。cmd を主に使う場合は、使う版のリリースノートと画面で確かめます。
起動時のシェルは「Settings」→「Features」→「Session」の「Startup shell for new sessions」で選びます。変更は新しいセッションから効きます。
Warpのインストール(Mac・Windows・Linux)とサインイン
この節では、OS ごとの Warp の入れ方と、初回の起動で何を聞かれるか、アンインストールの方法が分かります。
公式のダウンロードページから入れるか、OS のパッケージ管理のコマンドで入れます。公式ページは、Linux では依存するライブラリも入る、パッケージでの導入を AppImage より勧めています。
# macOS(Homebrew)
brew install --cask warp
# Windows(WinGet)
winget install Warp.Warp
# Debian / Ubuntu(ダウンロードした .deb)
sudo apt install ./<file>.deb
# RHEL / Fedora / CentOS(ダウンロードした .rpm)
sudo dnf install ./<file>.rpm
# Arch 系(ダウンロードしたパッケージ)
sudo pacman -U ./<file>.pkg.tar.zst
# Linux で起動する
warp-terminal
上のコマンドは公式ドキュメントの記載を写したもので、この環境では実行していません。どの入れ方でも自動更新が入り、Linux の .deb と .rpm は更新用に Warp のリポジトリが設定されます。
初回の起動の流れ
Warp を開く
Mac はアプリケーションフォルダ、Windows はスタートメニュー、Linux はデスクトップのメニューか warp-terminal で開く。
サインアップするか飛ばす
ログインは任意。あとから「Settings」→「Account」の「Sign up」でも登録できる。Google・GitHub で登録した場合、Warp が受け取るのはメールアドレスだけと公式に書かれている。
前のターミナルの設定を取り込む
iTerm2 などから移る場合は、公式の「Migrate to Warp」の手順で取り込む(違いの節を参照)。
起動時のシェルを選ぶ
「Settings」→「Features」→「Session」の「Startup shell for new sessions」。Warp はまずログインシェルを試す。
ネット接続が要るのは初回の起動のときだけです。その後はオフラインでも動きますが、AI の機能とリアルタイムの共同作業の機能は使えません。
アンインストール(設定も消す場合)
公式の「Logging Out & Uninstalling」のページでは、アプリを消したあと、設定・ログ・データのフォルダーも消す手順が OS ごとに載っています。次のフォルダーにはテーマやワークフローも入っているため、残したいファイルは先に別の場所へ写します(消すと元に戻せません)。
| OS | アプリを消す | 設定・データの場所(公式の記載) |
|---|---|---|
| macOS | brew uninstall warp かゴミ箱へ |
~/.warp、Application Support の中の dev.warp.Warp-Stable、ログ |
| Windows | コントロールパネルの「Installed apps」 | %LOCALAPPDATA%\warp\Warp、%APPDATA%\warp\Warp、%USERPROFILE%\.warp |
| Linux | sudo apt remove warp-terminal など入れたときと同じ道具 |
~/.config/warp-terminal、~/.local/state/warp-terminal、~/.local/share/warp-terminal、~/.warp |
Linux のフォルダーは公式ページでは ${XDG_CONFIG_HOME:-$HOME/.config} のように書かれています。手元の bash で、環境変数がある場合と無い場合に実際どこを指すかを展開しました。
$ env -i HOME=/home/u bash -c 'echo ${XDG_DATA_HOME:-$HOME/.local/share}/warp-terminal/themes/'
/home/u/.local/share/warp-terminal/themes/
$ env -i HOME=/home/u XDG_DATA_HOME=/data/u bash -c 'echo ${XDG_DATA_HOME:-$HOME/.local/share}/warp-terminal/themes/'
/data/u/warp-terminal/themes/
XDG_DATA_HOME を自分で設定している場合は、テーマもそちらの下を探します。Warp Agent CLI は本体とは別に入るため、Homebrew で入れた場合は brew uninstall --cask warp-agent-cli で別に消します。
Warpの使い方①ブロック(コマンドと出力のまとまり)
この節では、Warp のいちばんの特徴であるブロックで何ができるのかが分かります。
ブロックは、1回のコマンドとその出力を1つの単位にしたものです。公式の説明は「A Block groups commands and outputs into one atomic unit.」です。ふつうのターミナルでは出力が1本の長い文字の流れになりますが、Warp ではコマンドごとに区切られます。
- コマンドだけ、出力だけをコピーする(ブロックの右クリックのメニューから)
- 出力の先頭へ移る、コマンドを再実行する
- 書式を保ったまま、コマンドと出力を共有する
- ブロックの中を検索する、行を絞り込む(Block find・Block filtering)、しおりを付ける
直前のブロックを選ぶのは ⌘+↑(Windows・Linux は Ctrl+↑)です。選んだブロックの中のスクロールは ⌘+Shift+↑/↓(Windows・Linux は Ctrl+Shift+↑/↓)です。
長い出力の一部を人に見せるとき
共有の機能は提供元のサーバーに内容を置く。扱う情報は所属先の決まりを先に確かめる
Warpの使い方②入力エディタ・コマンドパレットとショートカット
この節では、Warp の入力欄の操作と、よく使うショートカットが OS ごとに分かります。
Warp の入力欄は、コードエディタのようにクリックでカーソルを置け、複数行を書けます。改行は Shift+Enter・Ctrl+Enter・Option+Enter で入れます。かっこや引用符の自動の閉じは「Settings」→「Features」→「Text Editing」で切り替えられ、Vim のキー操作も同じ場所の「Edit code and commands with Vim keybindings」で有効にできます。
| 操作 | macOS | Windows・Linux |
|---|---|---|
| コマンドパレット | ⌘+P | Ctrl+Shift+P |
| 設定を開く | ⌘+, | Ctrl+, |
| 新しいタブ | ⌘+T | Ctrl+Shift+T |
| 画面の分割 | ⌘+D(右)・Shift+⌘+D(下) | Ctrl+Shift+E(下) |
| 履歴の検索(Command Search) | Ctrl+R | Ctrl+R |
| Agent Mode に切り替える | ⌘+I | Ctrl+I |
| 検索(Find) | ⌘+F | Ctrl+Shift+F |
| 画面を消す | ⌘+K(ブロックを消す)・Ctrl+L | Ctrl+L |
表は公式の「Keyboard shortcuts」「Block basics」「Modern text editing」と、移行のページ(Agent Mode の ⌘+I・Ctrl+I)から写しました。キーは「Settings」→「Keyboard shortcuts」で変えられます。
コマンドパレットの絞り込み
コマンドパレットは、ワークフロー・ノートブック・ショートカット・設定・セッションなどをまとめて探す入口です。検索語の前に接頭語を付けると対象を絞れます。
| 接頭語 | 探す対象 |
|---|---|
workflows: または w: |
ワークフロー |
prompts: または p: |
プロンプト |
notebook: または n: |
ノートブック |
files: |
手元のファイル |
actions: |
Warp の設定と機能 |
sessions: |
開いているセッション |
WarpのAI機能(Warp Agent・Agent Mode・権限の設定)
この節では、Warp の AI の機能の名前と、エージェントがどこまで自分で動くのかを決める設定が分かります。
Warp の AI の中心は、組み込みのコーディングエージェント「Warp Agent」です。⌘+I(Windows・Linux は Ctrl+I)で Agent Mode に切り替え、ふだんの言葉で作業を頼みます。エージェントはコマンドを実行して出力を読み、次の手を決めます。
| 公式の名前 | 何をするか(公式の説明の要旨) |
|---|---|
| Warp Agent | 複数の手順の作業を進め、ターミナルでコマンドを実行し、出力を読んで次を決める |
| Warp Agent CLI | warp コマンドで、ほかのターミナルや SSH の先でも会話を始める |
| Cloud agents | きっかけ・予定・連携から、裏で動くエージェント |
| 他社の CLI エージェント | Claude Code・Codex・OpenCode などを Warp の入力欄と通知つきで使える |
| Codebase Context・Rules・Skills・MCP | コードの索引、決まりの指示、手順のまとまり、外部の道具とのつなぎ込み |
モデルは「Model choice」のページで選ぶ形で、自分の API キー(Bring Your Own API Key)や独自の推論の接続先も使えると書かれています。使えるモデルの一覧は変わるため、この記事では書かず、公式のページで確かめることを勧めます。
エージェントの権限(Agent Profiles)
エージェントは、コマンドの実行・ファイルの編集・MCP の呼び出しの前に確認を求めます。どこまで任せるかは「Settings」→「Agents」→「Profiles」で、操作の種類ごとに決めます。
- 1自律の度合いは4段階「Agent Decides」「Always ask」「Always allow」「Never」から選ぶ
- 2操作の種類ごとに分けて決めるコード差分の適用・ファイルの読み取り・計画・コマンドの実行・動いているコマンドへの入力・質問
- 3拒否リストが最優先既定で wget・curl・rm・eval が入り、ほかの許可の設定より優先される。許可リストは既定で空
- 4最後まで任せるのは明示の操作だけ「Run until completion」は ⌘+Shift+I(Windows・Linux は Ctrl+Shift+I)で、操作を自動で許可する
エージェントが作った変更は、コードレビューの画面で差分を見てから受け入れられます。AI に任せる範囲を広げる前に、拒否リストに消したくない操作(削除や外部への送信)が入っているかを見ておくと安心です。AI のエージェントの考え方そのものは、関連記事「AIエージェントとは|仕組みとワークフローとの違い・作り方入門」で扱っています。
Warpの料金プラン(2026年11月18日時点)
この節では、Warp の各プランの料金と、AI の利用分の数え方が分かります。
ターミナルの機能は Free($0)で使え、AI のエージェントの利用分を含むのは有料プランです。料金のページの記載を、2026年11月18日時点で写しました。
| プラン | 料金(月額の表示) | 含まれるエージェントの利用分 | 主な内容 |
|---|---|---|---|
| Free | $0 | なし(従量で追加・自分の推論の接続) | ターミナルの機能、Warp Agent CLI、共有の Warp Drive はワークフロー10件・ノートブック3件まで |
| Build | $20(低いほうの表示 $18) | 月 $20 分(API の料金で換算) | Warp Agent の全機能、索引できるコードベース40件 |
| Max | $200(同 $180) | 月 $200 分(Build の10倍) | Build の内容を含む |
| Business | $50/席(同 $45)、25席まで | 1席ごとに月 $20 分 | SAML の SSO、管理者のデータの設定、自分の API キー |
| Enterprise | 個別の見積もり | 個別 | 自社のクラウドを通す推論、席数の上限なし |
料金のページには「Monthly」「Annual」の切り替えがあり、Build・Max・Business では高いほうと低いほうの2つの額が表示されます。低いほうが年払いの額と読めますが、ページにはどちらがどちらかの明記がありませんでした。2つの額の差を Python で計算しました。
プラン 月額×12 低い額×12 差 割合
Build 240 216 24 10%
Max 2400 2160 240 10%
Business(1席) 600 540 60 10%
Business 5席: 月 $250/低い額 $225、含まれる利用額 $100/月
Business 10席: 月 $500/低い額 $450、含まれる利用額 $200/月
- 利用分はリクエストの回数ではなく金額(ドル)で数えます。含まれる利用分は、契約か更新の日から30日ごとに戻ります。年払いでも毎月戻ると、プランの説明のページに書かれています。
- 追加で買った利用分はチームで共有され、翌月へ持ち越せて、12か月有効です。管理者は使う額の上限を決められます。
- 支払いはクレジットカードのみ(Stripe)と書かれています。返金の条件(月払いは24時間以内かつ未使用など)は、プランの説明のページにあります。
- このほか、Warp Factories には Start($0+従量)・Scale(チームで月 $250+従量)・Enterprise のプランがあります。
Warpのデータの扱いとプライバシーの設定
この節では、Warp が何を送り、どこで止められるのかを、提供元の説明に沿って分かります。
送る情報の多くは「Settings」→「Privacy」の「Help improve Warp」と「Send crash reports」で止められます。以下は提供元(Warp)の説明をまとめたもので、安全性や情報の扱いを保証するものではありません。機密情報や個人情報を扱う前に、提供元の最新のプライバシーの説明・規約と、所属先の決まりを確かめることを勧めます。
| 項目 | 提供元の説明(要旨) | 出典 |
|---|---|---|
| 利用状況の分析 | 「Help improve Warp」がオンなら、機能の使われ方の大まかな数値を集める。利用者が作った内容は含まないと説明 | docs の Privacy |
| AI とコンソールの入力 | オンなら AI のやり取りと、AI の機能に使うコンソールの入力を集めることがある。オフならコンソールのやり取りはサーバーに保存されない | docs の Privacy |
| Free の AI | AI の機能を使うには、この設定をオンにする必要がある。有料プランはオフでも AI を使える | docs の Privacy |
| ZDR(データを保持しない契約) | Business・Enterprise は対象。対象は Warp が提供する推論だけ | docs の Privacy・料金のページ |
| 秘密情報の伏せ字 | Secret Redaction は既定でオフ。オンにすると、AI へ送る前に指定の形の文字を伏せる | docs の Privacy |
- 送っている内容は、Warp の「Network Log」で見られると説明されています。
- Codebase Context のページは、コードは Warp のサーバーに保存されないと説明しています。
- warp.dev のプライバシー通知には、集めたデータを AI の機能のモデルの改善に使うことがあるとの記載があります。設定とあわせて、通知の本文も読むことを勧めます。
Warpのテーマ(YAML)とsettings.tomlの書き方(手元で点検した結果)
この節では、Warp の見た目と設定を決めるファイルの形と、書き間違えたときに何が起きるかが、実際に読み込んだ結果で分かります。
テーマは YAML のファイル、設定は settings.toml(TOML 形式)です。ファイルの場所は公式ドキュメントで次のとおりです。
| OS | テーマのフォルダー | settings.toml |
|---|---|---|
| macOS | $HOME/.warp/themes/ |
~/.warp/settings.toml |
| Linux | ~/.local/share/ の下の warp-terminal/themes/ |
~/.config/ の下の warp-terminal/settings.toml |
| Windows | %APPDATA%\warp\Warp\data\themes\ |
%LOCALAPPDATA%\warp\Warp\config\settings.toml |
テーマの YAML の項目
公式の見本には、name・accent・cursor(省略すると accent と同じ色)・background・foreground・details(暗いテーマは darker、明るいテーマは lighter)・terminal_colors(normal と bright に各8色、計16色)があります。色は16進で、# で始めると書かれています。公式の見本の一部です。
name: Custom Theme
accent: '#268bd2'
cursor: '#95D886'
background: '#002b36'
foreground: '#839496'
details: darker
terminal_colors:
bright:
black: '#002b36'
# …ほか7色
normal:
black: '#073642'
# …ほか7色
この見本と、わざと1か所だけ崩したファイルを、自作の点検スクリプト(PyYAML で読み込み、必須の項目・16色・色の形・WCAG の式によるコントラスト比を見るもの)にかけました。
== custom_theme.yaml
name='Custom Theme' 色の数=16/16 cursor=あり
OK 必須の項目と色の形
文字と背景のコントラスト比 4.75:1
背景との比が3未満の色: normal.black #073642 1.15, bright.black #002b36 1.00, bright.green #586e75 2.79
== bad_noquote.yaml
name='Custom Theme' 色の数=16/16 cursor=あり
NG accent: 16進の色(#で始まる)ではない → None
== bad_missing.yaml
name='Custom Theme' 色の数=15/16 cursor=あり
NG terminal_colors.normal.yellow: 項目がない
== bad_nohash.yaml
name='Custom Theme' 色の数=16/16 cursor=あり
NG background: 16進の色(#で始まる)ではない → '002b36'
1色は引用符で囲む
accent: #268bd2 と書くと、YAML では # から後ろがコメントになり、値は空(None)になった。公式の見本どおり '#268bd2' と囲む。
216色はそろえる
normal と bright の8色ずつを1つでも書き忘れると、点検で15/16になった。他のテーマから写すときに抜けやすい。
3背景と同じ色に注意
公式の見本は bright.black が背景と同じ #002b36(比 1.00)で、その色で出る文字は背景に溶ける。好みで変えるときの目安になる。
背景画像は background_image の path(テーマのフォルダーからの相対パス)と opacity(0〜100。必須)で指定し、形式は .jpg・.jpeg だけと書かれています。accent と background は left・right か top・bottom の組でグラデーションにできます。置いたテーマは「Settings」→「Appearance」→「Themes」か、コマンドパレットの「Open Theme Picker」から選びます。新しいフォルダーを最初に見つけるまで数分かかることがあり、その後の変更は数秒で反映されると説明されています。
settings.toml の点検
公式の見本の settings.toml を Python 標準の tomllib で読み込み、値の型を出しました。続けて、よくある書き間違いを3つ作って読み込んだときのエラーの原文です。
== settings.toml
[appearance.text] font_name='JetBrains Mono'(str), font_size=14.0(float), line_height_ratio=1.3(float)
[appearance.themes] theme='dracula'(str)
[terminal.input] syntax_highlighting=True(bool), honor_ps1=False(bool)
[agents.profiles] agent_mode_execute_readonly_commands=True(bool)
== bad1.toml
NG TOMLDecodeError: Invalid value (at line 2, column 13)
== bad2.toml
NG TOMLDecodeError: Cannot overwrite a value (at line 3, column 17)
== bad3.toml
NG TOMLDecodeError: Expected newline or end of document after a statement (at line 2, column 15)
| ファイル | 書き間違い | 直し方 |
|---|---|---|
| bad1.toml | font_name = JetBrains Mono(文字列を引用符で囲んでいない) |
"JetBrains Mono" と囲む |
| bad2.toml | 同じ表の中で font_size を2回書いた |
1つにまとめる |
| bad3.toml | font_size = 14,0(小数点をカンマで書いた) |
14.0 と書く |
Warp は settings.toml を見張っていて、保存するとすぐ反映され、再起動は要らないと説明されています。設定画面での変更もこのファイルに書き込まれます。公式ページは TOML v1.1 と書いており、手元の tomllib(TOML 1.0 の対応)では、1.1 で増えた書き方を読めない場合がある点に注意します。エディタでの入力補完には、アプリに同梱の settings_schema.json(Linux は /opt/warpdotdev/warp-terminal/resources/ の下)が使えると書かれています。
ワークフロー(YAML)とコマンドの穴埋め
ワークフローは、よく使うコマンドを名前つきで保存する機能です。公式は Warp Drive のワークフローを勧めつつ、YAML のワークフローも使い続けられると書いています。name と command が必須で、{{string}} のような穴を arguments で説明し、default_value で既定値を入れられます。公式の見本に既定値を足したものと、穴の定義を1つ忘れたものを点検しました。
== workflow.yaml
name: あり
command: あり
{{string}}: arguments にあり
既定値を入れたコマンド: echo hello
== bad_workflow.yaml
name: あり
command: あり
{{pattern}}: arguments にあり
{{file}}: NG arguments に定義がない
既定値を入れたコマンド: grep {{pattern}} {{file}}
ワークフローは Ctrl+Shift+R で開く検索の画面から選び、Shift+Tab で穴を順に移ります。リポジトリの .warp/workflows に置くと、Git でチームと共有できます。シェルスクリプトにまとめるほうが向く長い処理は、関連記事「シェルスクリプトの書き方|基本構文の早見表と安全なテンプレート」で扱っています。
WarpとWindows Terminal・iTerm2の違い
この節では、Warp と、よく比べられる Windows Terminal・iTerm2 の違いが、事実の並びで分かります。
大きな違いは、ブロックと AI のエージェントが最初から組み込まれているかどうかです。どれが合うかは使い方で変わるため、優劣ではなく事実を並べます。
| 項目 | Warp | Windows Terminal | iTerm2 |
|---|---|---|---|
| 動く OS | macOS・Windows・Linux | Windows | macOS(10.14 以降) |
| 料金 | Free $0。AI の利用分は有料プラン | 無料(Microsoft の公式アプリ) | 無料(GPL v2) |
| 出力の区切り | ブロック | ふつうの流れ | ふつうの流れ |
| AI の組み込み | Warp Agent | 公式ページに記載なし | 公式サイトのトップに記載なし |
| 設定の形 | settings.toml・テーマの YAML | settings.json | アプリの設定(plist に保存) |
iTerm2 から移る
コマンドパレットの「Import External Settings」から取り込む
入る:配色・フォント・既定のシェル・透明度・ホットキーなど
入らない:既定以外のプロファイル・独自のキー・画面の分割・Triggers
Windows Terminal から移る
ワンクリックの取り込みは無いと公式に記載
シェル・フォント・配色を Warp の設定で1つずつ合わせる
配色は同じ16色の値で Warp のテーマを作る
Windows Terminal の配色を Warp のテーマに写す(実行例)
Microsoft Learn に載っている Windows Terminal の配色「Campbell」の JSON を、Warp のテーマの YAML に写すスクリプトを書いて実行しました。Windows Terminal の purple は Warp の magenta に当たります。accent は Windows Terminal の配色に無いため、ここでは brightBlue を使いました(この割り当ては筆者の選択です)。
name: Campbell (from Windows Terminal)
accent: '#3b78ff'
cursor: '#ffffff'
background: '#0c0c0c'
foreground: '#cccccc'
details: darker
terminal_colors:
bright:
black: '#767676'
blue: '#3b78ff'
cyan: '#61d6d6'
green: '#16c60c'
magenta: '#b4009e'
red: '#e74856'
white: '#f2f2f2'
yellow: '#f9f1a5'
normal:
black: '#0c0c0c'
blue: '#0037da'
cyan: '#3a96dd'
green: '#13a10e'
magenta: '#881798'
red: '#c50f1f'
white: '#cccccc'
yellow: '#c19c00'
できた YAML を同じ点検にかけると「OK 必須の項目と色の形」、文字と背景のコントラスト比は 12.18:1 でした。背景との比が3未満の色は normal の black(1.00)・blue(2.38)・magenta(2.44)です。Windows Terminal そのものの使い方は、別の記事「Windows Terminalとは|使い方・設定・既定のターミナルにする方法」で扱います。PowerShell のコマンドは、関連記事「PowerShellコマンド一覧|用途別50選とbash対応表・実行例付き」で扱っています。
Warpがうまく動かないときの症状表(よくあるエラー・つまずき)
この節では、Warp で起きやすい症状と、公式の「Known Issues」などに書かれた直し方が分かります。
多くの症状は、シェルの rc ファイル(.zshrc・.bashrc など)のプラグインやプロンプトの設定がきっかけです。公式は、Warp がシェルの機能の一部を自分で受け持つため、いくつかのツールやプラグインと相性が合わないと説明しています。
| 症状 | 原因(公式の説明) | 直し方 |
|---|---|---|
| プロンプトや補完が崩れる | oh-my-zsh のテーマやプラグイン(zsh-autosuggestions など)、Starship の設定、Python の仮想環境の PS1 などが合わない | rc ファイルを外して起動し、合わない部分を Warp では読まない条件で囲む |
| Tab の補完がおかしい | bindkey 'tab' autosuggest-accept |
その行を外す |
| SSH の先でブロックにならない | SSH のラッパーの関数で動いている | 「Settings」→「Features」でラッパーの設定を見る |
ssh: connect to host <host_name> port 22: Undefined error: 0(macOS) |
ローカルネットワークへの接続の許可が無い | システム設定のプライバシーとセキュリティの「Local Network」に Warp を足す |
| Linux で描画が乱れる(NVIDIA) | ドライバーの版 | 公式は 535.x 以下を勧める。WGPU_BACKEND=gl を付けて起動して試す |
warp.log に Unrecognized device error ERROR_INITIALIZATION_FAILED |
GPU の初期化に失敗 | user_preferences.json の prefs に "PreferLowPowerGPU": "true" |
| 画面が開かず「SQLite error 283」 | セッション復元のデータベース | 公式の案内の場所のデータベースの名前を変える |
| 画面の文字が英語だけ | UI は英語のみ | 日本語の文字は出力と入力欄で表示できる。日本語入力の不具合は GitHub の issue で現状を見る |
| AI が使えない | オフライン、または Free で「Help improve Warp」がオフ | 接続を確かめる。Free は設定の条件を見る |
rc ファイルで Warp を見分ける(実行例)
公式は、合わない設定を TERM_PROGRAM が WarpTerminal のときだけ読まないよう囲む方法を示しています。同じ条件文を手元の bash で、環境変数を変えて実行しました。
if [[ $TERM_PROGRAM != "WarpTerminal" ]]; then
echo "Warp 以外: プラグインを読み込む"
else
echo "Warp: プラグインを読み込まない"
fi
$ env -i PATH=/usr/bin:/bin bash --norc rc_sample.sh
Warp 以外: プラグインを読み込む
$ env -i PATH=/usr/bin:/bin TERM_PROGRAM=WarpTerminal bash --norc rc_sample.sh
Warp: プラグインを読み込まない
$ env -i PATH=/usr/bin:/bin TERM_PROGRAM=iTerm.app bash --norc rc_sample.sh
Warp 以外: プラグインを読み込む
実際の Warp が TERM_PROGRAM に入れる値は公式の記載(WarpTerminal)に合わせており、Warp の上では動かしていません。fish と pwsh にも同じ考えの書き方があると公式に書かれています。tmux と組み合わせる場合の相性は既知の問題のページに詳しい記載が無く、tmux の操作そのものは関連記事「tmuxの使い方|キーバインド早見表とコピペ用.tmux.conf」で扱っています。
切り分けの順番
- 1Warp を再起動し、最新の版にするどの入れ方でも自動更新が入る
- 2rc ファイルを外して起動する直れば rc の中に原因がある
- 3合わない部分を WarpTerminal の条件で囲むプラグイン・プロンプトの設定から
- 4描画の問題は GPU のバックエンドを変えて試すLinux は WGPU_BACKEND=gl、Windows は vulkan,gl
- 5公式の Known Issues と GitHub の issue を見る同じ症状の報告と回避の方法を探す
Warpを使うかの判断表
この節では、どんなときに Warp が合い、どんなときに他のターミナルのままが合うかの目安が分かります。
AI のエージェントをターミナルの中で使いたいか、OS をまたいで同じ道具をそろえたいかで決まります。
| 状況 | 目安 | 理由 |
|---|---|---|
| ターミナルで AI に作業を頼みたい | Warp を試す | Warp Agent と権限の設定が組み込み |
| Claude Code などの CLI エージェントを使っている | どちらでも動く。通知や入力欄の支援がほしければ Warp | Warp は他社の CLI エージェントに対応と記載 |
| Mac・Windows・Linux で同じターミナルを使いたい | Warp が合う | 3つの OS に公式のビルドがある |
| ネットにつながらない環境が中心 | ターミナルの機能だけなら使える | 初回の起動後はオフラインで動く。AI は使えない |
| cmd を主に使う Windows | 先に試して確かめる | 公式ページの間で cmd の記載が違う |
| 社外に送れない情報を扱う | 先に所属先の決まりと提供元の説明を確かめる | AI の送信と共有の機能はサーバーを使う |
| tmux や重いプラグインに頼っている | 今のまま使い続け、Warp は並べて試す | rc の相性で崩れることがある |
Claude Code を Warp の中で使う場合の Claude Code 側の操作は、関連記事「Claude Code 使い方|最初の30分と113コマンド【2026年11月】」で扱っています。
よくある質問
この節では、Warp について検索でよく調べられる疑問への短い答えが分かります。
Q. Warp は無料で使えますか?
Free プランは $0 で、ターミナルの機能と Warp Agent CLI が使えます。エージェントの利用分は含まれず、従量で足すか、自分の推論の接続先を使います(2026年11月18日時点)。
Q. Warp はログインしないと使えませんか?
ログインは任意です。初回の起動時にネット接続が要り、その後はオフラインでも動きます(AI とリアルタイムの共同作業は使えません)。
Q. Warp は Windows で使えますか?
使えます。winget install Warp.Warp か公式のインストーラーで入れます。x86_64 と ARM64 に対応しています。
Q. Warp は日本語に対応していますか?
画面の表示は英語のみです。日本語の文字は、出力と入力欄で表示できると公式に書かれています。
Q. Warp はオープンソースですか?
クライアントのコードは GitHub の warpdotdev/warp で公開されています。UI のフレームワークは MIT、それ以外は AGPL v3 です。
Q. Warp の AI はどのモデルを使いますか?
「Model choice」のページで選ぶ形で、自分の API キーや独自の推論の接続先も使えます。一覧は変わるため、公式のページで確かめます。
Q. 入力したコマンドは送られますか?
提供元の説明では、「Help improve Warp」がオンのとき、AI のやり取りと AI の機能に使うコンソールの入力を集めることがあり、オフならコンソールのやり取りはサーバーに保存されません。Free で AI を使うにはオンが条件です。
Q. Warp の設定ファイルはどこにありますか?
macOS は ~/.warp/settings.toml、Linux は ~/.config/warp-terminal/settings.toml、Windows は %LOCALAPPDATA%\warp\Warp\config\settings.toml です。
Q. iTerm2 の設定は持ってこられますか?
コマンドパレットの「Import External Settings」で、既定のプロファイルの配色・フォントなどを取り込めます。独自のキーや Triggers は入りません。
Q. Warp をアンインストールしたのに設定が残ります。
アプリとは別に設定・データのフォルダーが残ります。公式の手順で OS ごとのフォルダーを消します。テーマやワークフローも消えるため、残したいものは先に写します。
まとめ
この節では、この記事の要点が5つで分かります。
- Warp は、ブロックと AI のエージェント(Warp Agent)を組み込んだターミナルで、2026年11月時点の公式の説明は「オープンソースの Agentic Development Environment」です。
- macOS・Windows・Linux に対応し、brew・winget・.deb などで入れられます。ログインは任意です。
- Free は $0、Build は $20/月、Max は $200/月、Business は $50/席・月で、AI の利用分は金額で数えます。
- エージェントの権限は Profiles で操作ごとに決め、送る情報は「Help improve Warp」などの設定と提供元の説明で確かめます。
- テーマの YAML は色を引用符で囲み16色をそろえる、settings.toml は文字列を引用符で囲むのが、手元の点検で分かったつまずきです。
参考・出典
この節では、この記事で照合した公式のページが分かります(確認日 2026年11月18日)。
- Warp 公式サイト:https://www.warp.dev/
- Warp「Pricing」:https://www.warp.dev/pricing
- Warp「Privacy Notice」:https://www.warp.dev/privacy
- Warp Docs「Warp products」:https://docs.warp.dev/
- Warp Docs「Installation and setup」:https://docs.warp.dev/getting-started/quickstart/installation-and-setup/
- Warp Docs「Supported shells」:https://docs.warp.dev/getting-started/supported-shells/
- Warp Docs「Keyboard shortcuts」:https://docs.warp.dev/getting-started/keyboard-shortcuts/
- Warp Docs「Blocks」:https://docs.warp.dev/terminal/blocks/
- Warp Docs「Modern text editing」:https://docs.warp.dev/terminal/editor/
- Warp Docs「Command Palette」:https://docs.warp.dev/terminal/command-palette/
- Warp Docs「Custom themes」:https://docs.warp.dev/terminal/appearance/custom-themes/
- Warp Docs「Settings file」:https://docs.warp.dev/terminal/settings/
- Warp Docs「YAML Workflows」:https://docs.warp.dev/terminal/entry/yaml-workflows/
- Warp Docs「Agents」:https://docs.warp.dev/agents/
- Warp Docs「Agent Profiles & permissions」:https://docs.warp.dev/agents/capabilities/agent-profiles-permissions/
- Warp Docs「Plans, pricing & refunds」:https://docs.warp.dev/support-and-community/plans-and-billing/plans-pricing-refunds/
- Warp Docs「Privacy」:https://docs.warp.dev/support-and-community/privacy-and-security/privacy/
- Warp Docs「Known issues」:https://docs.warp.dev/support-and-community/troubleshooting-and-support/known-issues/
- Warp Docs「Logging out & uninstalling」:https://docs.warp.dev/support-and-community/troubleshooting-and-support/logging-out-and-uninstalling/
- Warp Docs「Migrate to Warp from iTerm2」:https://docs.warp.dev/getting-started/migrate-to-warp/migrate-to-warp-from-iterm2/
- Warp Docs「Migrate to Warp from Windows Terminal」:https://docs.warp.dev/getting-started/migrate-to-warp/migrate-to-warp-from-windows-terminal/
- GitHub「warpdotdev/warp」README:https://github.com/warpdotdev/warp
- iTerm2 公式サイト:https://iterm2.com/
- Microsoft Learn「Windows Terminal」:https://learn.microsoft.com/en-us/windows/terminal/
- Microsoft Learn「Color schemes in Windows Terminal」:https://learn.microsoft.com/en-us/windows/terminal/customize-settings/color-schemes
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「Warpとは|AIつきターミナルの使い方・料金・インストール」
株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。
WE ARE HIRING
RJCで一緒に開発しながら、
成長を楽しみませんか?
RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!
- 127日年間休日
- 12時間平均残業時間
- 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!
ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。