📚 Claude Code 使用ガイド

Claude Code は Anthropic の公式 AI プログラミングアシスタントで、cch プロキシサービスを通じた統合をサポートしています。このガイドは、異なるオペレーティングシステムでのインストールと設定の完了を支援します。

macOS

環境セットアップ: Node.js のインストール

claude は Node.js ランタイム (v18 以上) が必要です。

方法1: Homebrew を使用 (推奨)

# 更新 Homebrew
brew update
# 安装 Node.js
brew install node

方法2: 公式ウェブサイトからダウンロード

  1. https://nodejs.org/ にアクセス https://nodejs.org/
  2. macOS 用の LTS バージョン (v18 以上が必要) をダウンロード
  3. ダウンロードした .pkg ファイルを開き、インストールウィザードに従う

インストール後、ターミナル/コマンドラインを開き、以下のコマンドを実行して確認:

node --version
npm --version

バージョン番号が表示されていれば、インストールは成功です!

claude をインストール claude

公式に推奨されるインストール方法で、以下の利点があります:

  • Node.js 依存関係のない単一実行可能ファイル
  • より安定した自動更新メカニズム
  • より高速な起動速度

方法1: Homebrew (推奨)

brew install --cask claude-code

自動更新情報

Homebrew 経由でインストールされた Claude Code は、DISABLE_AUTOUPDATER 環境変数で明示的に無効にされない限り、brew ディレクトリの外で自動更新されます。

方法2: curl スクリプト

# 安装稳定版(默认)
curl -fsSL https://claude.ai/install.sh | bash

# 安装最新版
curl -fsSL https://claude.ai/install.sh | bash -s latest

# 安装指定版本
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

インストールの確認

インストール後、以下のコマンドを実行して確認:

claude --version

バージョン番号が表示されていれば、Claude Code は正常にインストールされました。

ヒント

インストール前に、古いエイリアスまたはシンボリックリンクを削除していることを確認してください。claude doctor コマンドを使用してインストールタイプとバージョンを確認できます。

cch サービスに接続

方法1: settings.json 設定 (推奨)

設定ファイルのパス:

~/.claude/settings.json

パスの説明

  • Windows: C:/Users/your-username/.claude
  • Linux または macOS: ~/.claude
  • settings.json ファイルが存在しない場合は作成してください

settings.json ファイルを編集して以下の内容を追加:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here",
    "ANTHROPIC_BASE_URL": "現在のサイトアドレス",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

重要な注記

  • your-api-key-here を実際の API キーに置き換えます
  • キーの取得方法: コンソールにログイン → API キー管理 → キーを作成

方法2: 環境変数設定

一時設定 (現在のセッション):

export ANTHROPIC_BASE_URL="現在のサイトアドレス"
export ANTHROPIC_AUTH_TOKEN="your-api-key-here"

永続設定:

シェル設定ファイル ($~/.zshrc 或 ~/.bash_profile) に追加:

echo 'export ANTHROPIC_BASE_URL="現在のサイトアドレス"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key-here"' >> ~/.zshrc
source ~/.zshrc

設定の確認

設定後、環境変数が正しく設定されているかを確認:

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

予想される出力の例:

現在のサイトアドレス
sk_xxxxxxxxxxxxxxxxxx

注記

出力が空またはコマンド名そのものが表示されている場合は、環境変数の設定に失敗しています。上記の手順をもう一度実行してください。

VS Code 拡張機能の設定

設定ファイルの場所:~/.claude

  1. VS Code 拡張機能で Claude Code for VS Code を検索してインストール
  2. ~/.claude ディレクトリに config.json ファイルを作成 (存在しない場合)
  3. 以下の内容を追加:
// Path: ~/.claude
{
  "primaryApiKey": "any-value"
}

注記

  • これは config.json であり、settings.json ではありません
  • primaryApiKey フィールドの値は、存在する限り何でも構いません

claude を起動

プロジェクトディレクトリで以下のコマンドを実行:

cd /path/to/your/project
claude

初回起動時に claude は初期設定を実行します。

よくある質問

1. コマンドが見つかりません

# npm グローバルインストールパスを確認し、PATH に追加 (存在しない場合)
npm config get prefix

# 添加到 PATH(如果不在)
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

2. API 接続失敗

# 检查环境变量
echo $ANTHROPIC_AUTH_TOKEN

# 测试网络连接
curl -I 現在のサイトアドレス

3. claude を更新

npm install -g @anthropic-ai/claude-code

Windows

環境セットアップ: Node.js のインストール

claude は Node.js ランタイム (v18 以上) が必要です。

方法1: 公式ウェブサイトからダウンロード (推奨)

  1. https://nodejs.org/ にアクセス https://nodejs.org/
  2. LTS バージョン (v18 以上が必要) をダウンロード
  3. .msi ファイルをダブルクリックし、インストールウィザードに従う (デフォルト設定のままで可)

方法2: パッケージマネージャーを使用

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

ヒント

より良い体験のため、CMD ではなく PowerShell の使用をお勧めします

インストール後、ターミナル/コマンドラインを開き、以下のコマンドを実行して確認:

node --version
npm --version

バージョン番号が表示されていれば、インストールは成功です!

