VPS Notes
VPS で AI エージェントとセルフホストを動かすエンジニアの実践記録
最新記事
- Hermes Agent を Claude Code だけで自作する: 記憶が育つ常駐エージェント「iris」を VPS に置く
VPS に常駐する Claude Code の Remote Control を自分専用エージェントにしました。memory・skills・notes の 3 層で学んだことを記憶し、cron で週次レビュー、結果は Telegram へ。常駐プロセス追加なし、API 課金なし。Hermes との使い分けも。
- Claude Code の CLAUDE.md と memory の書き方: 置き場所、@import、auto memory との違い、記憶を育てる 5 つのルール
CLAUDE.md の置き場所と読み込み順、@import の仕様、auto memory との違いを公式ドキュメントで整理し、VPS の常駐エージェントで 3 日回して分かった「記憶が育つ書き方」をまとめました。skill が自分で直った実例と、間違いを覚えたときの直し方まで。
- Claude Code の料金と使用量: Pro で常駐エージェント 2 つと週末の開発を回した実測 (5 時間枠と週の上限)
Claude Code は Pro (月 20 ドル) で足りるのか。常駐エージェント 2 つと週末の開発を Pro で回して、5 時間枠と週の上限にどれだけ当たったかを、使用状況の画面と会話の記録から集計したトークン数で示します。使用量の確認方法と、上限に当たったときの対処まで。
- Claude Code のスキルの作り方: SKILL.md の書き方と、常駐エージェントの手順書を移して分かった本当の違い
Claude Code のスキル (SKILL.md) の置き場所、frontmatter、呼ばれる仕組みを公式ドキュメントで整理し、VPS の常駐エージェントの手順書 3 つを移して前後を比べました。選ばれる精度とコストはほぼ同じ。差が出たのは「会話の途中で増えたスキル」でした。
- Claude で Gmail を整理する: コネクタでできること・できないこと、常駐エージェントに任せて分かった 3 つの落とし穴
Claude の Gmail コネクタで、広告メールの仕分け、削除、「なぜ受信トレイにない?」の調査を、VPS の常駐エージェントにやらせました。できること (検索・下書き・送信・ラベル) とできないこと (一括削除、履歴の調査)、送信の承認と権限の注意まで。
- J-Quants API の使い方: 無料プランで取れる範囲と、全銘柄の株価を別ソースと突き合わせた結果
JPX 公式の株価 API「J-Quants API」を無料プランで試しました。登録から API キー、Python で全銘柄の日足を 1 回で取るまで。無料で取れる期間、1 分 5 回の上限を超えたときの挙動、手元の株価との全銘柄の突き合わせ、有料プランと TDnet アドオン (月 11,000 円) の判断まで。
- EDINET API の使い方: API キーの取得から Python で有報と財務データ (XBRL) を取るまで
EDINET API v2 で有価証券報告書を取得し、XBRL から売上高や営業利益を取り出すまでを、動くコードつきで解説します。キーが無効でも 200 が返る罠、単体決算・IFRS・銀行の「経常収益」など、8,480 本を取り込んで分かった XBRL の癖も。
- 有価証券報告書を AI (Claude Code) で分析する: EDINET API で本文を取り、前年からの変化を拾う
有報の「事業等のリスク」と「経営者による分析 (MD&A)」を 2 期分、Claude Code に読ませて、前年から変わった点を抜き出しました。SUBARU で試すと 82 秒で 10 項目、引用 10 文はすべて原文に実在。本文を XBRL の TextBlock で切り出す方法と、つまずいた点まで。
- フリーランスエンジニアのエージェント比較: マージン・支払いサイト・週 3 案件・保障で 5 社を選び分ける
レバテックフリーランス、ITプロパートナーズ、Midworks、ギークスジョブ、PE-BANK を、公式サイトで確認できた支払いサイト、保障、週 2〜3 日案件、福利厚生で比べました。面談で聞くべきこと、複数登録の使い方、SES から抜けたい人向けの転職エージェントも。
- フリーランスエンジニアの単価相場と手取り: 月 70 万の案件で手元にいくら残るか、会社員の年収と正しく比べる
フリーランス PM を 2 年やって会社員に戻った立場から、単価の相場 (経験年数・領域・稼働日数別)、手取りの計算式、経費と税金、会社員の年収との換算方法、「やめとけ」と言われる理由をまとめました。
- Immich を 4GB の VPS で動かす: Google フォトから移行して、機械学習と日本語検索まで実測
Google フォト代替の Immich v3 を 4GB の VPS に Docker で立て、Google Takeout から immich-go で移行し、Pixel から自動バックアップするまでを実機で試しました。機械学習なし・あり・多言語モデルのメモリ実測と、日本語で検索できるようにする設定まで。
- Hermes Agent を VPS で動かす: 何ができるか、必要スペック、料金、Telegram から使うまで
Nous Research の Hermes Agent を 4GB の VPS に入れ、Claude をバックエンドに Telegram から VPS を操作するまでを実機で確認しました。インストール、gateway の常駐、memory と cron の実際の挙動、1 回あたりのトークン消費、つまずいた点まで。
- n8n を VPS にセルフホストして、Claude と MCP で繋ぐ (Docker Compose + Tailscale)
自動化ツール n8n を月 2,000 円台の VPS に Docker で立て、Tailscale 経由で HTTPS のままスマホから使えるようにします。Claude を挟んだワークフローの作り方と、n8n を MCP サーバーにして Claude Code から呼ぶ手順まで。
- Ollama を GPU なしの VPS で動かす実測: 何 B のモデルまで実用か、n8n から呼ぶまで
国内 VPS は GPU がありません。それでも Ollama で小さなオープン LLM を CPU で動かし、常駐の要約・分類・ボットに使えるかを 4GB / 8GB で実測しました。インストール、Tailscale 内への公開、OpenAI 互換 API、n8n からの呼び出しまで。
- Claude Code を VPS に常駐させてスマホから操作する (Remote Control + tmux + Tailscale)
ノート PC を閉じても Claude Code のタスクが止まらない環境を VPS に作ります。公式の Remote Control でスマホから操作する方法と、Tailscale 経由の SSH + tmux で画面ごと覗く方法を、実機の手順と使い分けつきでまとめました。再起動後の自動復帰まで。
- Tailscale とは? VPS の SSH をインターネットから閉じる手順と、安全性・料金
Tailscale の仕組み・安全性・料金を整理したうえで、VPS と手元の Mac / スマホを同じプライベートネットワークに入れ、SSH の 22 番をインターネットから完全に閉じます。exit node と Serve / Funnel の使いどころも。
- VPS の初期設定 (Ubuntu 24.04): SSH 鍵・ufw・fail2ban・自動更新を 30 分で済ませる
契約直後の VPS を安全に使い始めるための最小構成。root ログイン禁止、鍵認証、ファイアウォール、fail2ban、自動セキュリティ更新までを、XServer VPS クラウドの実機で通した出力つきで手順化しました。
- XServer VPS クラウドの申し込みから SSH で入るまで: 画面つきの手順と、最初に SSH が繋がらない理由
XServer VPS クラウドを実際に契約した記録。会員登録、プランと OS の選択、root パスワード、稼働までの時間、そして契約直後に SSH がタイムアウトする原因 (パケットフィルター) の対処まで。初月の日割りとキャンペーンで利用期限がどう決まるかも。