跳到正文
gihyo.jp·· 5 天前AI 評分71

用 Claude Code 為非工程師優化 AI 智能體環境設定

Claude CodeでAIエージェントの環境設定を非エンジニア向けに最適化しよう

AI 導讀

文章示範如何用 Claude Code 為非工程師設定 AI 智能體的工作環境,涵蓋版本管理、API 金鑰保管和備份。Git 設定只納入程式碼、Markdown 及不含秘密的設定檔,並儲存至 GitHub 私有儲存庫;API 金鑰則放在 Windows 資格資訊管理員,於執行時讀取,資料另以每小時差分備份和每日 ZIP 備份保存。

正文

第2回でツールを作り、第3回で記憶と守りの仕組みを置きました。最終回は、それらを「使い続ける」ための環境設定です。

今回は、Git・資格情報・バックアップの3つを設定します。Claude Codeは開発者向けの道具なので、周りにある作法もエンジニアのものです。それをそのまま持ち込まず、非エンジニア流に組み立て、そのあとで、どこをまねし、どこをまねしなかったのかを整理します。

1|Git⁠・資格情報⁠・バックアップを設定してみよう

この回で作るもの⁠・前提⁠・所要時間

作るもの
DOCX・PPTX・Excel・動画を対象外にしたGitの設定とGitHub(private)への保存、資格情報マネージャーにAPIキーを置いて実行時に渡す仕組み、1時間ごとの差分バックアップ、毎日のZIPバックアップ
前提
WindowsのClaude Codeデスクトップ版での実演です(Macでは、資格情報マネージャーやタスク スケジューラをOSの同じ役割の仕組みに読み替えてください⁠)⁠。データは第2回・第3回と同じく、すべて架空のものを使います。Gitが入っていること(入っていなければ、Claude Codeに入れ方を聞けば案内します。会社のPCでは、導入は情報システムの手順に従ってください⁠)⁠。GitHubのアカウント(無料で可⁠)⁠。画面は2026年10月時点のもの。会社のPCで試すときは組織の承認を得て、本番のキーでは試さないでください
所要時間
約60分(Claudeの生成待ちは正味40分ほど。撮影では、承認の往復と手作業を含めて約2時間かかりました)
対象
第2回・第3回で作った「仕事」フォルダ

手順1 GitとGitHubをClaude Codeに設定させる

「仕事」フォルダの環境で新しいセッションを開き、承認モードを「手動」にして指示します。

このフォルダをGitで管理したい。ただし、DOCX・PPTX・XLSX・PDF・動画・画像はGitの対象外にして。対象はコードとMarkdownと設定ファイルだけ。設定する前に、何をするか見せて。

Claude Codeは、まずフォルダの中のファイルの種類と数を数え、「⁠Markdown 4つとPython 2つは入れる、Excel 5つとテキスト3つは入れない」と表にして見せました。テキストは催促メールの下書きで、お客様の名前が入っているので、指示に無くても対象外にしたそうです。

対象外を書く.gitignoreというファイルは、「⁠まずすべてを対象外にして、コード・Markdown・設定ファイルだけを戻す」形(許可リスト方式)で作ると提案してきました。あとで新しい種類のファイルが増えても、自動で対象外になります。

.gitignoreの中身の案。まずすべてを対象外にし、コード・Markdown・設定ファイルだけを戻す。設定ファイルでも、秘密情報が入りうるもの(.envなど)は対象外のまま

計画を見て「初回コミットまで」を選ぶと、Gitの初期化と.gitignoreの作成のあと、最初の保存(コミット)をします。保存されたのはCLAUDE.mdや催促ツールのプログラムなど7つのファイルだけで、Excelとお客様名入りのテキストは入っていません。

次に、GitHubの画面で新しいリポジトリ(保存先)を作ります。名前を入れて「Private」を選び、READMEなどは追加せず、空のまま作ります。公開(Public)にはしません。

GitHubでリポジトリを作る画面。「Private」を選び、README・.gitignore・licenseは追加しない

Claude Codeに戻り、保存先を伝えます。

このリポジトリに保存して。(GitHubのURL)送る前に、何を送るか見せて。

ここでClaude Codeは、第3回で作った全体のルールを根拠に止まりました。「⁠全体のCLAUDE.mdは『外部への送信』をやってはいけないことにしています。GitHubへの送信もこれにあたります。ルールの例外として送ってよいですか」と聞いてきたのです。あわせて、送る7つのファイルの一覧と、お客様の名前・メールアドレス・電話番号が混じっていないかを調べた結果を示しました。

送る前に、全体のルールとぶつかることを指摘している画面。送り先と、送る中身を示したうえで、例外として送ってよいかを聞いている