claude をインストール claude

公式に推奨されるインストール方法で、以下の利点があります:

  • Node.js 依存関係のない単一実行可能ファイル
  • より安定した自動更新メカニズム
  • より高速な起動速度

方法1: PowerShell

# 安定版をインストール (デフォルト)
irm https://claude.ai/install.ps1 | iex

# 最新版をインストール
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

# 特定バージョンをインストール
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

方法2: CMD

REM 安定版をインストール (デフォルト)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

REM 最新版をインストール
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd latest && del install.cmd

REM 特定バージョンをインストール
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd

インストールの確認

インストール後、以下のコマンドを実行して確認:

claude --version

バージョン番号が表示されていれば、Claude Code は正常にインストールされました。

ヒント

インストール前に、古いエイリアスまたはシンボリックリンクを削除していることを確認してください。claude doctor コマンドを使用してインストールタイプとバージョンを確認できます。

cch サービスに接続

方法1: settings.json 設定 (推奨)

設定ファイルのパス:

C:\Users\你的用户名\.claude\settings.json

パスの説明

  • Windows: C:/Users/your-username/.claude
  • Linux または macOS: ~/.claude
  • settings.json ファイルが存在しない場合は作成してください

settings.json ファイルを編集して以下の内容を追加:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here",
    "ANTHROPIC_BASE_URL": "現在のサイトアドレス",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

重要な注記

  • your-api-key-here を実際の API キーに置き換えます
  • キーの取得方法: コンソールにログイン → API キー管理 → キーを作成

方法2: 環境変数設定

一時設定 (現在のセッション):

$env:ANTHROPIC_BASE_URL = "現在のサイトアドレス"
$env:ANTHROPIC_AUTH_TOKEN = "your-api-key-here"

永続設定 (ユーザーレベル):

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "現在のサイトアドレス", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your-api-key-here", [System.EnvironmentVariableTarget]::User)

設定を有効にするには PowerShell ウィンドウを再度開く必要があります。

設定の確認

設定後、環境変数が正しく設定されているかを確認:

PowerShell で実行:

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

CMD で実行:

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%

予想される出力の例:

現在のサイトアドレス
sk_xxxxxxxxxxxxxxxxxx

注記

出力が空またはコマンド名そのものが表示されている場合は、環境変数の設定に失敗しています。上記の手順をもう一度実行してください。

VS Code 拡張機能の設定

設定ファイルの場所:C:\Users\你的用户名\.claude

  1. VS Code 拡張機能で Claude Code for VS Code を検索してインストール
  2. ~/.claude ディレクトリに config.json ファイルを作成 (存在しない場合)
  3. 以下の内容を追加:
// Path: C:\Users\你的用户名\.claude
{
  "primaryApiKey": "any-value"
}

注記

  • これは config.json であり、settings.json ではありません
  • primaryApiKey フィールドの値は、存在する限り何でも構いません

claude を起動

プロジェクトディレクトリで以下のコマンドを実行:

cd C:\path\to\your\project
claude

初回起動時に claude は初期設定を実行します。

よくある質問

1. コマンドが見つかりません

  • npm グローバルパス (通常は C:\Users\your-username\AppData\Roaming\npm) がシステム PATH に追加されていることを確認
  • PowerShell ウィンドウを再度開く

2. API 接続失敗

# 检查环境变量
echo $env:ANTHROPIC_AUTH_TOKEN

# 测试网络连接
Test-NetConnection -ComputerName 現在のサイトアドレス -Port 443

3. claude を更新

npm install -g @anthropic-ai/claude-code

Linux

環境セットアップ: Node.js のインストール

claude は Node.js ランタイム (v18 以上) が必要です。

方法1: 公式リポジトリを使用 (推奨)

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs

方法2: システムパッケージマネージャーを使用

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

インストール後、ターミナル/コマンドラインを開き、以下のコマンドを実行して確認:

node --version
npm --version

バージョン番号が表示されていれば、インストールは成功です!

claude をインストール claude

公式に推奨されるインストール方法で、以下の利点があります:

  • Node.js 依存関係のない単一実行可能ファイル
  • より安定した自動更新メカニズム
  • より高速な起動速度

curl スクリプトのインストール

# 安定版をインストール (デフォルト)
curl -fsSL https://claude.ai/install.sh | bash

# 最新版をインストール
curl -fsSL https://claude.ai/install.sh | bash -s latest

# 特定バージョンをインストール
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

Alpine Linux の特別な注記

musl/uClibc ベースのディストリビューション (Alpine Linux など) は追加の依存関係をインストールする必要があります:

apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0

インストールの確認

インストール後、以下のコマンドを実行して確認:

claude --version

バージョン番号が表示されていれば、Claude Code は正常にインストールされました。

ヒント

インストール前に、古いエイリアスまたはシンボリックリンクを削除していることを確認してください。claude doctor コマンドを使用してインストールタイプとバージョンを確認できます。

cch サービスに接続

方法1: settings.json 設定 (推奨)

設定ファイルのパス:

~/.claude/settings.json

パスの説明

  • Windows: C:/Users/your-username/.claude
  • Linux または macOS: ~/.claude
  • settings.json ファイルが存在しない場合は作成してください

