UbuntuにClaude Codeを導入すると、コード修正、テスト作成、ドキュメント生成、Git操作、ログ解析、シェルスクリプト作成、CI/CD設定などをターミナル上で効率化できます。Claude CodeはLinux環境に対応しており、公式ドキュメントではLinux・macOS・WSL向けにネイティブインストーラーが案内されています。

Claude Codeとは

Claude Codeは、ターミナルで動作するAI開発支援ツールです。

通常のチャット型AIとは違い、プロジェクト内のファイル構成やソースコードを確認しながら、開発作業を進められる点が特徴です。

Ubuntu上でClaude Codeを使うと、次のような作業を効率化できます。

・コード修正
・バグ調査
・テストコード作成
・README作成
・API仕様書作成
・シェルスクリプト作成
・Git差分の整理
・コミットメッセージ作成
・Pull Request説明文作成
・Docker設定確認
・CI/CD設定作成
・ログ解析
・Linuxコマンドの補助

Ubuntuはターミナル作業、Docker、Git、シェルスクリプト、サーバー運用との相性がよいため、Claude Codeを使った自動化環境に向いています。

UbuntuでClaude Codeを使うメリット

Ubuntuは開発用Linux環境として利用されることが多く、Webアプリケーション、API、バッチ処理、インフラ構築、Docker開発など幅広い用途に使われます。

Claude CodeをUbuntuに導入すると、開発に関わる作業をターミナル上でまとめて進めやすくなります。

主なメリットは次の通りです。

・Linuxコマンドと組み合わせやすい
・Git操作と相性がよい
・Docker環境の調査に使いやすい
・ログ解析を依頼しやすい
・シェルスクリプト作成を効率化できる
・CI/CD設定の作成に使いやすい
・サーバーに近い環境で検証しやすい
・開発環境の標準化に役立つ

特に、繰り返し発生する作業をClaude Codeに整理させることで、開発効率を高めやすくなります。

事前準備

Claude Codeを導入する前に、Ubuntu側の基本環境を整えておきます。

まず、パッケージ情報を更新します。

sudo apt update

必要に応じて、インストール済みパッケージも更新します。

sudo apt upgrade -y

curlやgitが入っていない場合は、次のコマンドで導入します。

sudo apt install -y curl git

バージョン確認も行います。

curl –version

git –version

Claude Codeはターミナル上で利用するため、Ubuntuの基本的なコマンド操作ができる状態にしておくとスムーズです。

Claude Codeのインストール

Ubuntuでは、公式ドキュメントで案内されているインストールコマンドを使用できます。

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

インストール後、PATHが反映されていない場合は、ターミナルを開き直します。

それでもclaudeコマンドが見つからない場合は、次のように確認します。

ls -la ~/.local/bin

claudeコマンドが存在している場合は、PATHに追加します。

echo ‘export PATH=”$HOME/.local/bin:$PATH”‘ >> ~/.bashrc

source ~/.bashrc

確認コマンドは次の通りです。

claude –help

正常にヘルプが表示されれば、インストールは完了です。

初回起動と認証

Claude Codeを起動するには、次のコマンドを実行します。

claude

初回起動時は、Claudeアカウントとの認証が必要になります。

画面の案内に従ってログインや認証を行います。

プロジェクトで利用する場合は、対象プロジェクトのルートディレクトリに移動してから起動します。

cd /path/to/your-project

claude

プロジェクトのルートで起動することで、Claude Codeがファイル構成や設定ファイルを確認しやすくなります。

作業用ディレクトリの作成

Claude Codeを試す場合は、いきなり本番プロジェクトで使うより、テスト用ディレクトリを作って動作確認するほうが安全です。

mkdir -p ~/projects/claude-code-test

cd ~/projects/claude-code-test

簡単なREADMEを作成します。

touch README.md

Claude Codeを起動します。

claude

次のように依頼できます。

このディレクトリに、簡単な開発メモ用READMEを作成してください。

含める内容：
・プロジェクト概要
・使い方
・今後追加する項目
・注意点

最初は小さなディレクトリで操作感を確認し、慣れてから実案件に導入する流れが安全です。

CLAUDE.mdで自動化ルールを固定する

Claude Codeを効率よく使うには、プロジェクト内にCLAUDE.mdを置くのが有効です。

CLAUDE.mdには、Claude Codeに守ってほしい作業ルールを書きます。

touch CLAUDE.md

記載例は次の通りです。

Claude Code 作業ルール

基本方針

