Skip to content

common-creation/claudeway

Repository files navigation

claudeway - Answer to the Ultimate Question of Securing Claude Code Execution


Claude CodeをはじめとするAIコーディングエージェントを安全にDockerコンテナ内で実行するためのCLIツールです。

English version available

仕組み

カレントディレクトリをDockerコンテナにbind mountして起動します。
このとき、一部を除きホストの環境変数を引き継ぎ(dotenvフレンドリー)、設定ファイルに応じてコンテナを初期化、ホストと同一のUID・GIDでexecします。
これにより、万が一AIコーディングエージェントが rm -rf --no-preserve-root / を実行したとしても、ホストに致命的な影響がないようにします。

インストール

go install github.com/common-creation/claudeway@latest

使い方

初期設定

# グローバル設定とDockerアセットを初期化
claudeway init --global

# プロジェクトごとの設定を初期化
claudeway init

基本的な使い方

# コンテナを起動して対話的シェルに入る
claudeway up

# すでに起動しているコンテナの対話的シェルに入る
claudeway exec

# コンテナを停止・削除
claudeway down

その他のコマンド

# Dockerイメージをビルド
claudeway image build

# キャッシュなしでイメージをビルド
claudeway image build --no-cache

設定ファイル

claudeway.yaml の形式:

# ボリュームマウント設定
bind:
  - /var/run/docker.sock:/var/run/docker.sock  # Dockerソケット
  - ~/.claude.json:~/.claude.json               # Claude設定
  - ~/.claude:~/.claude                         # Claudeディレクトリ

# コンテナ内にコピーするファイル
copy:
  - ~/.gitconfig                                 # Git設定
  - ~/.ssh                                       # SSH鍵

# 初期化コマンド(コンテナ起動時に実行)
init:
  - curl -Ls get.docker.com | sh                # Docker インストール
  - asdf plugin add nodejs                       # Node.js プラグイン追加
  - asdf install nodejs 22.17.0                  # Node.js インストール
  - asdf global nodejs 22.17.0                   # デフォルトバージョン設定
  - npm i -g @anthropic-ai/claude-code          # Claude Code インストール

実際の例は claudeway.yaml を確認してください。

About

Answer to the Ultimate Question of Securing Claude Code Execution

Topics

Resources

License

Stars

Watchers

Forks