非エンジニア_はじめてのClaude Code CLIセットアップ編

自己紹介

縁あってエンジニアの方と近い距離でお仕事をしています。
開発メンバーに教えてもらいながら、Claude Code で業務効率を図るべくセットアップをしました。
本記事は、超初心者向けのセットアップで対応したことの記録です。

自身の学びのためにも作成している記事です。
個人の主観なども入っています。
応用編や、様々な利用シーンなど、ご意見大歓迎です。

本記事の前提条件・動作環境

• 2026年7月時点の情報です
• 本記事はmacOSを前提としています
  • Windows,Linuxとは挙動が異なる箇所があります
  • シェルはデフォルトのzshを使用
  • 後述のコマンドls /cdの使い方
    • Windows PowerShell / cmd.exeと挙動が異なる箇所があります
• Claudeの有料サブスクリプション契約済み
  • Claude account with subscription の選択肢の前提
• 使用テキストエディタ
  • VS Code
  • macOS 標準のテキストエディタを使用する場合、デフォルトで RTF 形式で保存されるので、書式なしテキストへの変換が必要です

デスクトップ版とCLI版どちらを利用する？

Claude Codeとひと括りで同じ操作ができるものだと思ってましたが、これらが全く別物であることを知りました…。それぞれの特性を簡単にまとめました。

Claude Desktop（デスクトップ版）

初心者から非エンジニアまで使いやすい設計

• UI
  • グラフィカルユーザーインターフェース（GUI）
    • 環境構築が不要で、アイコンやボタンをクリックするだけで直感的に操作できる
  • 視覚的なデザインやナビゲーションが充実
• 使用環境・操作性
  • マウス・キーボード操作に最適化されている

Claude Code（CLI版）

技術者向けで学習曲線はあるが柔軟性は高い

• UI
  • コマンドラインインターフェース（CLI）
    • 初期設定が必要で、ターミナル操作の基礎知識習得が必要
    • ローカルコマンド・スクリプトの直接入力
• 使用環境・操作性
  • 開発環境に直接入り込んで動作するため、ターミナルが動く場所ならシステムに依存せずに使用可能

非エンジニア且つ初心者、でもCLI版を利用する決定的な違い

直感的な操作や初学者でも操作しやすいとなれば、デスクトップ版の方が良さそうな感じを受けますが、ビジネスメンバーでもCLI版を選択する理由はシンプルです。

「日々の業務を、本格的に自動化・効率化させたかったから」です。

実際の会議で例えてみます。
その会議の「長大な文字起こしデータ」から議事録を作成し、決定事項やタスクを関係ツール（SlackやNotionなど）へ自動で登録する業務を考えてみます。

これを、Claude Codeとスクリプトを組み合わせて処理をすると、以下のような利点が挙げられます。

1.変数操作による柔軟な実行
実行時に「今回は『プロジェクトA』の会議です」と変数を付けて実行するだけで、スクリプトがその情報を受け取り、自動でプロジェクトA用のSlackチャンネルなどに投稿してくれます。別アプリを開いてコピペする手間はありません。

2.トークン消費量の大幅な節約
スクリプトが「決定事項」や「タスク」という文字の周辺だけをシステム的に切り取ってからClaudeに渡してくれます。1時間分のテキストを丸ごとAIに読み込ませる必要がなくなり、AIとのやり取り（トークン消費）を必要最小限に抑えることができます。

「AIを使う」というところから「AIありきで業務や仕組みを構築する」ことにシフトするため、エンジニアと同環境を整えることで、組織全体の効率化を目指します。

セットアップ手順

①ターミナルの基本操作と「自分がいる場所」を知る

セットアップする前にターミナルの基本的な操作を覚えます。
ターミナルでは、自分が今PCの中の「どのフォルダ（ディレクトリ）にいるか」を意識することを覚える必要があります。ターミナルを立ち上げた直後は、「ホームディレクトリ」と呼ばれる場所にいます。コマンドを使って確認します。

基本コマンド

• 自分がいる場所（現在地）の確認
  • pwd
• その場所の中身（ファイル・フォルダ一覧）を確認
  • ls
• フォルダの移動
  • cd フォルダ名
    • cdとフォルダ名の間には、半角スペースを入力
• 1つ上（親フォルダ）に戻る
  • cd ../
    • ここでもcdと../の間には半角スペースが必要です
• 1つ前戻る（履歴上の直前に戻る）
  • cd -

基本的な知識をふまえて、いよいよログイン作業に入ります。

②インストールと初期ログイン

ターミナルと自分のアカウントを紐づけます。
Anthropic社 公式ドキュメントクイックスタートからインストールします

1.コマンドをターミナルで実行
ターミナルを立ち上げてClaude Codeをインストールします

curl -fsSL https://claude.ai/install.sh | bash

※インストール直後、claudeコマンドが見つからない場合は、一度ターミナルを再起動するか、source ~/.zshrcコマンドを実行して設定を再読み込みしてください。

2.Claude Codeが実行できているかチェックする