・日本語で回答する
・変更前に対象ファイルを確認する
・推測で断定しない
・不明点は「要確認」と書く
・既存コードの書き方を優先する
・不要な大規模変更はしない

自動化ルール

・作業後に変更内容をまとめる
・確認したファイルを一覧化する
・テスト方法を最後に書く
・危険なコマンドは実行前に確認する
・削除処理は必ず対象を表示してから行う

禁止事項

・認証情報を直接書き込まない
・.envの内容を不用意に出力しない
・本番環境で破壊的なコマンドを実行しない
・不要なリファクタリングをしない

CLAUDE.mdを置くことで、毎回同じ注意事項を入力する手間を減らせます。

チーム開発では、このファイルをGit管理しておくと、作業ルールを統一しやすくなります。

Ubuntu環境確認を自動化する

Claude Codeを使う前に、Ubuntu環境の状態を確認できるようにしておくと便利です。

次のような確認コマンドをまとめておくと、トラブル時に役立ちます。

uname -a

lsb_release -a

whoami

pwd

df -h

free -h

git –version

curl –version

Claude Codeに次のように依頼できます。

このUbuntu環境で開発に必要な基本情報を確認するシェルスクリプトを作成してください。

条件：
・OS情報を表示する
・ディスク容量を表示する
・メモリ使用量を表示する
・Gitとcurlのバージョンを表示する
・実行結果が読みやすいように見出しを付ける

作成されるスクリプトの例です。

!/bin/bash

set -euo pipefail

echo “=== OS情報 ===”
lsb_release -a

echo “=== カーネル情報 ===”
uname -a

echo “=== ユーザー ===”
whoami

echo “=== 現在のディレクトリ ===”
pwd

echo “=== ディスク容量 ===”
df -h

echo “=== メモリ使用量 ===”
free -h

echo “=== Gitバージョン ===”
git –version

echo “=== curlバージョン ===”
curl –version

実行権限を付与します。

chmod +x check-env.sh

実行します。

./check-env.sh

このような確認スクリプトを作っておくと、環境差分の調査が早くなります。

Git作業を自動化しやすくする

Claude CodeはGit差分の確認、コミットメッセージ作成、Pull Request説明文作成に使えます。

まず、よく使うGit確認コマンドを把握しておきます。

git status

git diff

git diff –staged

git log –oneline -5

Claude Codeには次のように依頼できます。

現在のGit差分を確認して、コミットメッセージ案を作成してください。

条件：
・日本語で作成する
・変更内容を簡潔にまとめる
・影響範囲を含める
・不要な変更が含まれていないか確認する

Pull Request用の文章も作成できます。

現在の差分からPull Request説明文を作成してください。

含める内容：
・概要
・変更内容
・確認方法
・影響範囲
・レビューしてほしい点

Git作業をClaude Codeに補助させることで、レビュー前の整理がしやすくなります。

シェルスクリプト作成環境を整える

Ubuntuで自動化環境を作る場合、シェルスクリプトは重要です。

Claude Codeにスクリプトを作らせる前に、基本ルールを決めておくと安全です。

推奨される基本形は次の通りです。

!/bin/bash

set -euo pipefail

set -euo pipefailを使うことで、エラーや未定義変数に気づきやすくなります。

Claude Codeに依頼する場合は、次のように条件を付けます。

バックアップ用のシェルスクリプトを作成してください。

条件：
・set -euo pipefailを使う
・削除処理は入れない
・実行前に対象ディレクトリを表示する
・ログを出力する
・変数で保存先を変更できるようにする
・実行例も書く

自動化スクリプトでは、便利さより安全性を優先する必要があります。

特に、削除、上書き、権限変更を行う処理は慎重に扱うべきです。

ログ解析を自動化する

Ubuntuでは、アプリケーションログ、nginxログ、Apacheログ、systemdログなどを確認する機会が多くあります。

よく使うログ確認コマンドは次の通りです。

sudo journalctl -xe

sudo journalctl -u nginx -n 100

sudo tail -n 100 /var/log/nginx/error.log

sudo tail -f /var/log/nginx/access.log

Claude Codeには、ログを貼り付けて次のように依頼できます。

以下のログからエラー原因の候補を整理してください。

条件：
・原因候補を優先度順に並べる
・確認すべき設定ファイルを出す
・追加で実行すべき確認コマンドを出す
・断定できない場合は可能性として書く

ログ解析を自動化する場合は、機密情報を含めないことが重要です。

