<p data-line="1" class="code-line">Claude Code UIをnpxで起動したらエラーが発生しました。解決したので備忘録として残します。</p>
<h2 id="%E7%99%BA%E7%94%9F%E3%81%97%E3%81%9F%E3%82%A8%E3%83%A9%E3%83%BC" data-line="3" class="code-line"><a class="header-anchor-link" href="#%E7%99%BA%E7%94%9F%E3%81%97%E3%81%9F%E3%82%A8%E3%83%A9%E3%83%BC" aria-hidden="true"></a> 発生したエラー</h2>
<p data-line="5" class="code-line"><code>npx @siteboon/claude-code-ui</code> で起動すると、以下のエラーでクラッシュしました。</p>
<div class="code-block-container"><pre><code class="code-line" data-line="7">📖 Reading MCP servers from Claude config files
✅ Found Claude config at: /Users/xxx/.claude.json
📋 Found 0 MCP servers in config
Cursor MCP config not found: ENOENT: no such file or directory, open '/Users/xxx/.cursor/mcp.json'
node:_http_outgoing:700
    throw new ERR_HTTP_HEADERS_SENT('set');
    ^

Error [ERR_HTTP_HEADERS_SENT]: Cannot set headers after they are sent to the client
    at ServerResponse.setHeader (node:_http_outgoing:700:11)
    at ServerResponse.header (...express/lib/response.js:794:10)
    at ServerResponse.send (...express/lib/response.js:174:12)
    at ServerResponse.json (...express/lib/response.js:278:15)
    at ChildProcess.&lt;anonymous&gt; (file:///.../server/routes/codex.js:103:25)
</code></pre></div><p data-line="24" class="code-line">MCP設定を読み込んだ後、<code>server/routes/codex.js</code> でクラッシュしています。</p>
<h2 id="%E3%82%A8%E3%83%A9%E3%83%BC%E3%81%AE%E5%8E%9F%E5%9B%A0" data-line="26" class="code-line"><a class="header-anchor-link" href="#%E3%82%A8%E3%83%A9%E3%83%BC%E3%81%AE%E5%8E%9F%E5%9B%A0" aria-hidden="true"></a> エラーの原因</h2>
<p data-line="28" class="code-line"><code>ERR_HTTP_HEADERS_SENT</code> は、HTTPレスポンスを2回送信しようとしたときに発生するエラーです。Claude Code UIの <code>codex.js</code> 内でエラーハンドリングに問題があると推測されます。</p>
<p data-line="30" class="code-line">OpenAI Codex統合のコードが、使用していなくても読み込まれてエラーを起こしているようです。</p>
<h2 id="%E7%99%BA%E7%94%9F%E6%9D%A1%E4%BB%B6" data-line="32" class="code-line"><a class="header-anchor-link" href="#%E7%99%BA%E7%94%9F%E6%9D%A1%E4%BB%B6" aria-hidden="true"></a> 発生条件</h2>
<p data-line="34" class="code-line">以下の環境で確認しました。</p>
<ul data-line="36" class="code-line">
<li data-line="36" class="code-line">Claude Code UI: v1.13.6</li>
<li data-line="37" class="code-line">Node.js: v22.20.0</li>
<li data-line="38" class="code-line">npxでの起動時に発生しやすい</li>
<li data-line="39" class="code-line">グローバルインストール（<code>npm install -g</code>）でも発生することがある</li>
</ul>
<h2 id="%E8%A7%A3%E6%B1%BA%E6%96%B9%E6%B3%95" data-line="41" class="code-line"><a class="header-anchor-link" href="#%E8%A7%A3%E6%B1%BA%E6%96%B9%E6%B3%95" aria-hidden="true"></a> 解決方法</h2>
<p data-line="43" class="code-line">エラーが発生した場合は、以下の方法を試してください。</p>
<h3 id="%E5%86%8D%E8%B5%B7%E5%8B%95%E3%81%99%E3%82%8B" data-line="45" class="code-line"><a class="header-anchor-link" href="#%E5%86%8D%E8%B5%B7%E5%8B%95%E3%81%99%E3%82%8B" aria-hidden="true"></a> 再起動する</h3>
<p data-line="47" class="code-line">まず最初に試すべきは再起動です。<code>Ctrl+C</code> で停止し、再度同じコマンドを実行してください。</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="49">npx @siteboon/claude-code-ui
</code></pre></div><p data-line="53" class="code-line">一時的なエラーであれば、再起動で解消することがあります。</p>
<h3 id="%E5%88%A5%E3%81%AE%E8%B5%B7%E5%8B%95%E6%96%B9%E6%B3%95%E3%82%92%E8%A9%A6%E3%81%99" data-line="55" class="code-line"><a class="header-anchor-link" href="#%E5%88%A5%E3%81%AE%E8%B5%B7%E5%8B%95%E6%96%B9%E6%B3%95%E3%82%92%E8%A9%A6%E3%81%99" aria-hidden="true"></a> 別の起動方法を試す</h3>
<p data-line="57" class="code-line">再起動で解決しない場合は、別の起動方法を試してください。</p>
<p data-line="59" class="code-line"><strong>グローバルインストール</strong>：</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="61"><span class="token function">npm</span> <span class="token function">install</span> <span class="token parameter variable">-g</span> @siteboon/claude-code-ui
</code></pre></div><div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="65">claude-code-ui
</code></pre></div><p data-line="69" class="code-line"><strong>git clone</strong>：</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="71"><span class="token function">git</span> clone https://github.com/siteboon/claudecodeui.git
</code></pre></div><div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="75"><span class="token builtin class-name">cd</span> claudecodeui
</code></pre></div><div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="79"><span class="token function">npm</span> <span class="token function">install</span>
</code></pre></div><div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="83"><span class="token function">npm</span> run dev
</code></pre></div><p data-line="87" class="code-line">起動後、ブラウザで <code>http://localhost:3001</code> にアクセスすると使用できます。</p>
<h2 id="%E7%95%99%E6%84%8F%E7%82%B9" data-line="89" class="code-line"><a class="header-anchor-link" href="#%E7%95%99%E6%84%8F%E7%82%B9" aria-hidden="true"></a> 留意点</h2>
<p data-line="91" class="code-line">このエラーはClaude Code UI側のバグと思われます。将来のバージョンで修正される可能性があります。</p>
<p data-line="93" class="code-line">2026年1月時点では、GitHubのissuesに同様の報告は見つかりませんでした。もし同じエラーに遭遇した場合は、issueとして報告すると開発者の助けになるかもしれません。</p>
<p data-line="95" class="code-line">
    <iframe 
      class="hatenablogcard" 
      style="width:100%;height:155px;max-width:680px;" 
      src="https://hatenablog-parts.com/embed?url=https://github.com/siteboon/claudecodeui/issues" 
      width="300" 
      height="150" 
      frameborder="0" 
      scrolling="no">
    </iframe>       
    </p>


Claude Code UIのnpx起動エラーを解決する