ターミナルで以下のコマンド入力を実行して、Claude Codeが実行できるかチェックします

claude

入力後の画面はこちら

画面を見てみると、以下の内容の記載と1.〜7.までの選択項目が表示されています。

Choose the text style that looks best with your terminal To change this later, run /theme

ターミナル画面イメージを選ぶことができるというもの。自分の操作環境に合う画面を選んでみると良さそうです。
ターミナル環境で選択する場合は、キーボードの矢印キーで上下選択します。マウスを使うことはないので、ショートカットキーを覚えておくこともオススメします。
選択してEnterキーで次へ進みます。

3.承認作業

• Claude account with subscriptionを選択すると、自動でブラウザが開きます
• ブラウザでログインと承認を行い、表示された「承認コード」をコピー
• ターミナルでコードを貼り付けてEnterキー
• セキュリティの表示が出たらYes I trust this folderを選択
  • これはこのフォルダのファイルを AI が読み書きしてよいかを聞いています

+❯ 1. Yes, I trust this folder
   2. No, exit

③Claude Codeの基本コマンド

ここで改めてClaude Code の基本コマンドを覚えます。新しい作業をする場合など、必ず現在の会話を終了してから、新しい会話を立ち上げます。

• 起動
  • 作業したいフォルダへcdコマンドで移動した後にclaude
• 終了
  • /exit
• 操作のキャンセル/戻る
  • Escape キー
• トークン使用量の確認（今の会話で AI が覚えている量を確認する）
  • /context
• 会話の記憶を短くまとめる（履歴を要約してトークン容量を節約する）
  • /compact
• チャットのリセット（今の会話をリセットして、新しいチャットを開始する）
  • /clear
• チャットの再開（過去のチャットログを呼び出して再開する）
  • /resume

④設定ファイルの作成

「常に日本語で」「この形式で出力して」といった共通のルールを設定します。

📁隠しフォルダの表示
設定はホームディレクトリの .claude フォルダ内に保存されますが、名前が「.（ドット）」で始まるフォルダは通常隠されているので、ショートカットキーで隠しファイルを表示します。
Command + Shift + . キー（macOS）で隠しファイルを表示します。

📁設定ファイルの作り方

• .claude フォルダ内にファイルを作成します
  • 普段使用しているテキストエディタやパソコン標準のテキストエディタを使って作成します
• ファイル名
  • CLAUDE.mdファイルを作成します
    • 必ず全て大文字でCLAUDEのファイル名にします。小文字だとAIが認識しません

1.ルール・プロンプトを設定する
テキストエディタでCLAUDE.mdファイルの中に、常に守るルールや指示を書き込み、上書き保存します。コードのような特殊な書き方は不要で、お願いしたいことを書いていきます。
※Markdown 記法（# 見出し、- 箇条書きなど）などを使えると、後で構造化したくなったときに便利です

記述するルールの例

# 共通ルール
- 常に日本語で返答してください
- フォルダを作成し、その中にドキュメントをまとめてください
- ファイル名は『日付とテーマ』の形式にしてください
- ファイルはMarkdown形式で作成し、区切り線は使わないでください

2.Claude Codeを再起動する（設定の読み込み）

設定ファイル（CLAUDE.md や、MCP・スキルなどの設定ファイル）を新規作成したり編集・保存したりした後は、その内容をAIに読み込ませる必要があります。
ターミナル上で一度/exitと入力してClaude Codeを終了し、再度 claude と入力して再起動をかけます。
再起動することで、記述したルールがAIに反映され、以降のやり取りのベースとして適用されるようになります。

ここまでで一旦のセットアップの完了です。
ここからようやく実務活用のステップに移ります（つづく）

セットアップを終えて…

複数人でレクチャーを受けながらセットアップをしましたが、ここまでで1時間半位要しました（些細な不明点にも丁寧に対応してくれた社内メンターには大変感謝🙌）。ターミナル環境での操作方法、コマンドに慣れていないことも影響していますが、構造を理解していないことも大きな要因かなと思います。

新しく導入したツールを使いこなすためには、前提条件となる仕組みやルールを理解し、順応していくことが課題解決への近道になると思います。

MCP連携やスキル（Skill）を設定することでさらに可能性が広がるレクチャーを受けたので、応用編で書いていきたいと思います。

追記（Claude Codeを導入することになった背景）

元々、筆者が業務で叶えたいことがあり社内のデザイナーに相談したことがことの始まりでした。ビジネスメンバーはこれまで使用していなかったのですが、専門的な用語ではなく自分のやりたいことを相談したことで「それならClade Code を使いこなせるようになって、やりたいことを実現していこう」となりました。

エンジニアリング業界を良くしていきたい、テクノロジーで社会を良くしていきたいという共通の思いがあるからこそ、出来ることなのだと感じます。

本記事の執筆も筆者の知識習熟度を確認するためのものとして書いています。自分と同じように慣れないツールに対して不安がある方もいると思いますが、本記事が何かの役に立てば幸いです。