Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

CLAUDE_CODE_PLUGIN_PREFER_HTTPSを追加しました。GitHubのSSH鍵がない環境で、プラグインのソースをSSHではなくHTTPS経由でクローンできます。

原文（英語） ​

Added CLAUDE_CODE_PLUGIN_PREFER_HTTPS to clone GitHub plugin sources over HTTPS instead of SSH, for environments without a GitHub SSH key

概要 ​

Claude CodeのプラグインはデフォルトでリポジトリをSSH（git@github.com:...）経由でクローンします。しかし企業ネットワークやCI/CD環境など、SSHポートがブロックされているか、GitHub SSH鍵が設定されていない環境では、プラグインのインストールが失敗することがありました。CLAUDE_CODE_PLUGIN_PREFER_HTTPS環境変数を設定することで、HTTPS経由でのクローンに切り替えられます。

基本的な使い方 ​

環境変数を設定するだけです。

bash
export CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1
claude plugin install <plugin-name>

または.bashrcや.zshrcに永続的に設定します。

bash
# ~/.bashrc または ~/.zshrc
export CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1

実践例 ​

CI/CD環境（GitHub Actions）でのプラグインインストール ​

yaml
# .github/workflows/claude-setup.yml
name: Claude Code Setup

on: [push]

jobs:
  setup:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install Claude Code plugins
        env:
          CLAUDE_CODE_PLUGIN_PREFER_HTTPS: "1"
          # SSH鍵不要、GitHubトークンのみでOK
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          npm install -g @anthropic-ai/claude-code
          claude plugin install my-org/my-claude-plugin

企業プロキシ環境でのセットアップ ​

bash
# プロキシ設定と組み合わせる
export HTTPS_PROXY=https://proxy.corp.example.com:8080
export CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1

# これでSSHポートのブロックを回避してプラグインをインストール
claude plugin install my-team/code-review-plugin

DevContainerやDockerでの設定 ​

dockerfile
# Dockerfile
FROM node:22

# Claude Codeインストール
RUN npm install -g @anthropic-ai/claude-code

# HTTPS経由でのプラグインクローンを有効化
ENV CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1

またはdevcontainer.json:

json
{
  "name": "My Dev Environment",
  "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
  "remoteEnv": {
    "CLAUDE_CODE_PLUGIN_PREFER_HTTPS": "1"
  },
  "postCreateCommand": "claude plugin install my-org/my-plugin"
}

既存のSSH設定と共存させる ​

この環境変数はプラグインのクローン処理にのみ影響します。通常のgit操作やSSH接続には影響しません。

bash
# SSH鍵は持っているが、プラグインだけHTTPSにしたい場合
export CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1

# 通常のgit操作は従来通りSSHを使用
git clone git@github.com:myorg/myrepo.git  # SSHのまま

# プラグインのみHTTPSを使用
claude plugin install myorg/myplugin       # HTTPS経由

注意点 ​

  • この環境変数はプラグインのソースコードをGitHubからクローンする際にのみ適用されます。
  • HTTPS経由でのクローンには、パブリックリポジトリなら認証不要です。プライベートリポジトリにはGITHUB_TOKENなどの認証情報が必要です。
  • 値は1、true、yesなど一般的な真値が使用できます。
  • 既にインストール済みのプラグインには影響しません。再インストール時から適用されます。

関連情報 ​