Claude Code ガイド

Appearance

スクリプト実行向け --bare フラグ：フック・LSP・スキルを省略した軽量モード ​

原文（日本語に翻訳） ​

スクリプト化された -p 呼び出し向けに --bare フラグを追加。フック、LSP、プラグイン同期、スキルディレクトリのウォークをスキップする。ANTHROPIC_API_KEY または --settings 経由の apiKeyHelper が必要（OAuthおよびキーチェーン認証は無効）。オートメモリも完全に無効化される。

原文（英語） ​

Added --bare flag for scripted -p calls — skips hooks, LSP, plugin sync, and skill directory walks; requires ANTHROPIC_API_KEY or an apiKeyHelper via --settings (OAuth and keychain auth disabled); auto-memory fully disabled

概要 ​

--bare フラグは、CI/CDパイプラインや自動化スクリプトでClaude Codeを使う際に、不要なオーバーヘッドを省いた軽量モードで実行するための新機能です。フック、LSP、プラグイン同期、スキルディレクトリのスキャンをすべてスキップするため、起動が高速になります。認証には ANTHROPIC_API_KEY 環境変数か --settings 経由の apiKeyHelper が必要で、OAuthやキーチェーン認証は使用できません。

基本的な使い方 ​

bash
# 環境変数でAPIキーを設定してから実行
export ANTHROPIC_API_KEY="your-api-key"
claude --bare -p "コードをレビューしてください"
bash
# --settings でカスタム設定ファイルを指定
claude --bare --settings /path/to/settings.json -p "テストを実行してください"

実践例 ​

### CI/CDパイプラインでの利用 ​

GitHub ActionsなどのCI環境で、軽量に Claude を呼び出す場合：

yaml
- name: Claude Code Review
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
  run: |
    claude --bare -p "このプルリクエストのコード変更をレビューしてください" \
      --output-format json

### バッチ処理スクリプトでの利用 ​

複数のファイルを順に処理するスクリプト：

bash
#!/bin/bash
export ANTHROPIC_API_KEY="your-api-key"

for file in src/*.py; do
  echo "Processing: $file"
  claude --bare -p "このファイルのバグを検出してください: $(cat $file)"
done

### カスタム設定ファイルを使った利用 ​

apiKeyHelper を設定ファイルで指定する場合：

json
{
  "apiKeyHelper": "/usr/local/bin/get-api-key.sh"
}
bash
claude --bare --settings ./ci-settings.json -p "ドキュメントを生成してください"

注意点 ​

  • 認証制限: --bare モードでは ANTHROPIC_API_KEY または apiKeyHelper のみ使用可能。OAuth認証やキーチェーン認証は使えない
  • オートメモリ無効: セッション間のメモリ機能が完全に無効化される。各実行は独立して動作する
  • フックスキップ: PreToolUse や PostToolUse などのフックが実行されないため、フックに依存した処理がある場合は注意
  • LSPなし: コード補完や構文チェックのためのLanguage Server Protocol機能は動作しない
  • -p フラグとの組み合わせ: --bare は非対話型の -p（プロンプト）フラグと組み合わせての使用を前提としている

関連情報 ​