Claude Code

Claude Code は Anthropic 公式の AI コーディングエージェント CLI です。コードベースを理解し、コードの生成・編集、コマンドの実行、複雑な開発タスクの支援をすべてコマンドラインから行います。

このテンプレートは Claude Code を Zeabur 上の永続的な開発者ワークステーションとしてデプロイし、ブラウザからアクセス可能な Web ターミナル（ttyd）を提供します。

はじめに

1. テンプレートをデプロイし、サービスの起動を待ちます。初回起動時に Claude Code とチャンネルプラグインが自動インストールされます。ヘルスチェックが緑になるまでお待ちください。
2. ブラウザでサービス URL を開きます（サービスにバインドされたドメイン）。
3. ログイン — Zeabur ダッシュボードの Instructions タブに表示されるパスワードを入力します。
4. オプションを選択 — 必要な機能にチェックを入れます（権限スキップ、Telegram/Discord チャンネルなど）。
5. Bot トークンを入力（チャンネル使用時） — 表示された入力欄に Bot トークンを貼り付けます。
6. コマンドをコピーし、Enter Terminal をクリックします。
7. Claude Code を認証 — コマンドを貼り付け、プロンプトに従って Claude Pro/Max/Team/Enterprise サブスクリプションでログインします。

チャンネル（Telegram / Discord）

チャンネル機能を使うと、Telegram や Discord からスマートフォンで Claude Code と会話できます。サーバー上でファイルを操作しながらやり取りが可能です。

セットアップ手順

1. ボットを作成 — Telegram は BotFather、Discord は Developer Portal で作成します（Message Content Intent を有効にし、ボットをサーバーに招待してメッセージ送信権限を付与してください）。
2. ランディングページでチャンネルを選択し、Bot トークンを貼り付けます。
3. コマンドをコピーしてターミナルで実行 — チャンネルが自動的に起動します。
4. アカウントをペアリング — ボットにダイレクトメッセージを送ると、ペアリングコードが返されます。Claude Code で /discord:access pair <code> または /telegram:access pair <code> を実行します。
5. アクセスをロック — /discord:access policy allowlist または /telegram:access policy allowlist を実行して、自分だけがメッセージを送れるようにします。

ペアリング完了後、Telegram/Discord 経由で Claude と会話できます。Bot トークンはブラウザに保存され、次回再入力は不要です。

注意事項

• チャンネルには Claude Pro/Max/Team/Enterprise サブスクリプションが必要です（API キーでは使用できません）。
• Bot トークンは環境変数としてコマンドに付加されます（例：DISCORD_BOT_TOKEN=xxx claude ...）。サーバーには保存されません。
• チャンネルは Claude Code の実験的機能です。

API キーの使用（オプション）

サブスクリプションの代わりに API キー認証を使用する場合：

1. ANTHROPIC_API_KEY を Anthropic API キーに設定します。console.anthropic.com から取得できます。
2. オプションで ANTHROPIC_BASE_URL を設定し、Zeabur AI Hub を使用できます（例：https://ai.hub.zeabur.com）。

よく使うコマンド

コマンド	説明
claude	インタラクティブな Claude Code セッションを起動
claude -p "プロンプト"	ワンショットプロンプトを実行
claude login	Anthropic アカウントで認証
claude --version	インストール済みバージョンを確認
claude config	設定を表示・変更

永続ストレージ

/home/node ディレクトリは永続ボリュームとしてマウントされています。/home/node 配下に保存されたプロジェクト、Claude Code の設定、セッションデータはすべてサービスの再起動や再デプロイ後も保持されます。

推奨ワークフロー：

• リポジトリを /home/node/projects/ にクローン
• Claude Code の設定は /home/node/.claude/ に保存されます

環境変数

変数	必須	説明
ANTHROPIC_API_KEY	いいえ	Anthropic API キーまたは Zeabur AI Hub トークン（サブスクリプションログインを使用しない場合のみ必要）
ANTHROPIC_BASE_URL	いいえ	カスタム API エンドポイント（Zeabur AI Hub 使用時に設定）
WEB_TERMINAL_PASSWORD	自動	Web ターミナルのログインパスワード（自動生成、ダッシュボードで確認可能）

推奨リソース（公式要件）

• 最小構成：1 vCPU / 4 GB RAM
• 推奨構成：2 vCPU / 4 GB RAM

Claude Code の公式システム要件は 4 GB 以上の RAM です。AI 処理は Anthropic API 側で行われるため、ローカルでは Node.js CLI とシェルツールのみが動作し、CPU 要件は低めです。

変更履歴

2026-04-02 — チャンネルサポートとランディングページの再設計

• ランディングページをチェックボックス式コマンドビルダーに変更
• チャンネルサポート：Telegram、Discord、iMessage（--channels フラグ）
• CLAUDE_CODE_PLUGIN_SEED_DIR でチャンネルプラグインをプリインストール
• Bun ランタイムをプリインストール（チャンネルプラグインの依存関係）
• ランディングページで Bot トークンを直接入力可能（環境変数としてコマンドに付加）

2026-03-31 — 初回リリース

• ttyd Web ターミナル（パスワード認証）
• Claude Code ネイティブインストーラー（初回起動時に自動インストール）
• Homebrew および npm グローバルパッケージをボリュームに永続化
• リソース要件およびドメインバインディング

リンク

• Claude Code 公式ドキュメント
• Anthropic Console
• Zeabur AI Hub