settings.json ファイルを編集して以下の内容を追加:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here",
    "ANTHROPIC_BASE_URL": "現在のサイトアドレス",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

重要な注記

  • your-api-key-here を実際の API キーに置き換えます
  • キーの取得方法: コンソールにログイン → API キー管理 → キーを作成

方法2: 環境変数設定

一時設定 (現在のセッション):

export ANTHROPIC_BASE_URL="現在のサイトアドレス"
export ANTHROPIC_AUTH_TOKEN="your-api-key-here"

永続設定:

シェル設定ファイル ($~/.bashrc 或 ~/.zshrc) に追加:

echo 'export ANTHROPIC_BASE_URL="現在のサイトアドレス"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key-here"' >> ~/.bashrc
source ~/.bashrc

設定の確認

設定後、環境変数が正しく設定されているかを確認:

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

予想される出力の例:

現在のサイトアドレス
sk_xxxxxxxxxxxxxxxxxx

注記

出力が空またはコマンド名そのものが表示されている場合は、環境変数の設定に失敗しています。上記の手順をもう一度実行してください。

VS Code 拡張機能の設定

設定ファイルの場所:~/.claude

  1. VS Code 拡張機能で Claude Code for VS Code を検索してインストール
  2. ~/.claude ディレクトリに config.json ファイルを作成 (存在しない場合)
  3. 以下の内容を追加:
// Path: ~/.claude
{
  "primaryApiKey": "any-value"
}

注記

  • これは config.json であり、settings.json ではありません
  • primaryApiKey フィールドの値は、存在する限り何でも構いません

claude を起動

プロジェクトディレクトリで以下のコマンドを実行:

cd /path/to/your/project
claude

初回起動時に claude は初期設定を実行します。

よくある質問

1. コマンドが見つかりません

# npm グローバルインストールパスを確認し、PATH に追加 (存在しない場合)
npm config get prefix

# 添加到 PATH(如果不在)
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

2. API 接続失敗

# 检查环境变量
echo $ANTHROPIC_AUTH_TOKEN

# 测试网络连接
curl -I 現在のサイトアドレス

3. claude を更新

npm install -g @anthropic-ai/claude-code

📚 Codex CLI 使用ガイド

Codex は OpenAI の公式コマンドラインAIプログラミングアシスタントで、cch プロキシを通じた統合をサポートしています。注記: Codex は OpenAI 互換形式を使用し、エンドポイントには /v1 パスを含める必要があります。

macOS

環境セットアップ: Node.js のインストール

claude は Node.js ランタイム (v18 以上) が必要です。

方法1: Homebrew を使用 (推奨)

# 更新 Homebrew
brew update
# 安装 Node.js
brew install node

方法2: 公式ウェブサイトからダウンロード

  1. https://nodejs.org/ にアクセス https://nodejs.org/
  2. macOS 用の LTS バージョン (v18 以上が必要) をダウンロード
  3. ダウンロードした .pkg ファイルを開き、インストールウィザードに従う

インストール後、ターミナル/コマンドラインを開き、以下のコマンドを実行して確認:

node --version
npm --version

バージョン番号が表示されていれば、インストールは成功です!

codex をインストール codex

実行:

npm i -g @openai/codex --registry=https://registry.npmmirror.com

インストールの確認:

codex --version

cch サービスに接続

方法1: 設定ファイル方式 (推奨)

  1. ファイルエクスプローラーを開き、~/.codex フォルダを見つける (存在しない場合は作成)
  2. config.toml ファイルを作成
  3. テキストエディタで開き、以下の内容を追加:
model_provider = "cch"
model = "gpt-5.1-codex"
model_reasoning_effort = "high"
disable_response_storage = true
sandbox_mode = "workspace-write"

[features]
plan_tool = true
apply_patch_freeform = true
view_image_tool = true
web_search_request = true
unified_exec = false
streamable_shell = false
rmcp_client = true

[model_providers.cch]
name = "cch"
base_url = "現在のサイトアドレス/v1"
wire_api = "responses"
env_key = "CCH_API_KEY"
requires_openai_auth = true

[sandbox_workspace_write]
network_access = true
  1. auth.json ファイルを作成して追加:
{
  "OPENAI_API_KEY": "your-api-key-here"
}

重要な注記

  • your-api-key-here を cch API キーに置き換える
  • 注記: Codex は OpenAI 互換形式を使用し、エンドポイントには /v1 パスが含まれます

方法2: 環境変数設定

環境変数を設定:

echo 'export CCH_API_KEY="your-api-key-here"' >> ~/.zshrc
source ~/.zshrc

VS Code 拡張機能の設定

  1. VS Code 拡張機能で Codex – OpenAI's coding agent を検索してインストール
  2. 上記の手順に従って config.toml と auth.json を設定していることを確認
  3. CCH_API_KEY 環境変数を設定

重要

env_key は環境変数名 (例: CCH_API_KEY) のみで、完全なキーではありません。キーを直接入力するとトークンエラーが発生します。

codex を起動

プロジェクトディレクトリで以下のコマンドを実行:

cd /path/to/your/project
codex