IPアドレス、トークン、メールアドレス、顧客情報などが含まれる場合は、伏せ字にしてから利用します。

Docker環境と組み合わせる

Ubuntuでの開発では、Dockerを使うケースが多くあります。

Claude CodeにDocker構成を確認させると、環境構築手順やトラブルシューティングを作りやすくなります。

よく使うコマンドは次の通りです。

docker –version

docker compose version

docker compose up -d

docker compose ps

docker compose logs -f

docker compose down

docker compose exec app bash

Claude Codeへの依頼例です。

このプロジェクトのDocker構成を確認して、開発環境の起動手順を作成してください。

確認対象：
・Dockerfile
・docker-compose.yml
・.env.example
・README.md

含める内容：
・初回セットアップ
・起動コマンド
・停止コマンド
・ログ確認方法
・コンテナ内に入る方法
・よくあるエラーと対処

Docker環境では、プロジェクトごとにサービス名や起動方法が異なるため、必ず設定ファイルを確認させることが重要です。

定型作業をプロンプト化する

Claude Codeで効率化するには、よく使う依頼文を定型化しておくと便利です。

たとえば、以下のようなプロンプトをメモしておきます。

現在のプロジェクト構成を確認してください。

確認してほしい内容：
・使用技術
・主要ディレクトリ
・起動方法
・テスト方法
・設定ファイル
・注意点

別の例です。

この機能の修正方針を整理してください。

条件：
・関連ファイルを確認する
・原因候補を出す
・最小限の修正案を出す
・影響範囲をまとめる
・修正前に実装方針を提示する

定型プロンプトを使うことで、毎回の指示が安定します。

プロンプトはREADMEやdocsディレクトリにまとめておくと、チーム内で共有しやすくなります。

カスタムコマンドで作業を短縮する

Claude Codeでは、よく使う作業をカスタムコマンド化すると効率が上がります。

たとえば、次のような作業を定型化できます。

・プロジェクト構成確認
・README更新
・API仕様書作成
・テスト作成
・Git差分整理
・PR説明文作成
・リリースノート作成

コマンド名の例です。

/project-check

/update-readme

/create-api-doc

/create-tests

/git-summary

/create-pr-description

カスタムコマンドにしておくと、長い指示文を毎回入力する必要がありません。

同じ品質で繰り返し作業したい場合に効果的です。

Hooksで自動化処理を実行する

Claude CodeにはHooksという仕組みがあり、特定のタイミングでコマンドを実行できます。

たとえば、ファイル編集後にフォーマッターを実行したり、Markdownのlintを実行したりできます。

よくある活用例は次の通りです。

・コード編集後にフォーマット
・Markdown更新後にlint
・テストファイル変更後にテスト実行
・危険なコマンドの実行前チェック
・作業完了後に通知

例として、Markdownの整形を行うコマンドです。

npx prettier –write README.md docs/*/.md

Markdownのlintを行うコマンドです。

npx markdownlint README.md docs/*/.md

Hooksは便利ですが、最初から複雑にしすぎると管理が難しくなります。

まずは、フォーマットやlintのような安全な処理から始めるのが現実的です。

CI/CD設定をClaude Codeで作成する

Ubuntuで開発しているプロジェクトでは、GitHub ActionsやGitLab CIを使う場面が多くあります。

Claude CodeにCI/CD設定を作らせる場合は、既存のpackage.json、composer.json、Dockerfileなどを確認させます。

依頼例です。

このプロジェクトにGitHub ActionsのCI設定を追加してください。

条件：
・既存のpackage.jsonを確認する
・依存関係をインストールする
・lintを実行する
・テストを実行する
・mainブランチへのpushとPull Requestで動作する
・不要な処理は入れない

設定例です。

name: CI

on:
pull_request:
push:
branches:
– main

jobs:
test:
runs-on: ubuntu-latest

steps:
  - name: Checkout
    uses: actions/checkout@v4

  - name: Setup Node
    uses: actions/setup-node@v4

  - name: Install dependencies
    run: npm ci

  - name: Run lint
    run: npm run lint

  - name: Run tests
    run: npm test

CI/CD設定は、プロジェクトによって内容が大きく変わります。

そのため、テンプレートをそのまま使うのではなく、必ずプロジェクトの構成に合わせて調整します。

ドキュメント生成を自動化する

Claude Codeは、コードベースからドキュメントを作る作業にも向いています。

README、環境構築手順、API仕様書、画面仕様書、運用手順書などを作成できます。