送信を許可する前に、送り先と、送るファイルの中身を自分でも確かめます。「⁠例外として送って」を選ぶと、GitHubに送られます(初めて送るときは、ブラウザでGitHubへのサインインを求められます⁠)⁠。送り終えると、Claude Codeは「例外は今回だけなので、次に送るときもその都度確認します」と報告しました。毎回送るなら、送り先と対象を全体のCLAUDE.mdに、その理由を判断の記録(decisions.md)に書きます。privateでもGitHubという外部に置くことに変わりはないので、全体のルールの例外として扱うのが正しい扱いです。実データで運用するなら、GitHubに置いてよい範囲も組織のルールで確かめます。GitHubのアカウントには、二段階認証を設定しておきます。

以降は、「⁠今日の変更を手元に保存して」と指示すれば、変更の要約をつけて保存します。筆者の決まりごとを一つ。保存する前に、Claude Codeが見せる「何を保存するか」の一覧を必ず読みます。対象外にしたはずのExcelが混じっていたら、その場で止めます。Gitは一度入れたものを消すのが面倒なので、入口で止めるのが一番安上がりです。

手順2 資格情報は.envに置かない

次に、秘密の置き場です。業務アプリが外部のAPI(AIやチャットツールのAPI)を使うなら、APIキーが要ります。これを.envファイルに書くのが、エンジニアの一般的な作法です。生成AIが登場する前からの作法で、今も広く使われていますが、前提が一つ変わりました。AIがフォルダの中を読み書きするようになったことです。筆者は、Windowsの資格情報マネージャーに登録しています。

Windowsの資格情報マネージャーに、「MYAPP_API_KEY」という名前でAPIキーを登録したい。登録は私が手でやるので、手順を教えて。そのうえで、登録したキーを実行時に読み出して環境変数に渡し、ツールを起動する小さなラッパーを作って。キーそのものはファイルに書かないで。

Claude Codeは、Windowsに最初から入っている仕組みでキーを読み出す小さなスクリプト(ラッパー)を作りました。追加の道具は要りません。キーは、ツールを起動しているあいだだけ環境変数に入り、終わると元に戻ります。そのうえで登録の手順を示し、「⁠登録後の読み出しは、まだ試せていません」と添えてきました。

登録は、自分の手で行います。スタートメニューで「資格情報マネージャー」を開き、「⁠Windows資格情報」の「汎用資格情報の追加」で、アドレスにMYAPP_API_KEY、ユーザー名に任意の名前、パスワードにキーを入れます。キーはClaude Codeのチャットに貼りません。

資格情報マネージャーにキーを登録する画面。パスワード欄は伏せ字で表示される

登録したら、「⁠キーを登録しました。確認のコマンドで、読み出せるか試して」と指示します。Claude Codeはキーそのものではなく文字数だけを表示し、「⁠キーを読み出せました(10文字⁠)⁠」と報告しました。終わったあとにキーが環境変数に残っていないことまで確かめています。

確認の結果。キーの値は表示せず、「終わったあとにキーが残っていないか → 残っていない(どの環境変数にもない)」と報告している

この形にすると、キーを書いたファイルがフォルダの中に存在しなくなるので、Gitに紛れ込む事故や、AIがファイルを開いて値を目にする事故を減らせます。

ただし、同じユーザーで動くプログラムは資格情報を読み出せるので、「⁠AIから隠せた」わけではありません。実演で値を出さなかったのは、全体のルールに沿ってそう振る舞ったからです。本番のキーは用途を限った短命のものにし、AIに値の表示を指示しないことを決まりにします。

手順3 1時間ごとの差分バックアップ

Gitに入れない資料は、バックアップで守ります。バックアップは2本立てにします。1時間ごとの差分バックアップは、Claude Codeが短時間に何度も書き換える資料を、直近2日の範囲で1時間刻みで戻すためのものです。毎日のZIPは、道具もパスワードも要らずに誰でも開ける丸ごとの控えで、2週間分を残し、パソコンが壊れたときや、ほかの人に引き継ぐときに使います。まず、1時間ごとに「変わった分だけ」を取る差分バックアップから入れます。

ここは自作せず、既製の道具を使います。筆者はresticを使っています。差分だけを取り、過去の時点に戻せ、暗号化もされます。暗号化のパスワードは、手順2と同じく資格情報マネージャーに「RESTIC_PASSWORD」という名前で登録しておきます。

resticを使って、仕事フォルダをD:\restic-repoにバックアップする設定を作って。resticがこのPCに無ければ、入れ方を先に見せて。暗号化のパスワードは資格情報マネージャーに「RESTIC_PASSWORD」という名前で私が登録したので、ファイルには書かないで。さっき作ったラッパーと同じやり方で渡して。1時間ごとにタスク スケジューラで動かす登録も作って。登録前に内容を見せて。

