Claude Code完全ガイド：UbuntuでAI作業環境を作る
この記事の流れ
- この記事は誰向けか
- この記事でわかること
- 1. Claude Codeとは
- 1.1 Claude Codeの特徴
- 1.2 できること・できないこと
- 2. インストール
- 2.1 前提条件
- 2.2 インストール手順
- 2.3 APIキーの管理
- 3. 使う前に決めておくべき作業ルール
- 3.1 なぜルールが必要か
- 3.2 CLAUDE.mdの作成
- 3.3 作業ルールのポイント
- 4. 実践的なタスクの実行
- 4.1 基本的な使い方
- 4.2 よく使う指示パターン
- 4.3 効率的な指示のコツ
- 4.4 コマンド実行の承認
- 5. 自動化の限界と対策
- 5.1 自動化に向いているタスク
- 5.2 自動化の限界
- 5.3 対策
- 6. よくある質問
- Q. Claude Codeは無料で使えますか？
- Q. GitHub Copilotと何が違いますか？
- Q. APIキーが漏洩するリスクは？
- Q. オフラインで使えますか？
- Q. 生成されたコードのライセンスは？
- まとめ
- この記事を書いた人
- あわせて読みたい
この記事は誰向けか
Ubuntu環境でClaude Codeを使ってAI作業を始めたい方に向けて、インストールから実践的な使い方までを1記事にまとめました。
この記事でわかること
- Claude Codeとは何か、何ができるのか
- Ubuntuへのインストール手順
- 使う前に決めておくべき作業ルール
- 実践的なタスクの実行方法
- 自動化の限界と対策
- よくあるトラブルと対処法
1. Claude Codeとは
【結論】Claude Codeは、Anthropic社が提供するAIコーディングアシスタントで、ターミナルから直接コードの生成・編集・実行ができます。
1.1 Claude Codeの特徴
| 特徴 | 説明 |
|---|---|
| ターミナル統合 | CLIツールとして動作 |
| ファイル操作 | コードの読み取り・編集・作成が可能 |
| コマンド実行 | ターミナルコマンドの実行と結果確認 |
| コンテキスト理解 | プロジェクト全体の構造を把握 |
| マルチファイル編集 | 複数ファイルをまたぐ変更が可能 |
| 安全な実行 | 破壊的操作はユーザー承認後に実行 |
1.2 できること・できないこと
| できること | できないこと |
|---|---|
| コードの生成・編集 | インターネット検索（一部制限） |
| バグ修正 | GUIアプリの操作 |
| テストコードの作成 | 人間の判断が必要な設計決定 |
| リファクタリング | 機密情報の安全な取り扱い（注意が必要） |
| ドキュメント作成 | 100%バグのないコードの保証 |
| ターミナルコマンドの実行 | 物理的な操作 |
2. インストール
【結論】Node.jsがインストール済みの環境で、npm install -g @anthropic-ai/claude-code でインストールできます。
2.1 前提条件
- Node.js 18以上（nvmでインストール推奨）
- Anthropic APIキー（console.anthropic.comで取得）
2.2 インストール手順
# Claude Codeをインストール
npm install -g @anthropic-ai/claude-code
# 確認
claude --version
# 初回起動（APIキーの設定）
claude初回起動時にAPIキーの入力を求められます。APIキーは環境変数として設定することもできます。
# 環境変数に設定（.bashrcに追記）
echo 'export ANTHROPIC_API_KEY="your-api-key"' >> ~/.bashrc
source ~/.bashrc2.3 APIキーの管理
| 方法 | 安全性 | 推奨 |
|---|---|---|
| 環境変数 | 中 | 開発用 |
.envファイル | 低（gitignore必須） | プロジェクト用 |
| パスワードマネージャー | 高 | 長期運用用 |
注意： APIキーは絶対にGitリポジトリにコミットしないでください。.gitignore に .env を追加してください。
3. 使う前に決めておくべき作業ルール
【結論】Claude Codeを使い始める前に、プロジェクトのルールファイルを作成すると、AIの提案品質が安定します。
3.1 なぜルールが必要か
ルールがないと、AIがプロジェクトの慣習を無視した変更を提案することがあります。ルールファイルがあると、コーディングスタイル、使用ツール、禁止事項をAIに事前に伝えられます。
3.2 CLAUDE.mdの作成
プロジェクトのルートディレクトリに CLAUDE.md を作成します。
# プロジェクトルール
## 言語・フレームワーク
- 言語: TypeScript
- フレームワーク: Astro 5.x
- パッケージマネージャー: npm
## コーディング規約
- インデント: タブ
- セミコロン: なし
- コメント: 日本語可、ただしコード内には最小限
## 禁止事項
- 本番環境のAPIキーをコードに直接書き込まない
- テストを削除しない
- 依存パッケージを勝手にアップグレードしない
## ファイル構成
- src/pages/ — ページ
- src/components/ — コンポーネント
- src/content/blog/ — ブログ記事3.3 作業ルールのポイント
| ルール | 効果 |
|---|---|
| コーディングスタイル | 一貫したコード生成 |
| 禁止事項 | 危険な変更を防ぐ |
| ファイル構成 | 正しい場所にファイルを作成 |
| 使用ツール | 指定したツールを使う |
| テスト方針 | テストの品質を保つ |
4. 実践的なタスクの実行
4.1 基本的な使い方
# プロジェクトディレクトリで起動
cd ~/projects/my-app
claudeプロンプトに対話的に指示を入力します。
4.2 よく使う指示パターン
| 指示 | 例 |
|---|---|
| 機能追加 | 「ユーザー登録機能を追加して」 |
| バグ修正 | 「ログイン時にエラーが出る。修正して」 |
| リファクタリング | 「auth.tsをリファクタリングして」 |
| テスト作成 | 「user.tsのテストを書いて」 |
| ドキュメント | 「READMEを更新して」 |
| コードレビュー | 「最近の変更をレビューして」 |
4.3 効率的な指示のコツ
| コツ | 説明 |
|---|---|
| 具体的に書く | 「機能追加」より「ユーザー登録にメール認証を追加」 |
| ファイルを指定 | 「src/auth.tsのlogin関数を修正」 |
| 制約を書く | 「既存のテストは変更せずに」 |
| 段階的に進める | 大きな変更は複数回に分ける |
4.4 コマンド実行の承認
Claude Codeがターミナルコマンドを実行する際、ユーザーの承認を求めます。
| 操作 | 説明 |
|---|---|
y | 承認して実行 |
n | 拒否 |
y -a | 以降の同じコマンドを自動承認 |
注意： rm -rf や sudo を含むコマンドは特に慎重に確認してください。
5. 自動化の限界と対策
【結論】Claude Codeは強力ですが、長時間の自動実行には向きません。適切な監視と中断手段を用意することが重要です。
5.1 自動化に向いているタスク
| タスク | 向き度 | 理由 |
|---|---|---|
| コード生成 | 高 | 単一ファイルの変更 |
| バグ修正 | 高 | 原因箇所の特定と修正 |
| テスト作成 | 高 | 定型的な作業 |
| リファクタリング | 中 | 大規模変更は段階的に |
| デプロイ | 低 | 人間の判断が必要 |
| 設計判断 | 低 | アーキテクチャの決定 |
5.2 自動化の限界
| 限界 | 説明 |
|---|---|
| コンテキスト上限 | 長時間の作業で文脈が途切れる |
| トークン消費 | 長い対話はAPIコストが増加 |
| エラーの連鎖 | 一つの誤りが後続の作業に影響 |
| 判断の妥当性 | 複雑な設計判断は人間がすべき |
5.3 対策
| 対策 | 効果 |
|---|---|
| タスクを小さく分ける | コンテキストの途切れを防止 |
| 定期的にコミット | 進捗の保存とロールバック |
| テストで検証 | 変更の妥当性を確認 |
| 人間のチェックポイント | 重要な変更前に確認 |
| CLAUDE.mdの活用 | ルールの徹底 |
6. よくある質問
Q. Claude Codeは無料で使えますか？
Claude Code自体は無料ですが、Anthropic APIの利用料が発生します。APIの料金は使用量に応じた従量課金制です。
Q. GitHub Copilotと何が違いますか？
GitHub Copilotはエディタ内のコード補完が中心です。Claude Codeはターミナルから起動し、複数ファイルの編集、コマンド実行、プロジェクト全体の理解ができます。より自律的な作業が可能です。
Q. APIキーが漏洩するリスクは？
APIキーを環境変数で管理し、Gitにコミットしなければリスクは低いです。.envファイルを使う場合は必ず .gitignore に追加してください。
Q. オフラインで使えますか？
使えません。Claude CodeはAnthropicのAPIにリクエストを送信するため、インターネット接続が必要です。
Q. 生成されたコードのライセンスは？
生成されたコードの権利はユーザーに帰属します。ただし、既存のオープンソースコードを参考にした場合は、元のライセンスに従う必要があります。
まとめ
Claude CodeはUbuntu環境で強力なAIコーディングアシスタントとして使えます。
- インストール —
npm install -g @anthropic-ai/claude-code - ルール作成 —
CLAUDE.mdでプロジェクトの慣習を定義 - 実践 — 具体的な指示でタスクを実行
- 自動化の限界を理解 — 小さく分けて、定期的にコミット
AIに任せっきりにせず、人間のチェックポイントを挟むことが品質を保つ鍵です。
この記事を書いた人
しろみそ
Windows環境からUbuntuへ移行した経験をもとに、AIツール（Claude Code等）を日常的な作業に組み込む実践を記録しています。「Ubuntu × AI作業環境」という組み合わせの日本語情報が少なかったことが、このブログを始めたきっかけです。実際に手を動かして確認した手順を中心に書いています。