初回起動時に codex は初期設定を実行します。

よくある質問

1. コマンドが見つかりません

# npm グローバルインストールパスを確認し、PATH に追加 (存在しない場合)
npm config get prefix

# 添加到 PATH(如果不在)
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

2. API 接続失敗

# 检查环境变量
echo $CCH_API_KEY

# 测试网络连接
curl -I 現在のサイトアドレス

3. codex を更新

npm i -g @openai/codex --registry=https://registry.npmmirror.com

Windows

環境セットアップ: Node.js のインストール

claude は Node.js ランタイム (v18 以上) が必要です。

方法1: 公式ウェブサイトからダウンロード (推奨)

  1. https://nodejs.org/ にアクセス https://nodejs.org/
  2. LTS バージョン (v18 以上が必要) をダウンロード
  3. .msi ファイルをダブルクリックし、インストールウィザードに従う (デフォルト設定のままで可)

方法2: パッケージマネージャーを使用

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

ヒント

より良い体験のため、CMD ではなく PowerShell の使用をお勧めします

インストール後、ターミナル/コマンドラインを開き、以下のコマンドを実行して確認:

node --version
npm --version

バージョン番号が表示されていれば、インストールは成功です!

codex をインストール codex

PowerShell を管理者として実行,実行:

npm i -g @openai/codex --registry=https://registry.npmmirror.com

インストールの確認:

codex --version

cch サービスに接続

方法1: 設定ファイル方式 (推奨)

  1. ファイルエクスプローラーを開き、C:\Users\你的用户名\.codex フォルダを見つける (存在しない場合は作成)
  2. config.toml ファイルを作成
  3. テキストエディタで開き、以下の内容を追加:
model_provider = "cch"
model = "gpt-5.1-codex"
model_reasoning_effort = "high"
disable_response_storage = true
sandbox_mode = "workspace-write"
windows_wsl_setup_acknowledged = true

[features]
plan_tool = true
apply_patch_freeform = true
view_image_tool = true
web_search_request = true
unified_exec = false
streamable_shell = false
rmcp_client = true

[model_providers.cch]
name = "cch"
base_url = "現在のサイトアドレス/v1"
wire_api = "responses"
env_key = "CCH_API_KEY"
requires_openai_auth = true

[sandbox_workspace_write]
network_access = true
  1. auth.json ファイルを作成して追加:
{
  "OPENAI_API_KEY": "your-api-key-here"
}

重要な注記

  • your-api-key-here を cch API キーに置き換える
  • 注記: Codex は OpenAI 互換形式を使用し、エンドポイントには /v1 パスが含まれます

方法2: 環境変数設定

PowerShell で実行:

[System.Environment]::SetEnvironmentVariable("CCH_API_KEY", "your-api-key-here", [System.EnvironmentVariableTarget]::User)

設定を有効にするには PowerShell ウィンドウを再度開く必要があります。

VS Code 拡張機能の設定

  1. VS Code 拡張機能で Codex – OpenAI's coding agent を検索してインストール
  2. 上記の手順に従って config.toml と auth.json を設定していることを確認
  3. CCH_API_KEY 環境変数を設定

重要

env_key は環境変数名 (例: CCH_API_KEY) のみで、完全なキーではありません。キーを直接入力するとトークンエラーが発生します。

codex を起動

プロジェクトディレクトリで以下のコマンドを実行:

cd C:\path\to\your\project
codex

初回起動時に codex は初期設定を実行します。

よくある質問

1. コマンドが見つかりません

  • npm グローバルパス (通常は C:\Users\your-username\AppData\Roaming\npm) がシステム PATH に追加されていることを確認
  • PowerShell ウィンドウを再度開く

2. API 接続失敗

# 检查环境变量
echo $env:CCH_API_KEY

# 测试网络连接
Test-NetConnection -ComputerName 現在のサイトアドレス -Port 443

3. codex を更新

npm i -g @openai/codex --registry=https://registry.npmmirror.com

Linux

環境セットアップ: Node.js のインストール

claude は Node.js ランタイム (v18 以上) が必要です。

方法1: 公式リポジトリを使用 (推奨)

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs

方法2: システムパッケージマネージャーを使用

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

インストール後、ターミナル/コマンドラインを開き、以下のコマンドを実行して確認:

node --version
npm --version

バージョン番号が表示されていれば、インストールは成功です!

codex をインストール codex

実行:

npm i -g @openai/codex --registry=https://registry.npmmirror.com

インストールの確認:

codex --version

cch サービスに接続

方法1: 設定ファイル方式 (推奨)

  1. ファイルエクスプローラーを開き、~/.codex フォルダを見つける (存在しない場合は作成)
  2. config.toml ファイルを作成
  3. テキストエディタで開き、以下の内容を追加:
model_provider = "cch"
model = "gpt-5.1-codex"
model_reasoning_effort = "high"
disable_response_storage = true
sandbox_mode = "workspace-write"

[features]
plan_tool = true
apply_patch_freeform = true
view_image_tool = true
web_search_request = true
unified_exec = false
streamable_shell = false
rmcp_client = true