Claude Codeは、まずresticの入れ方を2通り示しました。wingetで入れる方法(Windows 11や新しめのWindows 10で使えます。会社の管理端末では使えないことがあるので、情報システムの手順に従ってください)と、配布ページから手で入れて壊れていないかを照合する方法です。前者を選ぶと、resticを入れ、バックアップ用のスクリプトを作り、最初のバックアップと検査(エラーなし)まで済ませてから、タスクの登録内容を表で見せてきました。1時間ごと、ログオン中だけ、30分で止める(終わらない回を打ち切り、次の回と重ならないようにします⁠)⁠、同じ名前のタスクがあれば上書きしない、という内容です。

タスクの登録内容の続き(30分で止める、同じ名前のタスクがあれば上書きしない)と、「パスワードをなくすとバックアップは二度と開けない。資格情報マネージャーとは別の場所にも控えて」という注意

「バックアップ先が仕事フォルダと同じディスクにあるので、ディスクが壊れたときは両方なくなります」という注意も添えてきました。保存先は、外付けのドライブや別のディスクが基本です。スナップショットは増え続けるので、残す範囲(例:直近48時間分)を決め、古いものを整理する設定も指示します。日より粗い単位の控えは、次のZIPに任せます。パスワードは、資格情報マネージャーとは別の場所にも控えておきます。なくすとバックアップは二度と開けません。

登録できたら、復元を試します。手動でもう一度バックアップを取ってスナップショット(バックアップを取った時点)を2つにしてから、「⁠1つ前のスナップショットからhandoff.mdを取り出せるか試して。元のファイルは上書きしないで」と指示します。Claude Codeはスナップショットの一覧を示し、1つ前の時点からhandoff.mdを別の場所に取り出して、元と中身が同じであることを確かめました。途中で権限のエラーが一つ出たこと(フォルダの更新日時を戻す処理でのエラーで、中身には影響しません)も、「⁠ファイルは取り出せているが、原因はまだ突き止めていない」と、そのまま報告しています。

スナップショットの一覧と、1つ前の時点からの取り出し

手順4 毎日のZIPバックアップを仕込む

差分バックアップに加えて、毎日19時に「仕事」フォルダ全体をZIPにして、別の場所に置きます。resticの控えは、resticとパスワードがそろわないと開けません。ZIPは道具もパスワードも要らないので、パソコンが壊れたときや、ほかの人に渡すときの控えになります。置き場所はresticと同じく別のディスクや外付けのドライブにし、暗号化されていないZIPにはお客様のデータも入るので、仕事フォルダと同じ扱いで守ります。

毎日19時に、仕事フォルダ全体をZIPにしてD:\backupに保存するスクリプトを作って。ファイル名は日付入り。14日より古いZIPは消す。Windowsのタスク スケジューラに登録して。登録前に内容を見せて。登録できたら、いま一度手動でZIPを作って、別の場所に展開して中のExcelが開けるか試せるようにして。

Claude Codeは、本番の前に作業用の写しで試し、問題を2つ見つけて直しました。Windowsに最初から入っているZIPの機能では、隠しフォルダ(Gitの.gitフォルダ)がZIPに入らないこと。別の方法では、ZIPの中のフォルダの区切りが、ほかのパソコンで開けないことがある形になること、です。古いZIPは、すぐに消さずにごみ箱へ移す形にしてありました。

作る前に作業用の写しで試した結果と、スクリプトの決めごと。古いZIPはすぐ消さずにごみ箱へ

登録できたら、必ず一度「復元」を試します。Claude CodeはZIPを別の場所に展開し、中の63のファイルとExcel 5つが元と同じ中身であることを確かめました。Excelの中身はお客様のデータなので開いて読まない、と断ったうえで、「⁠Excelで開いて確かめるのは、ご自身で」と展開した場所を伝えてきました。自分で開いて、読めることを確かめます。バックアップは、復元を試して初めてバックアップになります。初回の自動実行のあとに、タスク スケジューラの前回の実行結果と、resticのスナップショットとZIPの日時が新しくなっていることを確かめます。

展開したZIPの中のExcel(第3回で作った架空の帳票の黒塗り版)を開いて確かめたところ

注意点 それでもクラウドに出せない情報がある

環境設定が整うと、「⁠もう何でもAIに渡してよい」と感じがちです。そうではありません。契約や法令で「ローカル管理以外は不可」とされた情報は、黒塗りしても、Gitをprivateにしても、クラウドのAIには出せません。ここだけは、道具がどれだけ良くなっても変わりません。

その領域のために、筆者は手元のパソコンで動くAI(ローカルLLM)を検討しています。性能はクラウドに劣りますが、通信を止めた構成にすれば、処理するデータを外に送らずに使えます。最初に試すなら、Claude Codeに「ローカルLLMを試すには何が要るか、私のパソコンで動くか調べて」と聞くところからで十分です。本連載では入口だけにとどめます。

