
Claude Code 本番のサーバーへ鍵で入り、照らしてから置くセット|鍵認証・接続名・git archiveの照合・アプリの起動
借りたサーバーで自分のアプリを動かしていると、直したファイルを本番へ届ける作業が、何度も回ってきます。最初のうちは、パスワードでログインして手で上書きする形でも用は足ります。けれど、Claude Codeに読み取りや配置の下ごしらえを頼むようになると、入り方と置き方を、毎回同じ形に決めておきたくなります。
このセットは、本番のサーバーとの付き合い方を「パスワードを使わずに鍵で入る → 自動の作業向けの接続名を作る → 送るファイルを一覧で決めて照らす → 照合が合ってから置く → アプリが起動して応えるのを見る」の順に、Claude Codeと進めるためのものです。サーバーの設定を書き換えるのも、ファイルを置くのも、自分の手で行います。Claude Codeには、読むだけのコマンドの案、手元で試す仕組み、設定の案、貼った結果の読み取りを頼みます。
4つのやり方の考え方とコードは、無料で公開している次のWeb記事にまとめてあります。
git archiveで必要なファイルだけを本番へ送る方法(サイト内の検索で「git archive」と入れると開けます)
このnoteの役目は、4本を「入る・届ける・動かす」の1本の流れに並べ、段ごとに何を確かめてから次へ進むかを決め、Claude Codeに渡せる形にまとめることです。
このセットを作ったきっかけ
このサイトのアプリも、借りたサーバーの上で動いています。Claude Codeと一緒に記事を直しては本番へ届ける作業を続けるうちに、入り方と置き方の小さな違いで、作業が進まなくなる場面に何度も出会いました。
Claude Codeにはパスワードを扱わせないと決め、本番への接続は鍵認証にした
本番用の接続名には、BatchModeとIdentitiesOnlyを付けた
設定ファイルの先頭に見えない印(BOM)が付いていて、ある環境のsshはその設定を読めなかった
作業PCを再起動した日には、鍵を預かる仕組み(ssh-agent)が止まっていて、鍵での接続が断られた
zipで送った日には、起動用のスクリプトの実行の権限が外れていた
Web記事の検証では、Gunicornを既定のワーカーのままFastAPIに使うと、起動はするのに要求が500で返ってきた
同じく、sshdの設定で後から読むファイルに書いたnoは、先に読んだファイルのyesに負けた
どれも、入る前・送る前・置く前に同じ形で確かめていれば、すぐに切り分けられるものでした。今は、git archiveで一覧のファイルだけをまとめたtarを作り、送った後も中身のハッシュ値が一致してから置く形にしています。このセットでは、その確かめを、段の順番に組み込みました。
本番へ入る・置くときに見落としやすいこと
鍵で入れることを試す前に、パスワードでのログインを止めてしまう
設定を変えたときに、ログインしたままの画面を残していない
設定の項目が、どのファイルのどの値で効いているのかを見ていない
送るファイルを、その場の記憶で選んでいる
届いた後の中身を照らさずに、上書きしている
置いた後の権限や、起動の形が前と変わっていないかを見ていない
Web記事との違い
無料の4本のWeb記事: 鍵認証への切り替え・接続名・git archiveでの配置・FastAPIの起動を、1本ずつ扱っています。考え方、コード、手元で試した結果、判断の目安、つまずきやすい所まで読めます。1つのやり方だけが目当てなら、Web記事で足ります
このセット(有料): 4本を、入る・届ける・動かすの1本の流れに並べ直しました。段ごとの依頼文10本と、うまくいかない時の6本を用意しました。ほかに、{ } の値の見本が12個、場面ごとの点検の一覧、区切りの目安があります
コマンドやスクリプトの中身はWeb記事の側に置き、このnoteには写していません。中身を確かめたいときは、記事のページを開いてください。
このセットで進められること
今のSSHの設定と、アプリのファイルの置き方を、何も変えずに書き出してもらう
自分で鍵を作って登録し、鍵だけで入れることを確かめてから、パスワードでのログインを止める
自動の作業に使う接続名を作り、効いている値を読み出して確かめる
本番へ送るファイルを一覧で決め、今の本番の中身が前の版と同じかを照らす
一覧のファイルだけのtarと指紋の一覧を作り、届いた後に照合してから、控えを取って置く
アプリのサーバーの起動の形を手元で確かめ、入れ替えた後の応答を見て、次回の手順をメモにする
含まれるもの・含まれないもの
含まれるもの:
STEPごとの依頼文が10本(1段に1本)。扱うのは、今の入り方と置き方の書き出し・鍵の作成と登録・鍵だけで入る確かめ・パスワードを止める設定の案・接続名・置くファイルの一覧と本番の照合・tarと指紋の一覧・届いた後の照合と配置・アプリの起動の形・入れ替えた後の確かめと手順のメモ
うまくいかない時の依頼文6本。鍵の接続が断られる・止めたはずのパスワードを聞かれる・接続名の設定が効かない・届いたファイルの照合が合わない・置いた後に起動のスクリプトが動かない・入れ替えた後にアプリが応えない
{ } に入れる値の見本12個と、段ごとの打つ場所と残るものの印
点検の一覧18項目(鍵を作る前から入れ替えた後までの6つの場面)
区切ってよいかの目安5つと、架空の小さなパン屋の予約アプリで通した例
どの依頼文も独立した枠に入れてあるので、枠ごとコピーして、そのままClaude Codeへ渡せます。
含まれないもの:
サーバーを借りる手続き、OSを入れる作業、ファイアウォールの設定
Apacheのリバースプロキシの設定そのもの(既刊の「リバースプロキシで複数のアプリを公開する実践セット」が受け持ちます)
アプリを常駐させる仕組みの選び方(既刊の常駐と監視のセットが受け持ちます)
DBの変更とバックアップの取り方(既刊のPostgreSQLの変更のセットと、バックアップと復元のセットが受け持ちます)
レンタルサーバーのように、SSHの設定を会社の側が決めている環境での変更
対象の読者と注意点
VPSのような自分で借りたサーバーで、Pythonのアプリを動かしていて、本番へ入る方法とファイルを届ける方法を、自分で確かめられる形に整えたい人に向けたセットです。使う道具は、作業PCのClaude Code、作業PCのターミナル、サーバーへのSSH、アプリのGitのリポジトリの4つです。
どの依頼文も、ファイルを作る前と、設定やコマンドの案を出した時点で一度区切る作りです。最後の行にある「確認を待ってください」のような文は、消さずに渡してください
sshdの設定を書き換えて読み込み直すのも、本番にファイルを置くのも、自分です。鍵を作ってパスフレーズを決めるのも、自分です
秘密鍵の中身、パスフレーズ、パスワード、サーバーの本当のアドレスは、Claude Codeに貼りません。貼る前に伏せます
パスワードでのログインを止める日、送るファイル、戻すかどうかの3つは、自分で決めます
依頼文の書き方は、4本のWeb記事のために原文で確かめたOpenSSH・Git・GNU coreutils・FastAPI・Uvicorn・Gunicornの公式の資料に沿っています
ここから先は、購入した方だけが読める部分です。最初に進め方と { } の値の見本、段ごとの印を並べ、続けて10段の依頼文、点検の一覧、うまくいかない時の6本、区切りの目安、架空のパン屋の例を置いています。