clauderipple 0.4.1 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,61 @@
 # Changelog
 
+## 0.5.1 — 2026-09-28
+
+### Fixed
+
+- **Prompt caching on anthropic-compatible providers** (#36, #37, by @grapefruit0205).
+  Claude Code's billing header opens the system prompt and changes every turn, so a
+  vendor with a plain prefix cache cached nothing after it: DeepSeek via Alibaba Bailian
+  reported 0.3% over two days. The header is now dropped for these providers, as it
+  already was for the translated ones; measured 99% on the next turns.
+- **Switching a session from a translated model to Claude.** The translated providers
+  return reasoning as unsigned, sometimes empty `thinking` blocks, and Anthropic refused
+  every turn after the switch with "each thinking block must contain thinking". Unsigned
+  thinking is now dropped before a request reaches Anthropic.
+- **Windows install when the user name equals the computer name** (#38, reported by
+  @haemilchu). The scheduled task is registered as `DOMAIN\user`; the bare name did not
+  resolve and registration failed with 0x80070057 before `settings.json` was written.
+- **Windows reinstall no longer re-registers a correct task.** The check read two
+  battery settings under names the task object does not have, so it never matched and
+  every install registered again — what fails on machines that protect the task.
+  Checked in a Windows 11 VM.
+- **`clauderipple` in a new PowerShell window** (#38). The installer leaves no `.ps1`
+  shim, so PowerShell runs the `.cmd` under the default execution policy.
+
+## 0.5.0 — 2026-09-24
+
+Linux, and four fixes from the first outside contributions.
+
+### Added
+
+- **Linux** (#28, #33, #34, by @grapefruit0205). `install`, `status`, `restart` and
+  `uninstall` work where there is a systemd user session: the router runs as
+  `~/.config/systemd/user/clauderipple.service`, with no sudo. A health self-exit is
+  restarted after two seconds, and a stop waits out the 90-second drain. Picker mode
+  trusts the local CA in the NSS database Chromium reads (`~/.pki/nssdb`, your user
+  only) and needs `certutil` (`libnss3-tools` / `nss-tools`). Measured by the
+  contributor on Ubuntu 24.04 x64 with Claude Desktop 2.2553.13.
+
+### Fixed
+
+- **`npm test` no longer rewrites your real `~/.claude/settings.json`** (#16, #26, #30).
+  The admin tests isolated the router's home but not the Claude settings path, so a
+  test run pointed `NODE_EXTRA_CA_CERTS` at a temp directory it then deleted, and every
+  Claude Code session on the machine failed until the file was fixed by hand.
+- **A failed install leaves `settings.json` alone** (#27, #31). The proxy settings are
+  now written only after the end-to-end probe passes, and `picker on` checks the
+  router is answering before it points Claude Desktop at it.
+- **Anthropic-compatible providers keep the conversation after a tool call** (#29, #32).
+  Claude Code's `thread: continue` carries only the new messages; the router stripped
+  the field and forwarded that delta, so the model got orphan tool results and no task.
+  It is now refused as for the translated providers, and the CLI resends the full turn.
+- **`picker on` and `status` from a PowerShell 7 terminal on Windows** (#35). Windows
+  PowerShell inherited PowerShell 7's module path and lost the `Cert:` drive: `picker on`
+  stopped at "Cannot find drive 'Cert'" and `status` called a trusted CA untrusted.
+  Every `powershell.exe` we start now drops the inherited `PSModulePath`. Reproduced
+  and checked in a Windows 11 VM.
+
 ## 0.4.1 — 2026-09-24
 
 ### Fixed

package/README.ko.md

@@ -19,6 +19,7 @@
   <a href="LICENSE"><img alt="GPL-3.0" src="https://img.shields.io/badge/license-GPL--3.0-blue"></a>
   <img alt="macOS" src="https://img.shields.io/badge/macOS-arm64%20%7C%20x64-black">
   <img alt="Windows" src="https://img.shields.io/badge/Windows-arm64%20%7C%20x64-0078D4">
+  <img alt="Linux" src="https://img.shields.io/badge/Linux-x64%20(systemd)-FCC624">
   <img alt="Node" src="https://img.shields.io/badge/node-24%2B-success">
   <a href="README.md"><img alt="English" src="https://img.shields.io/badge/docs-English-blue"></a>
 </p>
@@ -73,8 +74,10 @@ Claude에 돈을 내고 있다면 3P는 선택지가 아닙니다. 낸 돈의
 
 ### 클로드 데스크톱 앱에서 GPT를 쓸 수 있나요?
 
-됩니다. ClaudeRipple을 설치하고 Claude 모델 이름 하나를 GPT 모델에 매핑하면, Code 탭이 GPT로 답합니다.
-모델 피커에는 GPT의 실제 이름이 뜹니다. 앱 자체는 고치지도 않고, 다른 모드로 바꾸지도 않습니다.
+됩니다. **Code 탭**과 그 서브에이전트에서 됩니다. ClaudeRipple을 설치하고 ChatGPT Plus나 Pro 구독으로
+로그인하면, GPT(챗GPT의 GPT-6 Sol·Luna·Astra, GPT-5.6 Terra 등)가 모델 피커에 실제 이름으로 뜨고, 고른 추론 강도
+그대로 답합니다. 앱 자체는 고치지도 않고, 다른 모드로 바꾸지도 않습니다. 일반 **채팅** 탭은 Claude 그대로입니다.
+채팅까지 바꾸려면 앱 전체를 게이트웨이 모드로 돌려야 해서 어떤 도구도 못 합니다([1P냐 3P냐](#1p냐-3p냐--이-프로젝트가-존재하는-이유) 참고).
 
 ### Claude Code(터미널)에서 GPT를 쓰려면요?
 
@@ -109,43 +112,96 @@ ChatGPT 구독으로 GPT를 쓰고, OpenRouter나 직접 API 키로 DeepSeek·Ki
 ### 윈도우에서도 되나요?
 
 됩니다. macOS와 Windows, arm64와 x64 모두. 설치·대시보드·재시작·제거를 Windows 11 arm64에서 실측했고,
-x64 런타임은 에뮬레이션으로 확인했습니다.
+x64 런타임은 에뮬레이션으로 확인했습니다. systemd 사용자 세션이 있는 Linux에서도 됩니다. 설치, 라우터를 거친
+Code 탭 요청, 스트리밍 응답 도중의 재시작, 제거를 Ubuntu 24.04 x64와 Claude Desktop 2.2553.13에서
+실측했습니다. 피커 모드도 됩니다. `cli.extraModels`의 모델이 Code 탭 피커에 Claude 모델과 나란히 뜹니다.
 
 ### 제 코드가 다른 데로 가나요?
 
 가지 않습니다. 프록시는 내 컴퓨터에서 돕니다. 요청은 설정한 프로바이더로만 가고, 자격증명은
 홈 디렉터리에만 저장됩니다. [개인정보](#개인정보) 절을 보세요.
 
+### Claude 계정이 정지(밴)되지 않나요? 약관 위반 아닌가요?
+
+ClaudeRipple이 Claude에 하는 일은 작고 확인할 수 있습니다. Claude로 가는 요청은 Claude Code가 보낸 그대로
+한 바이트도 바꾸지 않고 나가고, GPT 등 다른 프로바이더로 보낸 요청은 Anthropic에 아예 가지 않습니다. 앱을 고치는
+방식이 아니라, Claude Code가 회사 네트워크용으로 문서화해 둔 프록시·인증서 설정(`HTTPS_PROXY`,
+`NODE_EXTRA_CA_CERTS` — 공식 문서 [Enterprise network configuration](https://code.claude.com/docs/en/corporate-proxy))을 씁니다. 계정 정지 사례로 알려진 것은 반대 방향, 즉 Claude 구독 로그인을 **다른 프로그램**에서
+쓰는 경우입니다. ClaudeRipple에도 그런 선택 기능이 하나 있습니다. Codex 안에서 Claude를 구독 로그인으로 쓰는
+것인데, 이는 Anthropic 약관의 적용을 받습니다. Anthropic API 키로 쓰면 이 문제가 없습니다. Claude 구독 여러 개를
+돌려 쓰는 것도 같은 약관 아래 각자 판단할 일입니다. 계정을 어떻게 다룰지는 Anthropic만 정할 수 있으니, 여기 적은
+내용은 보장이 아닙니다.
+
+### ChatGPT 계정을 여러 개 쓸 수 있나요?
+
+됩니다. `clauderipple login`을 할 때마다(또는 대시보드의 **+ ChatGPT 계정 추가**) 계정이 하나씩 늘어납니다.
+한 계정이 한도에 걸리면 같은 요청을 다음 계정이 이어받고, 한도가 찬 계정은 풀릴 때까지 쉽니다. 대화는 답한 계정에
+고정되어 프롬프트 캐시를 지킵니다. Claude Desktop Code 탭, Claude Code, Codex 앱·CLI의 GPT에 모두 적용됩니다.
+
+### Codex에서 Claude를 쓸 수 있나요?
+
+됩니다. `clauderipple codex on`을 하면 ClaudeRipple이 프로바이더로 추가되고, Codex 앱과 CLI의 모델 목록에
+Claude 모델이 이름 그대로 뜹니다. Claude Code 로그인이나 Anthropic API 키로 답합니다.
+[Codex 앱과 Codex CLI](#codex-앱과-codex-cli) 절을 보세요.
+
+### Claude Code 안에서는 GPT 성능이 떨어지지 않나요?
+
+Claude Code의 시스템 프롬프트와 도구 설명은 Claude에 맞춰 쓰여 있어서, 다른 모델은 남에게 맞춘 지시를 읽는 셈이고
+자기 전용 앱에서와 조금 다르게 굴 수 있습니다. ClaudeRipple은 모델마다 자기 이름과 추론 강도를 알려 주고, 벤더가
+거부할 도구 스키마를 고쳐 넘기며, 프로바이더별로 지시문을 덧붙일 수 있게 합니다. 흔한 구성은 Claude를 메인으로 두고
+GPT나 DeepSeek을 서브에이전트로 쓰는 것입니다.
+
+### CC Switch, opencodex, claude-code-router와 뭐가 다른가요?
+
+[비교표](#네-개-대신-하나)를 보세요. 요약하면 ClaudeRipple은 앱이 Claude에 로그인된 채로 Claude
+**데스크톱 앱**의 Code 탭에 들어가고, 다른 모델을 피커에 실제 이름으로 보여 줍니다. CC Switch도 데스크톱 앱에
+들어가지만, 앱의 게이트웨이(3P) 모드를 켜는 방식입니다.
+
+### 무료인가요?
+
+무료입니다. GPL-3.0 오픈소스입니다. 이미 쓰고 있는 구독이나 API 키 비용만 듭니다.
+
 ## 네 개 대신 하나
 
-비슷한 도구들은 터미널용입니다. Claude Code CLI나 Codex CLI가 다른 모델을 쓰게는 해 주지만, Claude **데스크톱 앱**에는
-닿지 못하고, 다른 모델로 바꾸는 순간 Claude 구독 쪽 기능(claude.ai 채팅, Remote Control, 클라우드 세션)을 잃습니다.
+비슷한 도구들은 Claude Code CLI나 Codex CLI가 다른 모델을 쓰게는 해 주지만, Claude **데스크톱 앱**에는 닿지 못하거나
+게이트웨이(3P) 모드로만 닿고, 다른 모델로 바꾸는 순간 Claude 구독 쪽 기능(claude.ai 채팅, Remote Control, 클라우드 세션)을 잃습니다.
 ClaudeRipple은 데스크톱 앱·터미널·Codex를 메뉴 막대 앱 하나로 다루고, 두 구독을 나란히 쓰며, Claude Code 하네스를
 그대로 둡니다. 스킬·훅·MCP 서버·`CLAUDE.md`·서브에이전트·claude.ai 커넥터가 전부 살아 있는 채로 두뇌만 바뀝니다.
 
-| | ClaudeRipple | claude-code-router | Claude Desktop 게이트웨이(3P) 모드 |
-|---|---|---|---|
-| 게이트웨이(3P) 모드 **없이** Claude **Desktop** Code 탭 | ✅ | ❌ | ❌ (정의상 불가) |
-| claude.ai 채팅·Remote Control·클라우드 세션·커넥터 유지 | ✅ | ❌ | ❌ |
-| Claude 구독과 GPT 구독 나란히 | ✅ | ❌ | ❌ |
-| Desktop 피커에 실제 모델 이름 | ✅ | ❌ | 일부 |
-| ChatGPT 계정 여러 개, 한도 차면 자동 전환 (Desktop·Codex) | ✅ | ❌ | ❌ |
-| 터미널 `claude` CLI | ✅ | ✅ | ✅ |
-| Codex **앱**·Codex CLI → Claude | ✅ | ❌ | ❌ |
-| 번역 프로바이더의 프롬프트 캐시 | **94~99 %** 실측 | 제각각 | 해당 없음 |
-| 서브에이전트를 실제 모델 이름으로 표시 | ✅ | ❌ | ❌ |
-| 터미널 없이 쓰는 설정 GUI | ✅ | ❌ | ❌ |
-| 런타임 내장, 서명·공증된 앱 | ✅ | ❌ | – |
+| | ClaudeRipple | CC Switch (2026-09-24 확인) | opencodex / openclaude (2026-09-16 확인) | claude-code-router | Claude Desktop 게이트웨이(3P) 모드 |
+|---|---|---|---|---|---|
+| 게이트웨이(3P) 모드 **없이** Claude **Desktop** Code 탭 | ✅ | ❌ ² | ❌ ¹ | ❌ | ❌ (정의상 불가) |
+| claude.ai 채팅·Remote Control·클라우드 세션·커넥터 유지 | ✅ | ❌ | ❌ | ❌ | ❌ |
+| Claude 구독과 GPT 구독 나란히 | ✅ | ❌ 한 번에 프로바이더 하나 | ❌ 전부 아니면 전무 | ❌ | ❌ |
+| Desktop 피커에 실제 모델 이름 | ✅ | ❌ `claude-*` 역할 이름 ² | ❌ | ❌ | 일부 |
+| ChatGPT 계정 여러 개, 한도 차면 자동 전환 (Desktop·Codex) | ✅ | ❌ 수동 전환 ³ | ✅ | ❌ | ❌ |
+| 터미널 `claude` CLI | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Codex **앱**·Codex CLI → Claude | ✅ | ✅ | ✅ | ❌ | ❌ |
+| 번역 프로바이더의 프롬프트 캐시 | **94~99 %** 실측 | 미측정 | 미측정 | 제각각 | 해당 없음 |
+| 서브에이전트를 실제 모델 이름으로 표시 | ✅ | ❌ | ❌ | ❌ | ❌ |
+| 터미널 없이 쓰는 설정 GUI | ✅ | ✅ | ❌ | ❌ | ❌ |
+| 런타임 내장, 서명·공증된 앱 | ✅ | ✅ | ❌ | ❌ | – |
+
+¹ opencodex는 README에 Claude Desktop 데모를 걸어 두었지만, 저장소에도 문서 사이트에도 설치 절차가 없었습니다
+(2026-09-16 확인). 당시 데스크톱 앱으로 들어가는 공개된 경로는 공식 게이트웨이 설정, 즉 마지막 칸뿐이었습니다.
+
+² CC Switch는 데스크톱 앱의 서드파티 프로필(`Claude-3p/claude_desktop_config.json`, `"inferenceProvider": "gateway"`)을
+써서 들어갑니다. 즉 마지막 칸과 같은 경로입니다. 로컬 게이트웨이를 거치면 피커에는 `claude-sonnet-*`·`claude-opus-*`·
+`claude-haiku-*` 역할 이름만 보입니다([CC Switch 매뉴얼](https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/en/2-providers/2.6-claude-desktop.md)).
+CC Switch는 이 표보다 많은 도구(Gemini CLI, OpenCode 등)를 다루고, MCP 서버와 스킬을 도구 사이에 동기화합니다.
+
+³ ChatGPT 계정은 프로바이더 카드마다 하나씩 묶이고, 공식 ChatGPT 카드는 페일오버 대상에서 빠집니다(v3.20.0 릴리스 노트).
 
 데스크톱 앱의 "서드파티 추론" 설정은 앱 전체를 다른 모드로 바꿔 버립니다. claude.ai 채팅, Remote Control,
-클라우드 세션을 잃습니다. `ANTHROPIC_BASE_URL`을 바꿔치기하는 도구들은 데스크톱 앱에 아예 닿지 못합니다.
+클라우드 세션을 잃습니다. `ANTHROPIC_BASE_URL`을 바꿔치기하는 도구들은 데스크톱 앱에 닿지 못하고, 닿는 도구는 바로 그
+설정을 씁니다.
 ClaudeRipple은 Claude Code 프로세스만 신뢰하는 작은 HTTPS 프록시입니다. 매핑한 모델 요청만 프로바이더로 가고,
 나머지는 Anthropic으로 바이트 그대로 지나갑니다.
 
 ## 할 수 있는 것
 
-- **Claude Desktop과 Claude Code에서 어떤 모델이든.** ChatGPT Plus/Pro 구독으로 GPT-5.6 Terra / Sol / Luna와
-  GPT-6 Astra를, 아니면 DeepSeek·Kimi·GLM·MiniMax·Qwen·Grok·Mistral·Groq·Together·Fireworks·OpenRouter(400+ 모델)·
+- **Claude Desktop과 Claude Code에서 어떤 모델이든.** ChatGPT Plus/Pro 구독으로 GPT-6 Sol / Luna / Astra와
+  GPT-5.6 Terra / Sol / Luna를(OpenAI가 새 모델을 내면 그날 바로 뜹니다), 아니면 DeepSeek·Kimi·GLM·MiniMax·Qwen·Grok·Mistral·Groq·Together·Fireworks·OpenRouter(400+ 모델)·
   로컬 Ollama / LM Studio를. 피커에 실제 이름으로 띄우거나, Claude 이름에 매핑해서.
 - **Codex 앱과 Codex CLI에서 Claude를.** Codex가 프로바이더로 인식하는 로컬 OpenAI 호환 엔드포인트. Claude 모델이
   Codex 자체 모델 목록에 뜹니다. 현재 Claude Code 로그인이나 Anthropic API 키를 씁니다.
@@ -184,6 +240,17 @@ curl -fsSL https://raw.githubusercontent.com/PBJ-2/clauderipple/main/scripts/ins
 irm https://raw.githubusercontent.com/PBJ-2/clauderipple/main/scripts/install.ps1 | iex
 ```
 
+**Linux** (systemd가 있는 데스크톱 세션)
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/PBJ-2/clauderipple/main/scripts/install.sh | sh
+```
+
+라우터는 사용자 단위 systemd 서비스로 돕니다. 상태는 `systemctl --user status clauderipple`, 출력은
+`journalctl --user -u clauderipple`로 봅니다. 피커 모드는 Chromium이 읽는 NSS 데이터베이스
+(`~/.pki/nssdb`, 내 사용자에게만, sudo 없이)에 로컬 CA를 등록하므로 `certutil`이 필요합니다.
+`clauderipple picker on` 전에 `sudo apt install libnss3-tools`(Fedora는 `sudo dnf install nss-tools`)를 실행하세요.
+
 준비물은 없습니다. 이미 Node 24 이상이 있으면 그것을 쓰고, 없으면 공식 빌드를 `~/.clauderipple/runtime`에
 내려받습니다. 내려받은 파일은 nodejs.org가 공개한 체크섬과 대조합니다. 그다음 설치까지 마칩니다. 로컬 인증서,
 `~/.claude/settings.json` 두 줄, 컴퓨터를 켤 때 함께 뜨는 백그라운드 라우터. 관리자 권한도, 암호 입력도 필요
@@ -222,11 +289,12 @@ clauderipple restart
 
 선택 사항, Desktop 피커에 실제 이름을 띄우려면: **클라이언트 → Claude Desktop → 모델 피커 → 켜기**. 그다음 Claude
 Desktop을 완전히 종료했다가 다시 엽니다. 로컬 인증서를 사용자 범위로만 신뢰시키는데, 이때 macOS는 로그인 암호를
-묻고 Windows는 지문이 적힌 확인 창을 띄웁니다. ClaudeRipple은 암호를 보지 않으며, 양쪽 다 관리자 권한이 필요
-없습니다.
+묻고 Windows는 지문이 적힌 확인 창을 띄웁니다. Linux는 묻지 않고 NSS 데이터베이스에 등록합니다. ClaudeRipple은
+암호를 보지 않으며, 어느 플랫폼도 관리자 권한이 필요 없습니다.
 
 > **Claude Desktop은 창을 닫아도 종료되지 않습니다.** 그 상태로 다시 열면 이전 인스턴스를 재사용해서 새 설정을
-> 읽지 않습니다. 제대로 종료하십시오(macOS는 ⌘Q, Windows는 트레이 아이콘 또는 작업 관리자). 안 그러면 피커가
+> 읽지 않습니다. 제대로 종료하십시오(macOS는 ⌘Q, Windows는 트레이 아이콘 또는 작업 관리자, Linux는 Ctrl+Q 또는
+> 트레이 아이콘. `pgrep -f claude-desktop`이 아무것도 출력하지 않을 때까지). 안 그러면 피커가
 > 아무 말 없이 그대로입니다.
 
 <details>
@@ -321,7 +389,7 @@ Anthropic API 키로 갑니다. 구독 로그인 재사용은 Anthropic 약관
 
 | 프로바이더 | 종류 | 인증 | 모델 목록 | 비고 |
 |---|---|---|---|---|
-| ChatGPT 구독 | Codex 백엔드 | 로그인 여러 개, 한도 차면 자동 전환(Codex 로그인도 재사용) | Terra, Sol, Luna, Astra | 추론 강도 low…max(Luna는 ultra), 프롬프트 캐시 94~99 % |
+| ChatGPT 구독 | Codex 백엔드 | 로그인 여러 개, 한도 차면 자동 전환(Codex 로그인도 재사용) | 구독에서 자동으로 읽음(GPT-6 Sol·Luna·Astra, GPT-5.6 …) | 추론 강도 low…max(Luna는 ultra), 프롬프트 캐시 94~99 % |
 | OpenRouter | Anthropic 호환 | API 키 | 400+, 자동 검색 | 모델별 추론 강도 지원을 API에서 읽음 |
 | DeepSeek, Kimi, Z.ai GLM, MiniMax, Qwen(국제/중국) | Anthropic 호환 | API 키 | 프리셋 | 벤더 공식 문서로 확인 |
 | xAI Grok, Mistral, Groq, Together, Fireworks | OpenAI 호환 | API 키 | 자동 검색 | 번역(Chat Completions / Responses) |
@@ -365,6 +433,9 @@ Codex 앱 / CLI ──/v1/responses──▶ ClaudeRipple 입구 ──▶ Claud
 - **Windows 지원은 이제 막 들어갔습니다(2026-09-14).** 설치·설정·라우터·로그인·피커·실제 GPT 호출까지 x64
   실기에서 확인했고, 크래시 복구는 arm64에서 확인했습니다. 창은 아직 Windows 기본 제목 표시줄을 씁니다.
   Windows 빌드는 서명되지 않았습니다(위 설치 항목 참고).
+- **Linux 지원도 이제 막 들어갔습니다(2026-09-24).** 기여자가 Ubuntu 24.04 x64에서 설치·Code 탭 요청·스트리밍
+  도중 재시작·피커 모드·제거를 실측해 보내 주었습니다. systemd 사용자 세션이 필요하고, 다른 배포판과 arm64는
+  확인하지 않았습니다.
 - ChatGPT, OpenRouter, Codex 안의 Claude는 실제 계정으로 검증했습니다. 나머지 프리셋은 벤더 공식 문서를 따릅니다.
 - 피커에 추가한 모델은 다음 세션부터 쓸 수 있습니다.
 - Claude Code와 Codex는 통신 규약을 자주 바꿉니다. 클라이언트 업데이트가 번역을 깨뜨리면 ClaudeRipple이 따라잡을 때까지

package/README.md

@@ -20,6 +20,7 @@
   <a href="LICENSE"><img alt="GPL-3.0" src="https://img.shields.io/badge/license-GPL--3.0-blue"></a>
   <img alt="macOS" src="https://img.shields.io/badge/macOS-arm64%20%7C%20x64-black">
   <img alt="Windows" src="https://img.shields.io/badge/Windows-arm64%20%7C%20x64-0078D4">
+  <img alt="Linux" src="https://img.shields.io/badge/Linux-x64%20(systemd)-FCC624">
   <img alt="Node" src="https://img.shields.io/badge/node-24%2B-success">
   <a href="README.ko.md"><img alt="한국어" src="https://img.shields.io/badge/docs-한국어-red"></a>
 </p>
@@ -80,9 +81,12 @@ the model.
 
 ### Can I use GPT in the Claude Desktop app?
 
-Yes. Install ClaudeRipple, map a Claude model name to a GPT model, and the Code tab
-answers with GPT under its real name in the model picker. The app itself is not
-modified and not switched into any other mode.
+Yes — in the **Code tab** and its subagents. Install ClaudeRipple, sign in with a
+ChatGPT Plus or Pro subscription, and GPT (GPT-6 Sol, Luna, Astra, GPT-5.6 Terra and
+the rest) shows up under its real name in the model picker, with the reasoning effort
+you pick. The app itself is not modified and not switched into any other mode. The
+general **chat** tab stays Claude: no tool can route it without turning the whole app
+into gateway mode (see [1P, not 3P](#1p-not-3p-the-difference-this-whole-project-exists-for)).
 
 ### How do I use GPT in Claude Code?
 
@@ -122,47 +126,115 @@ through OpenRouter or a direct API key. Claude models keep working as they are.
 ### Does it work on Windows?
 
 Yes, on Windows and macOS, arm64 and x64. Install, dashboard, restart and uninstall are
-measured on Windows 11 arm64; the x64 runtime is measured under emulation.
+measured on Windows 11 arm64; the x64 runtime is measured under emulation. Linux works too
+where there is a systemd user session: install, a Code-tab request through the router, a
+restart in the middle of a streaming answer and uninstall are measured on Ubuntu 24.04 x64
+with Claude Desktop 2.2553.13, and so is picker mode: models from `cli.extraModels` show
+in the Code-tab picker next to Claude's own.
 
 ### Is my code sent anywhere else?
 
 No. The proxy runs on your own machine. Requests go to the provider you configured and
 nowhere else, and credentials stay in your home directory. See [Privacy](#privacy).
 
+### Will my Claude account get banned? Is this against Anthropic's terms?
+
+What ClaudeRipple does with Claude is small and checkable: a request that stays on Claude
+leaves your machine byte for byte as Claude Code sent it, and a request routed to GPT or
+another provider never reaches Anthropic at all. It works through the proxy and
+certificate settings Claude Code documents for corporate networks (`HTTPS_PROXY`,
+`NODE_EXTRA_CA_CERTS` — [Enterprise network configuration](https://code.claude.com/docs/en/corporate-proxy)),
+not by patching the app. The reports of banned accounts are about
+the opposite direction — a Claude subscription login used from **another** program.
+ClaudeRipple has one optional feature of that kind: Claude inside Codex using your
+subscription login. That use is subject to Anthropic's terms; an Anthropic API key avoids
+the question. Rotating several Claude subscriptions is likewise your call under those
+terms. Only Anthropic can say how an account is treated, so nothing here is a promise.
+
+### Can I use several ChatGPT accounts?
+
+Yes. Each `clauderipple login` (or **+ Add ChatGPT account** in the dashboard) adds one.
+When an account hits its usage limit, the same request moves to the next account and the
+spent one rests until its window resets; a conversation stays on the account that
+answered, to keep its prompt cache. This applies to the Claude Desktop Code tab, Claude
+Code, and GPT in the Codex app and CLI.
+
+### Can I use Claude inside Codex?
+
+Yes. `clauderipple codex on` adds ClaudeRipple as a provider, and Claude models appear in
+the Codex app's and CLI's model list under their own names. They answer through your
+Claude Code login or an Anthropic API key. See [Codex app and Codex CLI](#codex-app-and-codex-cli).
+
+### Does GPT do worse inside Claude Code?
+
+Claude Code's system prompt and tool descriptions are written for Claude, so another model
+reads instructions tuned for someone else, and it may behave a little differently than in
+its own client. ClaudeRipple tells each model its own name and effort, reshapes tool
+schemas a vendor would reject, and lets you append instructions per provider. A common
+setup is Claude as the main model with GPT or DeepSeek as subagents.
+
+### How is this different from CC Switch, opencodex or claude-code-router?
+
+See the [comparison table](#one-tool-instead-of-four). In short: ClaudeRipple reaches
+the Claude **Desktop** Code tab while the app stays signed in to Claude, and shows other
+models in its picker under their real names. CC Switch also reaches the desktop app, but
+by turning on its gateway (3P) mode.
+
+### Is it free?
+
+Yes. ClaudeRipple is open source under GPL-3.0. You pay only for the subscriptions or API
+keys you already use.
+
 ## One tool instead of four
 
-Similar tools are built for the terminal. They let the Claude Code CLI or Codex CLI
-use other models, but they cannot reach the Claude **desktop app**, and the moment
-you switch models you lose the Claude-subscription side (claude.ai chat, Remote
-Control, cloud sessions). ClaudeRipple covers the desktop app, the terminal and
+Similar tools let the Claude Code CLI or Codex CLI use other models, but they either
+cannot reach the Claude **desktop app** or reach it only through its gateway (3P) mode,
+and the moment you switch models you lose the Claude-subscription side (claude.ai chat,
+Remote Control, cloud sessions). ClaudeRipple covers the desktop app, the terminal and
 Codex from one menu-bar app, runs both subscriptions side by side, and keeps the
 Claude Code harness intact: your skills, hooks, MCP servers, `CLAUDE.md`, subagents
 and claude.ai connectors keep working while another model does the thinking.
 
-| | ClaudeRipple | claude-code-router | Claude Desktop gateway (3P) mode |
-|---|---|---|---|
-| Claude **Desktop** Code tab **without** gateway (3P) mode | ✅ | ❌ | ❌ by definition |
-| Keeps claude.ai chat, Remote Control, cloud sessions, connectors | ✅ | ❌ | ❌ |
-| Claude and GPT subscriptions side by side | ✅ | ❌ | ❌ |
-| Real model names in the Desktop picker | ✅ | ❌ | partial |
-| Several ChatGPT accounts, switching when one runs out (Desktop and Codex) | ✅ | ❌ | ❌ |
-| Terminal `claude` CLI | ✅ | ✅ | ✅ |
-| Codex **app** and Codex CLI → Claude | ✅ | ❌ | ❌ |
-| Prompt cache on translated providers | **94–99 %** measured | varies | n/a |
-| Subagents named by real model in the task panel | ✅ | ❌ | ❌ |
-| Settings GUI, no terminal needed | ✅ | ❌ | ❌ |
-| Signed, notarized app with its own runtime | ✅ | ❌ | – |
+| | ClaudeRipple | CC Switch (checked 2026-09-24) | opencodex / openclaude (checked 2026-09-16) | claude-code-router | Claude Desktop gateway (3P) mode |
+|---|---|---|---|---|---|
+| Claude **Desktop** Code tab **without** gateway (3P) mode | ✅ | ❌ ² | ❌ ¹ | ❌ | ❌ by definition |
+| Keeps claude.ai chat, Remote Control, cloud sessions, connectors | ✅ | ❌ | ❌ | ❌ | ❌ |
+| Claude and GPT subscriptions side by side | ✅ | ❌ one provider at a time | ❌ all-or-nothing | ❌ | ❌ |
+| Real model names in the Desktop picker | ✅ | ❌ `claude-*` role names ² | ❌ | ❌ | partial |
+| Several ChatGPT accounts, switching when one runs out (Desktop and Codex) | ✅ | ❌ switched by hand ³ | ✅ | ❌ | ❌ |
+| Terminal `claude` CLI | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Codex **app** and Codex CLI → Claude | ✅ | ✅ | ✅ | ❌ | ❌ |
+| Prompt cache on translated providers | **94–99 %** measured | not measured | not measured | varies | n/a |
+| Subagents named by real model in the task panel | ✅ | ❌ | ❌ | ❌ | ❌ |
+| Settings GUI, no terminal needed | ✅ | ✅ | ❌ | ❌ | ❌ |
+| Signed, notarized app with its own runtime | ✅ | ✅ | ❌ | ❌ | – |
+
+¹ opencodex's README showed Claude Desktop in a demo but published no setup steps for it,
+in the repository or on its documentation site (checked 2026-09-16). At the time the only
+public way into the desktop app was the official gateway setting — the last column.
+
+² CC Switch reaches Claude Desktop by writing the app's third-party profile
+(`Claude-3p/claude_desktop_config.json`, `"inferenceProvider": "gateway"`), which is the
+last column. Through its local gateway the picker shows only `claude-sonnet-*`,
+`claude-opus-*` and `claude-haiku-*` role names ([its manual](https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/en/2-providers/2.6-claude-desktop.md)).
+CC Switch manages more tools than this table covers (Gemini CLI, OpenCode and others) and
+syncs MCP servers and skills across them.
+
+³ Each ChatGPT account is bound to its own provider card, and official ChatGPT cards are
+kept out of the failover queue (v3.20.0 release notes).
 
 The desktop app's own "third-party inference" setting flips the whole app into another
 mode: you lose claude.ai chat, Remote Control and cloud sessions. Tools that replace
-`ANTHROPIC_BASE_URL` never reach the desktop app at all. ClaudeRipple instead is a
+`ANTHROPIC_BASE_URL` never reach the desktop app, and the ones that do reach it write
+that same setting. ClaudeRipple instead is a
 tiny HTTPS proxy that only the Claude Code process trusts: requests for the models
 you map go to your provider, everything else goes to Anthropic byte for byte.
 
 ## What you get
 
-- **Any model in Claude Desktop and Claude Code.** GPT-5.6 Terra / Sol / Luna and
-  GPT-6 Astra through your ChatGPT Plus/Pro subscription, or DeepSeek, Kimi, GLM,
+- **Any model in Claude Desktop and Claude Code.** GPT-6 Sol / Luna / Astra and
+  GPT-5.6 Terra / Sol / Luna through your ChatGPT Plus/Pro subscription (new models
+  appear the day OpenAI serves them), or DeepSeek, Kimi, GLM,
   MiniMax, Qwen, Grok, Mistral, Groq, Together, Fireworks, OpenRouter (400+ models)
   and local Ollama / LM Studio. Under their real names in the picker, or mapped onto
   a Claude name.
@@ -214,6 +286,17 @@ curl -fsSL https://raw.githubusercontent.com/PBJ-2/clauderipple/main/scripts/ins
 irm https://raw.githubusercontent.com/PBJ-2/clauderipple/main/scripts/install.ps1 | iex
 ```
 
+**Linux** (a desktop session with systemd)
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/PBJ-2/clauderipple/main/scripts/install.sh | sh
+```
+
+The router runs as a per-user systemd service: `systemctl --user status clauderipple`, and
+`journalctl --user -u clauderipple` for what it printed. Picker mode trusts the local CA in the
+NSS database Chromium reads (`~/.pki/nssdb`, your user only, no sudo), which takes `certutil`:
+run `sudo apt install libnss3-tools` (Fedora: `sudo dnf install nss-tools`) before `clauderipple picker on`.
+
 That is the whole prerequisite list. The script uses a Node 24+ you already have, and
 downloads the official build into `~/.clauderipple/runtime` when you have none,
 verifying it against the checksum nodejs.org publishes. Then it sets ClaudeRipple up:
@@ -255,12 +338,13 @@ clauderipple restart
 Optional, for real names in the Desktop picker: **Clients → Claude Desktop → Model
 picker → on**, then quit and reopen Claude Desktop. To trust the local certificate
 for your user only, macOS asks for your login password and Windows shows a
-confirmation dialog with the fingerprint — ClaudeRipple never sees a password, and
-neither platform needs administrator rights.
+confirmation dialog with the fingerprint; Linux adds it to your NSS database without asking.
+ClaudeRipple never sees a password, and no platform needs administrator rights.
 
 > **Closing Claude Desktop's window is not enough.** It keeps running, and the next
 > launch reuses it without reading the new setting. Quit it properly (macOS: ⌘Q;
-> Windows: the tray icon, or Task Manager) or the picker will silently not change.
+> Windows: the tray icon, or Task Manager; Linux: Ctrl+Q or the tray icon, until
+> `pgrep -f claude-desktop` prints nothing) or the picker will silently not change.
 
 <details>
 <summary>From source (Node 24)</summary>
@@ -368,7 +452,7 @@ provider you configured is available the same way.
 
 | Provider | Kind | Auth | Model list | Notes |
 |---|---|---|---|---|
-| ChatGPT subscription | Codex backend | several sign-ins, switching when one runs out (Codex login reused too) | Terra, Sol, Luna, Astra | effort low…max (Luna: ultra), prompt cache 94–99 % |
+| ChatGPT subscription | Codex backend | several sign-ins, switching when one runs out (Codex login reused too) | read from your subscription (GPT-6 Sol, Luna, Astra, GPT-5.6 …) | effort low…max (Luna: ultra), prompt cache 94–99 % |
 | OpenRouter | Anthropic-compatible | API key | 400+, discovered | per-model effort support read from the API |
 | DeepSeek, Kimi, Z.ai GLM, MiniMax, Qwen (intl / cn) | Anthropic-compatible | API key | preset | verified against vendor docs |
 | xAI Grok, Mistral, Groq, Together, Fireworks | OpenAI-compatible | API key | discovered | translated (Chat Completions / Responses) |
@@ -417,6 +501,9 @@ In daily use by the author, but young. Expect rough edges:
   in, the picker and a live GPT call are verified on x64 hardware; crash recovery
   on arm64. The window still has the stock Windows title bar. Windows builds are
   unsigned; see the note under Install.
+- **Linux support is new (2026-09-24)**, contributed with measurements on Ubuntu
+  24.04 x64 (install, a Code-tab request, restart mid-stream, picker mode, uninstall).
+  It needs a systemd user session; other distributions and arm64 are untested.
 - ChatGPT, OpenRouter and Claude-in-Codex are verified with live accounts; the
   other presets follow the vendors' official documentation.
 - A model added to the picker is usable from the next session.

package/dist/cli/src/browser.js

@@ -1,6 +1,7 @@
 // Opens a URL in the user's default browser. Shared by the CLI (sign-in commands, `ui`) and the
 // router's admin API (sign-in started from the GUI).
 import { execFileSync } from "node:child_process";
+import { windowsPowerShellEnv } from "./windows-powershell.js";
 /** Returns false if the platform command failed; the caller then shows the URL instead. */
 export function openBrowser(url) {
     try {
@@ -9,10 +10,10 @@ export function openBrowser(url) {
             // at its first parameter and the provider answers "missing_required_parameter" (observed
             // 2026-09-14). Start-Process takes the URL as one argument, quoted PowerShell-style.
             const quoted = `'${url.replace(/'/g, "''")}'`;
-            execFileSync("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", `Start-Process ${quoted}`], { stdio: "ignore", windowsHide: true });
+            execFileSync("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", `Start-Process ${quoted}`], { env: windowsPowerShellEnv(), stdio: "ignore", windowsHide: true });
         }
         else
-            execFileSync("open", [url], { stdio: "ignore" });
+            execFileSync(process.platform === "linux" ? "xdg-open" : "open", [url], { stdio: "ignore" });
         return true;
     }
     catch {

package/dist/cli/src/claude-auth.js

@@ -19,6 +19,10 @@ const isWindows = process.platform === "win32";
 const BINARY_NAMES = isWindows ? ["claude.exe", "claude.cmd", "claude.bat"] : ["claude"];
 /** Where Claude Desktop caches the CLI it downloads, per platform. */
 export function desktopClaudeCodeDirs() {
+    // Linux: Electron's userData is $XDG_CONFIG_HOME/Claude (seen with Claude Desktop 2.2553.13 on
+    // Ubuntu 24.04: ~/.config/Claude/claude-code/2.1.280/claude, a plain executable).
+    if (process.platform === "linux")
+        return [path.join(process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config"), "Claude", "claude-code")];
     if (!isWindows)
         return [path.join(os.homedir(), "Library", "Application Support", "Claude", "claude-code")];
     const roots = [
@@ -29,6 +33,8 @@ export function desktopClaudeCodeDirs() {
 }
 /** Launcher inside one cached version directory. The macOS build nests an .app bundle. */
 function versionBinaries(versionDir) {
+    if (process.platform === "linux")
+        return [path.join(versionDir, "claude")];
     return isWindows
         ? BINARY_NAMES.map((name) => path.join(versionDir, name))
         : [path.join(versionDir, "claude.app", "Contents", "MacOS", "claude")];