2|なぜ⁠、そのまま持ち込まないのか

非エンジニア流の環境の決めごと

筆者の環境では、次の4つのルールを適用しています。。

ターミナルは使わない

Claude Codeにはターミナル(黒い画面)から使う方法と、デスクトップ版・VS Code版から使う方法があります。業務サイドの人は後者で十分です。やりたいことは日本語で伝えればよく、コマンドを覚える必要はありません。

Gitは使う⁠。でも枝分かれはしない

Gitは、ファイルの変更の履歴を残す仕組みです。「⁠いつ、何を、なぜ変えたか」が残り、前の状態に戻せます。これは業務サイドの人にも大きな価値があります。ただし、一人で、資料が主役の仕事をする本稿の環境では、ブランチ(作業を枝分かれさせる機能)やワークツリー(枝ごとの作業フォルダ)は使いません。枝分かれさせるほど並行作業がなく、「⁠いまどれが本物か」が分からなくなる害の方が大きいからです。

資料はGitに入れない

Gitが得意なのはテキスト(コード・Markdown・設定)で、DOCX・PPTX・Excel・動画・画像は苦手です。容量が膨らみ、差分も見えません。だから、Gitに入れるのはコード・Markdown・秘密を含まない設定ファイルだけにし、資料は、直近を1時間刻みで戻す差分バックアップと、丸ごとのZIPの2本で守ります。

資格情報は .envに置かない

APIキーのような秘密を、エンジニアはよく.envというファイルに書きます。AIがフォルダの中を読み書きする前提ではなかった作法で、その環境では、AIがうっかりそのファイルを読む事故が起きえます。筆者はOSの資格情報マネージャーに登録し、実行の瞬間だけ読み出します。

3|自作の範囲にも⁠、昔からの問題がついて回る

ここで、連載の第1回で示した「どこまで自分で作ってよいか」に戻ります。業務サイドの人が自分で作れる範囲が広がりました。それ自体はよいことですが、この範囲には、昔からの問題がそのままついて回ります。

ExcelマクロやAccessで業務サイドの人が自作した時代(EUCと呼ばれました)に起きたのは、属人化、ブラックボックス化、引き継げない、控えがない、管理外へのデータ流出でした。会社が把握していない道具が増える「シャドーIT」も根っこは同じです。AIで作れるようになって変わったのは、作るのが速く、数が増え、本人もコードを読めないことです。問題は減っていません。むしろ上乗せされています。

だから、作る側には2つのことが要ります。

業務サイドの人には、ソフトウェア工学の基本(変更の履歴を残す、控えを取り復元を試す、権限と秘密を分ける、試験用データで確かめる)を知ることです。

そして、お勤め先のセキュリティ・法務・データ管理のルールを守ることです。エンジニア(社内の開発部門や、取引先のシステム会社)には、情報システムや法務の担当と組んで、ガードレールを敷き、ひな形を配り、相談の窓口を持ち、うまくいった自作を引き取って育てる道を用意することです。

今回の環境設定は、この「基本」を、Claude Codeに手伝わせながら自分の環境に入れる作業です。撮影では、第3回で置いたルールと判断の記録を読んだClaude Codeが、外部に送る前に止まる、お客様のデータを読まない、うまくいかなかったことをそのまま報告する、という振る舞いを選びました。ただし、文書だけで動作を強制できるわけではないので、人の確認と組み合わせます。

結び

連載を通して示してきた「どこまで自分で作ってよいか」を、最後にもう一度確かめしょう。

業務サイドの人が自分で作ってよいのは、自分や少人数の道具で、組織のルールでClaudeに送ってよいとされたデータだけを扱い、壊れても手作業に戻せ、本人が中身を説明できる範囲です。

その範囲の中で、要件はCLAUDE.mdに日本語で書き、記憶と守りはフォルダの中のファイルに置き、変更の履歴はGitに、秘密は資格情報マネージャーに、資料は差分バックアップとZIPに置きます。ここまでやれば、一人でも品質を保ちやすくなります。

それでも、仕組みは人の確認と組み合わせて初めて役に立ちます。範囲を超えそうになったら、CLAUDE.mdを持ってエンジニアに相談します。個人情報や法令対応が絡むときは、情報システムや法務の担当にも相談します。

この連載で紹介した仕組みの考え方は、『⁠Claude AI活用 最強の教科書』の第1章(情報の3分類、Sec.07)と第10章(Claude Code・CLAUDE.md・仕組みの守り、Sec.114〜116)にまとめてあります。非エンジニアの方が最初の一冊として読めるように書きました。周りに「自分でも作ってみたい」と言っている同僚がいたら、この連載と一緒に渡していただけたら嬉しく思います。

來源:gihyo.jp · gihyo.jp