[model_providers.cch]
name = "cch"
base_url = "現在のサイトアドレス/v1"
wire_api = "responses"
env_key = "CCH_API_KEY"
requires_openai_auth = true

[sandbox_workspace_write]
network_access = true
  1. auth.json ファイルを作成して追加:
{
  "OPENAI_API_KEY": "your-api-key-here"
}

重要な注記

  • your-api-key-here を cch API キーに置き換える
  • 注記: Codex は OpenAI 互換形式を使用し、エンドポイントには /v1 パスが含まれます

方法2: 環境変数設定

環境変数を設定:

echo 'export CCH_API_KEY="your-api-key-here"' >> ~/.bashrc
source ~/.bashrc

VS Code 拡張機能の設定

  1. VS Code 拡張機能で Codex – OpenAI's coding agent を検索してインストール
  2. 上記の手順に従って config.toml と auth.json を設定していることを確認
  3. CCH_API_KEY 環境変数を設定

重要

env_key は環境変数名 (例: CCH_API_KEY) のみで、完全なキーではありません。キーを直接入力するとトークンエラーが発生します。

codex を起動

プロジェクトディレクトリで以下のコマンドを実行:

cd /path/to/your/project
codex

初回起動時に codex は初期設定を実行します。

よくある質問

1. コマンドが見つかりません

# npm グローバルインストールパスを確認し、PATH に追加 (存在しない場合)
npm config get prefix

# 添加到 PATH(如果不在)
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

2. API 接続失敗

# 检查环境变量
echo $CCH_API_KEY

# 测试网络连接
curl -I 現在のサイトアドレス

3. codex を更新

npm i -g @openai/codex --registry=https://registry.npmmirror.com

📚 Gemini CLI 使用ガイド

Gemini CLI は Google 公式の AI プログラミングアシスタントコマンドラインツールで、cch プロキシサービスを通じた統合をサポートしています。このガイドは、異なるオペレーティングシステムでのインストールと設定を完了するのに役立ちます。

macOS

環境セットアップ: Node.js のインストール

claude は Node.js ランタイム (v18 以上) が必要です。

方法1: Homebrew を使用 (推奨)

# 更新 Homebrew
brew update
# 安装 Node.js
brew install node

方法2: 公式ウェブサイトからダウンロード

  1. https://nodejs.org/ にアクセス https://nodejs.org/
  2. macOS 用の LTS バージョン (v18 以上が必要) をダウンロード
  3. ダウンロードした .pkg ファイルを開き、インストールウィザードに従う

インストール後、ターミナル/コマンドラインを開き、以下のコマンドを実行して確認:

node --version
npm --version

バージョン番号が表示されていれば、インストールは成功です!

gemini をインストール gemini

Node.js 18 以降がインストールされていることを確認してから、Gemini CLI をグローバルにインストールします:

npm install -g @google/gemini-cli

インストールの確認:

gemini --version

cch サービスに接続

方法 1: 設定ファイル(推奨)

設定ディレクトリを作成

Gemini CLI の設定ファイルは ~/.gemini/ ディレクトリにあります。

macOS / Linux:

mkdir -p ~/.gemini
.env 設定ファイルを作成

~/.gemini/ ディレクトリに .env ファイルを作成します:

macOS / Linux:

nano ~/.gemini/.env

以下の内容を追加します:

GOOGLE_GEMINI_BASE_URL=現在のサイトアドレス
GEMINI_API_KEY=your-api-key-here
GEMINI_MODEL=gemini-3-pro-preview
settings.json 設定ファイルを作成

~/.gemini/ ディレクトリに settings.json ファイルを作成します:

{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

この設定ファイルは IDE 統合を有効にし、認証方法を API Key に設定します。

パラメータの説明

  • GOOGLE_GEMINI_BASE_URL: cch API ベース URL
  • GEMINI_API_KEY: cch コンソールで作成した API キー
  • GEMINI_MODEL: 使用するモデル(デフォルトは gemini-2.5-pro)

重要

  • YOUR_API_KEY_HERE を実際の API キーに置き換えてください
  • キーの取得方法:コンソールにログイン → API キー管理 → キーを作成

方法 2: 環境変数設定

一時的に使用したい場合は、環境変数で設定できます:

macOS / Linux:

export GOOGLE_GEMINI_BASE_URL="現在のサイトアドレス"
export GEMINI_API_KEY="your-api-key-here"
export GEMINI_MODEL="gemini-2.5-pro"

環境変数は現在のターミナルセッションでのみ有効です。永続的な設定には、設定ファイル方式を使用してください。

起動と確認

Gemini CLI を起動

プロジェクトディレクトリに移動して Gemini CLI を起動します:

cd /path/to/your/project
gemini

初回起動時、Gemini CLI は設定ファイルの設定を読み取ります。

設定の確認

Gemini CLI で簡単なリクエストを送信して接続をテストします:

こんにちは、Python の hello world プログラムを作成してください

Gemini CLI が正常に応答した場合、設定は成功です!

Agent Mode の使用

Gemini CLI は Agent Mode をサポートしており、複雑なタスクを自動的に計画して実行できます:

gemini --agent

Agent Mode では、Gemini は次のことを行います:

  • タスク要件を自動的に分析
  • 実行計画を策定
  • 段階的に実行して結果を検証
  • フィードバックに基づいて戦略を調整

よくある問題

1. コマンドが見つかりません

# npm グローバルインストールパスを確認し、PATH に追加 (存在しない場合)
npm config get prefix

# 添加到 PATH(如果不在)
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

2. API 接続失敗

  • 環境変数または設定ファイルの GEMINI_API_KEY が正しく設定されているか確認
  • GOOGLE_GEMINI_BASE_URL が正しいか確認
  • ネットワーク接続をテスト

3. gemini を更新

npm install -g @google/gemini-cli

Windows

環境セットアップ: Node.js のインストール

claude は Node.js ランタイム (v18 以上) が必要です。

方法1: 公式ウェブサイトからダウンロード (推奨)

  1. https://nodejs.org/ にアクセス https://nodejs.org/
  2. LTS バージョン (v18 以上が必要) をダウンロード
  3. .msi ファイルをダブルクリックし、インストールウィザードに従う (デフォルト設定のままで可)

方法2: パッケージマネージャーを使用

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

ヒント

より良い体験のため、CMD ではなく PowerShell の使用をお勧めします

インストール後、ターミナル/コマンドラインを開き、以下のコマンドを実行して確認:

node --version
npm --version

バージョン番号が表示されていれば、インストールは成功です!

gemini をインストール gemini

Node.js 18 以降がインストールされていることを確認してから、Gemini CLI をグローバルにインストールします:

npm install -g @google/gemini-cli

インストールの確認:

gemini --version

cch サービスに接続

方法 1: 設定ファイル(推奨)

設定ディレクトリを作成

Gemini CLI の設定ファイルは ~/.gemini/ ディレクトリにあります。

Windows (PowerShell):

mkdir $env:USERPROFILE\.gemini
.env 設定ファイルを作成

~/.gemini/ ディレクトリに .env ファイルを作成します:

Windows:%USERPROFILE%\.gemini\ ディレクトリに .env ファイルを作成

以下の内容を追加します:

GOOGLE_GEMINI_BASE_URL=現在のサイトアドレス
GEMINI_API_KEY=your-api-key-here
GEMINI_MODEL=gemini-3-pro-preview
settings.json 設定ファイルを作成

~/.gemini/ ディレクトリに settings.json ファイルを作成します:

{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

この設定ファイルは IDE 統合を有効にし、認証方法を API Key に設定します。

パラメータの説明

  • GOOGLE_GEMINI_BASE_URL: cch API ベース URL
  • GEMINI_API_KEY: cch コンソールで作成した API キー
  • GEMINI_MODEL: 使用するモデル(デフォルトは gemini-2.5-pro)

重要

  • YOUR_API_KEY_HERE を実際の API キーに置き換えてください
  • キーの取得方法:コンソールにログイン → API キー管理 → キーを作成

方法 2: 環境変数設定

一時的に使用したい場合は、環境変数で設定できます:

Windows (PowerShell):

$env:GOOGLE_GEMINI_BASE_URL="現在のサイトアドレス"
$env:GEMINI_API_KEY="your-api-key-here"
$env:GEMINI_MODEL="gemini-2.5-pro"

Windows (CMD):

set GOOGLE_GEMINI_BASE_URL=現在のサイトアドレス
set GEMINI_API_KEY=your-api-key-here
set GEMINI_MODEL=gemini-3-pro-preview

環境変数は現在のターミナルセッションでのみ有効です。永続的な設定には、設定ファイル方式を使用してください。

起動と確認

Gemini CLI を起動

プロジェクトディレクトリに移動して Gemini CLI を起動します:

cd C:\path\to\your\project
gemini

初回起動時、Gemini CLI は設定ファイルの設定を読み取ります。

設定の確認

Gemini CLI で簡単なリクエストを送信して接続をテストします:

こんにちは、Python の hello world プログラムを作成してください

Gemini CLI が正常に応答した場合、設定は成功です!

Agent Mode の使用

Gemini CLI は Agent Mode をサポートしており、複雑なタスクを自動的に計画して実行できます:

gemini --agent

Agent Mode では、Gemini は次のことを行います:

  • タスク要件を自動的に分析
  • 実行計画を策定
  • 段階的に実行して結果を検証
  • フィードバックに基づいて戦略を調整

よくある問題

1. コマンドが見つかりません

  • npm グローバルパス (通常は C:\Users\your-username\AppData\Roaming\npm) がシステム PATH に追加されていることを確認
  • PowerShell ウィンドウを再度開く

2. API 接続失敗

  • 環境変数または設定ファイルの GEMINI_API_KEY が正しく設定されているか確認
  • GOOGLE_GEMINI_BASE_URL が正しいか確認
  • ネットワーク接続をテスト

3. gemini を更新

npm install -g @google/gemini-cli

Linux

環境セットアップ: Node.js のインストール

claude は Node.js ランタイム (v18 以上) が必要です。

方法1: 公式リポジトリを使用 (推奨)

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs

方法2: システムパッケージマネージャーを使用

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

インストール後、ターミナル/コマンドラインを開き、以下のコマンドを実行して確認:

node --version
npm --version

バージョン番号が表示されていれば、インストールは成功です!

gemini をインストール gemini

Node.js 18 以降がインストールされていることを確認してから、Gemini CLI をグローバルにインストールします:

npm install -g @google/gemini-cli

インストールの確認:

gemini --version

cch サービスに接続

方法 1: 設定ファイル(推奨)

設定ディレクトリを作成

Gemini CLI の設定ファイルは ~/.gemini/ ディレクトリにあります。

macOS / Linux:

mkdir -p ~/.gemini
.env 設定ファイルを作成

~/.gemini/ ディレクトリに .env ファイルを作成します:

macOS / Linux:

nano ~/.gemini/.env

以下の内容を追加します:

GOOGLE_GEMINI_BASE_URL=現在のサイトアドレス
GEMINI_API_KEY=your-api-key-here
GEMINI_MODEL=gemini-3-pro-preview
settings.json 設定ファイルを作成

~/.gemini/ ディレクトリに settings.json ファイルを作成します:

{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

この設定ファイルは IDE 統合を有効にし、認証方法を API Key に設定します。

パラメータの説明

  • GOOGLE_GEMINI_BASE_URL: cch API ベース URL
  • GEMINI_API_KEY: cch コンソールで作成した API キー
  • GEMINI_MODEL: 使用するモデル(デフォルトは gemini-2.5-pro)

重要

  • YOUR_API_KEY_HERE を実際の API キーに置き換えてください
  • キーの取得方法:コンソールにログイン → API キー管理 → キーを作成

方法 2: 環境変数設定

一時的に使用したい場合は、環境変数で設定できます:

macOS / Linux:

export GOOGLE_GEMINI_BASE_URL="現在のサイトアドレス"
export GEMINI_API_KEY="your-api-key-here"
export GEMINI_MODEL="gemini-2.5-pro"

環境変数は現在のターミナルセッションでのみ有効です。永続的な設定には、設定ファイル方式を使用してください。

起動と確認

Gemini CLI を起動

プロジェクトディレクトリに移動して Gemini CLI を起動します:

cd /path/to/your/project
gemini

初回起動時、Gemini CLI は設定ファイルの設定を読み取ります。

設定の確認

Gemini CLI で簡単なリクエストを送信して接続をテストします:

こんにちは、Python の hello world プログラムを作成してください

Gemini CLI が正常に応答した場合、設定は成功です!

Agent Mode の使用

Gemini CLI は Agent Mode をサポートしており、複雑なタスクを自動的に計画して実行できます:

gemini --agent

Agent Mode では、Gemini は次のことを行います:

  • タスク要件を自動的に分析
  • 実行計画を策定
  • 段階的に実行して結果を検証
  • フィードバックに基づいて戦略を調整

よくある問題

1. コマンドが見つかりません

# npm グローバルインストールパスを確認し、PATH に追加 (存在しない場合)
npm config get prefix

# 添加到 PATH(如果不在)
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

2. API 接続失敗

  • 環境変数または設定ファイルの GEMINI_API_KEY が正しく設定されているか確認
  • GOOGLE_GEMINI_BASE_URL が正しいか確認
  • ネットワーク接続をテスト

3. gemini を更新

npm install -g @google/gemini-cli

📚 Droid CLI 使用ガイド

Droid は Factory AI が開発したインタラクティブターミナル AI プログラミングアシスタントで、cch プロキシサービスを通じた統合をサポートしています。使用する前に、Droid 公式アカウントに登録してログインする必要があります。

macOS

droid をインストール droid

実行:

curl -fsSL https://app.factory.ai/cli | sh

cch サービスに接続

前提条件: まず Droid 公式アカウントにログイン

  1. droid コマンドを実行
  2. プロンプトに従ってブラウザから Factory 公式アカウントにログイン
  3. 正常にログインしたら、カスタムモデルの設定に進みます

カスタムモデルの設定

設定ファイルのパス:

~/.factory/config.json

設定ファイルを編集して以下の内容を追加:

{
  "custom_models": [
    {
      "model_display_name": "Sonnet 4.5 [cch]",
      "model": "claude-sonnet-4-5-20250929",
      "base_url": "現在のサイトアドレス",
      "api_key": "your-api-key-here",
      "provider": "anthropic"
    },
    {
      "model_display_name": "GPT-5-Codex [cch]",
      "model": "gpt-5-codex",
      "base_url": "現在のサイトアドレス/v1",
      "api_key": "your-api-key-here",
      "provider": "openai"
    }
  ]
}

重要な注記

  • your-api-key-here を cch API キーに置き換える
  • Anthropic 形式: 現在のサイトアドレス を使用 (/v1 なし)
  • OpenAI 形式: 現在のサイトアドレス/v1 を使用 (/v1 が必要)

モデルの切り替え

  1. Droid を再起動
  2. /model コマンドを入力
  3. GPT-5-Codex [cch] または Sonnet 4.5 [cch] を選択
  4. 使用開始!

droid を起動

プロジェクトディレクトリで以下のコマンドを実行:

cd /path/to/your/project
droid

初回起動時、droid は初期設定を実行します。

よくある質問

1. コマンドが見つかりません

# npm グローバルインストールパスを確認し、PATH に追加 (まだの場合)
npm config get prefix

# 添加到 PATH(如果不在)
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

2. droid を更新

インストールスクリプトを再度実行して最新バージョンに更新してください。

Windows

droid をインストール droid

PowerShell で実行:

irm https://app.factory.ai/cli/windows | iex

cch サービスに接続

前提条件: まず Droid 公式アカウントにログイン

  1. droid コマンドを実行
  2. プロンプトに従ってブラウザから Factory 公式アカウントにログイン
  3. 正常にログインしたら、カスタムモデルの設定に進みます

カスタムモデルの設定

設定ファイルのパス:

%USERPROFILE%\.factory\config.json

設定ファイルを編集して以下の内容を追加:

{
  "custom_models": [
    {
      "model_display_name": "Sonnet 4.5 [cch]",
      "model": "claude-sonnet-4-5-20250929",
      "base_url": "現在のサイトアドレス",
      "api_key": "your-api-key-here",
      "provider": "anthropic"
    },
    {
      "model_display_name": "GPT-5-Codex [cch]",
      "model": "gpt-5-codex",
      "base_url": "現在のサイトアドレス/v1",
      "api_key": "your-api-key-here",
      "provider": "openai"
    }
  ]
}

重要な注記

  • your-api-key-here を cch API キーに置き換える
  • Anthropic 形式: 現在のサイトアドレス を使用 (/v1 なし)
  • OpenAI 形式: 現在のサイトアドレス/v1 を使用 (/v1 が必要)

モデルの切り替え

  1. Droid を再起動
  2. /model コマンドを入力
  3. GPT-5-Codex [cch] または Sonnet 4.5 [cch] を選択
  4. 使用開始!

droid を起動

プロジェクトディレクトリで以下のコマンドを実行:

cd C:\path\to\your\project
droid

初回起動時、droid は初期設定を実行します。

よくある質問

1. コマンドが見つかりません

  • npm グローバルパス (通常 C:\Users\your-username\AppData\Roaming\npm) がシステム PATH に追加されていることを確認
  • PowerShell ウィンドウを再起動

2. droid を更新

インストールスクリプトを再度実行して最新バージョンに更新してください。

Linux

droid をインストール droid

実行:

curl -fsSL https://app.factory.ai/cli | sh

ヒント

Linux ユーザーは xdg-utils がインストールされていることを確認:

sudo apt-get install xdg-utils

cch サービスに接続

前提条件: まず Droid 公式アカウントにログイン

  1. droid コマンドを実行
  2. プロンプトに従ってブラウザから Factory 公式アカウントにログイン
  3. 正常にログインしたら、カスタムモデルの設定に進みます

カスタムモデルの設定

設定ファイルのパス:

~/.factory/config.json

設定ファイルを編集して以下の内容を追加:

{
  "custom_models": [
    {
      "model_display_name": "Sonnet 4.5 [cch]",
      "model": "claude-sonnet-4-5-20250929",
      "base_url": "現在のサイトアドレス",
      "api_key": "your-api-key-here",
      "provider": "anthropic"
    },
    {
      "model_display_name": "GPT-5-Codex [cch]",
      "model": "gpt-5-codex",
      "base_url": "現在のサイトアドレス/v1",
      "api_key": "your-api-key-here",
      "provider": "openai"
    }
  ]
}

重要な注記

  • your-api-key-here を cch API キーに置き換える
  • Anthropic 形式: 現在のサイトアドレス を使用 (/v1 なし)
  • OpenAI 形式: 現在のサイトアドレス/v1 を使用 (/v1 が必要)

モデルの切り替え

  1. Droid を再起動
  2. /model コマンドを入力
  3. GPT-5-Codex [cch] または Sonnet 4.5 [cch] を選択
  4. 使用開始!

droid を起動

プロジェクトディレクトリで以下のコマンドを実行:

cd /path/to/your/project
droid

初回起動時、droid は初期設定を実行します。

よくある質問

1. コマンドが見つかりません

# npm グローバルインストールパスを確認し、PATH に追加 (まだの場合)
npm config get prefix

# 添加到 PATH(如果不在)
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

2. droid を更新

インストールスクリプトを再度実行して最新バージョンに更新してください。


📚 よく使用されるコマンド

Claude Code を起動した後、以下のよく使用されるコマンドを使用できます:

🔍 一般的なトラブルシューティング

インストール失敗

  • ネットワーク接続が正常であることを確認
  • 管理者権限 (Windows) または sudo (macOS / Linux) があることを確認
  • プロキシまたはミラーソースを使用してみてください (npm は --registry パラメータを使用可能)

API キーが無効

  • キーが正しくコピーされていることを確認 (余分なスペースがないこと)
  • キーが有効期間内であることを確認
  • アカウント権限が正常であることを確認
  • 正しいエンドポイント形式が使用されていることを確認 (Anthropic に /v1 なし、OpenAI に /v1 あり)

エンドポイント設定エラー

  • Claude Code / Droid Anthropic モデル: 現在のサイトアドレス を使用 (/v1 なし)
  • Codex / Droid OpenAI モデル: 現在のサイトアドレス/v1 を使用 (/v1 が必須)