Skip to content

原文(日本語に翻訳)

CLAUDE_CODE_DISABLE_TERMINAL_TITLE 環境変数が起動時にターミナルタイトルが設定されることを防げない問題を修正しました

原文(英語)

Fixed CLAUDE_CODE_DISABLE_TERMINAL_TITLE not preventing terminal title from being set on startup

概要

CLAUDE_CODE_DISABLE_TERMINAL_TITLE 環境変数はClaude Codeがターミナルのタイトルバーを変更するのを防ぐための設定ですが、起動時(初期化処理中)にはこの設定が参照されず、ターミナルタイトルが一度設定されてしまう問題がありました。この修正により、環境変数が設定されていれば起動時からターミナルタイトルの変更が行われなくなります。

基本的な使い方

環境変数を設定することで、起動時を含めてすべてのタイミングでターミナルタイトルの変更を無効化できます。

bash
# ターミナルタイトルの変更を無効化
export CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1
claude

# 修正後: 起動時もターミナルタイトルが変更されない
# 修正前: 起動直後に一度だけタイトルが "Claude Code" に変更されていた

実践例

シェルの設定ファイルへの永続的な設定

bash
# ~/.zshrc または ~/.bashrc に追加
export CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1

# 設定を反映
source ~/.zshrc

# Claude Code起動時からタイトルが変更されないことを確認
claude

tmuxセッションでの使用

bash
# tmuxでは独自のタイトル管理をしている場合がある
# Claude Codeがタイトルを上書きしないよう設定
export CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1

# tmuxウィンドウのタイトルがClaude Codeに上書きされない
claude

複数ターミナルタブの管理

bash
# カスタムタイトルでタブを管理している場合
# タブ1: "開発環境"
# タブ2: "テスト環境"

# Claude Codeがタイトルを上書きしないよう設定
export CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1

# 各タブのカスタムタイトルが保持される
claude

iTerm2のプロファイル設定での利用

bash
# iTerm2のプロファイルに環境変数を設定する場合
# プロファイル > General > Environment で追加:
# CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1

# この設定により、iTerm2でのタイトル管理とClaudeが競合しない

注意点

  • 環境変数の値: 0 以外の任意の値(1, true, yes など)で機能します
  • 起動時の動作: 修正前は起動直後に一度タイトルが変更される問題がありました。修正後は完全にタイトル変更が抑制されます
  • 他のタイトル変更: Claude Code以外のアプリケーションによるタイトル変更はこの設定では制御できません
  • 確認方法: ターミナルのタイトルバーを直接確認するか、TERM_PROGRAMPS1 のカスタマイズと組み合わせて動作を確認できます

関連情報