依頼例です。

このプロジェクトのREADMEを更新してください。

含める内容：
・プロジェクト概要
・使用技術
・環境構築手順
・起動方法
・テスト実行方法
・ディレクトリ構成
・注意点

条件：
・実際のコードと設定ファイルを確認する
・推測で断定しない
・不明点は要確認とする
・既存READMEの構成はできるだけ維持する

ドキュメント生成では、必ず根拠となるファイルを確認させることが重要です。

自動生成された文章は読みやすくても、実態とズレている可能性があります。

そのため、最終的には人間が確認する運用にします。

自動化環境で注意すべきセキュリティ

Claude CodeをUbuntuで使う場合、ターミナル操作と組み合わせるため、セキュリティには注意が必要です。

特に気をつけるべき点は次の通りです。

・APIキーを貼り付けない
・秘密鍵を読み込ませない
・.envの内容を不用意に表示しない
・本番環境で直接実行しない
・sudoが必要な操作は必ず確認する
・rmコマンドは慎重に扱う
・権限変更コマンドは内容を確認する
・Git差分を確認してからコミットする
・外部連携の権限を最小限にする

危険なコマンドの例です。

rm -rf

chmod -R 777

chown -R

docker system prune -a

git reset –hard

本番環境でClaude Codeを使う場合は、より慎重な運用が必要です。

基本的には、開発環境や検証環境で使用し、本番作業は人間の確認を必須にするべきです。

Ubuntuで使いやすい自動化プロンプト例

Ubuntu環境でよく使うプロンプトをまとめておくと、日常作業が早くなります。

環境確認用です。

このUbuntu環境の開発に必要な情報を確認するコマンドを整理してください。

含める内容：
・OS情報
・ディスク容量
・メモリ使用量
・Gitバージョン
・Dockerバージョン
・現在のディレクトリ
・実行ユーザー

ログ解析用です。

以下のログを確認して、エラー原因の候補と確認コマンドを整理してください。

条件：
・原因候補を優先度順に出す
・断定できない場合は可能性として書く
・次に確認するファイルを出す
・安全な確認コマンドを出す

Git作業用です。

現在のGit差分を確認して、コミットメッセージとPull Request説明文を作成してください。

含める内容：
・変更概要
・変更ファイル
・影響範囲
・確認方法
・レビューしてほしい点

このようなプロンプトを準備しておくと、Claude Codeを日常業務に組み込みやすくなります。

トラブル時の確認ポイント

Claude Codeがうまく動かない場合は、まず基本的な環境を確認します。

claude –help

which claude

echo $PATH

ls -la ~/.local/bin

curl –version

git –version

PATHが通っていない場合は、~/.bashrcに追記します。

echo ‘export PATH=”$HOME/.local/bin:$PATH”‘ >> ~/.bashrc

source ~/.bashrc

それでも動かない場合は、ターミナルを再起動します。

認証まわりで問題がある場合は、Claude Codeの案内に従って再ログインします。

ネットワーク制限、プロキシ、社内ファイアウォールがある環境では、通信が妨げられる場合があります。

実務でおすすめの構成

UbuntuでClaude Codeを使った自動化環境を作る場合、次の構成が扱いやすいです。

・Ubuntu本体
・Git
・curl
・Docker
・Claude Code
・CLAUDE.md
・docsディレクトリ
・scriptsディレクトリ
・GitHub Actions
・README.md

ディレクトリ構成例です。

project-root/
README.md
CLAUDE.md
docs/
scripts/
src/
tests/
.github/
workflows/

docsには設計メモや運用手順を置きます。

scriptsには自動化用シェルスクリプトを置きます。

.github/workflowsにはCI/CD設定を置きます。

このように役割を分けると、Claude Codeにも作業範囲を指示しやすくなります。

まとめ

UbuntuでClaude Codeを使うと、開発、調査、修正、テスト、ドキュメント作成、Git作業、ログ解析、CI/CD設定などを効率化できます。

導入は公式のインストールコマンドで行い、プロジェクトルートで起動して使うのが基本です。

効果的に使うには、CLAUDE.mdで作業ルールを固定し、scriptsやdocsを整備し、Git差分とテストで必ず確認することが重要です。

自動化環境を作る目的は、すべてをAIに任せることではありません。

繰り返し作業を減らし、人間が判断すべき部分に集中できる状態を作ることです。

UbuntuとClaude Codeを組み合わせることで、ターミナル中心の開発作業をより速く、整理された形で進められます。