Repository navigation
Releases
v1.1.1
QClaude Code v1.1.1
Educational, non-commercial project. Provided as-is, without warranty.
Not affiliated with Anthropic, DeepSeek, Tencent, Alibaba, OpenRouter or Homyak.
Учебный некоммерческий проект. Предоставляется «как есть», без гарантий.
Не связан с Anthropic, DeepSeek, Tencent, Alibaba, OpenRouter и Homyak.
教学用非商业项目。 按“原样”提供,不附带保证。与 Anthropic、DeepSeek、腾讯、
阿里巴巴、OpenRouter、Homyak 无关联。
Windows
irm https://github.com/killedfriend/q-claude-bypass/releases/latest/download/install.ps1 | iexmacOS (MVP)
Download QClaudeCode-1.1.1-macos.zip, unzip, right-click install.command →
Open.
The .pkg is unsigned: install it with right-click → Open, then run
qclaude-setup in Terminal.
macOS assets:
QClaudeCode-1.1.1-macos.zip— ZIP installer (recommended)QClaudeCode-1.1.1.pkg— unsigned pkg/runtime installerSHA256SUMS-macos.txt— checksums
macOS support includes:
- LaunchAgent autostart;
qclaude/qclaude-gw;- OpenSSL CA +
securitytrust +/etc/hosts; pfctlredirect443 → 8443and a boot LaunchDaemon.
Caveat: the macOS flow is an MVP. Scripts and installer smoke tests run on a
macOS CI runner, but a live Claude Desktop GUI and certificate trust still need
a real Mac test. The pkg is not signed or notarized.
Providers
DeepSeek, Tencent Hunyuan, Alibaba Cloud Bailian (Qwen), OpenRouter, and Homyak
API (RUB, Russian cards/SBP).
Docs
MIT licensed.
v1.1.0
Educational, non-commercial project. Provided as-is, without warranty.
Not affiliated with Anthropic, DeepSeek, Tencent, Alibaba or OpenRouter.
Install on Windows:
irm https://github.com/killedfriend/q-claude-bypass/releases/latest/download/install.ps1 | iexSee README.ru.md, README.en.md and README.zh-CN.md.
macOS assets are built on the macOS runner: use the .zip package or
the unsigned .pkg; see docs/*/macos.md.
Full Changelog: v1.0.6...v1.1.0
v1.0.6
Educational, non-commercial project. Provided as-is, without warranty.
Not affiliated with Anthropic, DeepSeek, Tencent, Alibaba or OpenRouter.
Install on Windows:
irm https://github.com/killedfriend/q-claude-bypass/releases/latest/download/install.ps1 | iexSee README.ru.md, README.en.md and README.zh-CN.md.
Full Changelog: v1.0.5...v1.0.6
v1.0.5
QClaude Code v1.0.5
Educational, non-commercial project. Created for demonstration and learning
only. Not affiliated with Anthropic, DeepSeek, Tencent, Alibaba or OpenRouter.
Not intended for commercial use, resale, or violating provider terms. Use at
your own risk.
Учебный некоммерческий проект. Создан только для демонстрации и обучения.
Не связан с Anthropic, DeepSeek, Tencent, Alibaba и OpenRouter. Не предназначен
для коммерческого использования или нарушения условий провайдеров.
ж•™е¦з”Ёйќће•†дёљйЎ№з›®гЂ‚ д»…з”ЁдєЋжј”з¤єе’Ње¦д№ пјЊдёЋ AnthropicгЂЃDeepSeekгЂЃи…ѕи®ЇгЂЃй�їй‡Ње·ґе·ґгЂЃ
OpenRouter ж— е…іиЃ”гЂ‚дёЌеѕ—з”ЁдєЋе•†дёљз”ЁйЂ”гЂЃиЅ¬е”®ж€–иїќеЏЌжњЌеЉЎе•†жќЎж¬ѕгЂ‚
Install on Windows
irm https://github.com/killedfriend/q-claude-bypass/releases/latest/download/install.ps1 | iexThe installer sets up Node.js 22+ if needed, Claude Code, Claude Desktop, the
local gateway, automatic Claude Desktop MITM, qclaude-gw on PATH, logon
autostart, and a key smoke test.
MITM is enabled by default and asks for UAC. It creates a local CA in Trusted
Root, a certificate for api.anthropic.com, a hosts entry, and a PFX used by
the gateway TLS listener on port 443.
Skip it with a downloaded installer:
Invoke-WebRequest https://github.com/killedfriend/q-claude-bypass/releases/latest/download/install.ps1 -OutFile install.ps1
.\install.ps1 -NoMitmImportant
While MITM is installed and the gateway is stopped, api.anthropic.com is
unreachable on this machine because hosts points it to 127.0.0.1.
uninstall.ps1 removes the hosts entry, CA, certificate and PFX automatically.
If UAC is cancelled, the install directory is kept so cleanup can be retried.
Providers
| Provider | Base URL | Key variable | Verified live |
|---|---|---|---|
| DeepSeek | https://api.deepseek.com/anthropic |
DEEPSEEK_API_KEY |
yes |
| Tencent Hunyuan | https://api.hunyuan.cloud.tencent.com/anthropic |
TENCENT_API_KEY |
docs-based |
| Alibaba Bailian | https://dashscope.aliyuncs.com/apps/anthropic |
DASHSCOPE_API_KEY |
docs-based |
| OpenRouter | https://openrouter.ai/api |
OPENROUTER_API_KEY |
docs-based |
Highlights
- Real Claude Code, no forks or binary patches.
- Model routing: opus в†’ heavy, haiku and background calls в†’ cheap.
- Token, cache and cost accounting; exact OpenRouter
usage.cost. - Context pruning for long agent sessions.
- DeepSeek PDF Files API support; OpenRouter native documents.
- Trilingual docs (RU / EN / ZH) and direct-mode settings examples.
- 27 automated tests, CI on Windows and Linux.
Changes in 1.0.5
- Fixed
irm ... | iexfailing on Windows PowerShell because of an unboundValidateSeton-Provider.
Changes in 1.0.4
- MITM HTTPS verification runs only after certificate/hosts setup succeeds.
Changes in 1.0.3
- Automatic Claude Desktop MITM with UAC elevation.
- Idempotent
setup-mitm.ps1and proper exit codes. - Automatic MITM teardown in
uninstall.ps1. - HTTPS interception check after installation.
-NoMitmand-SkipClaudeDesktopopt-outs.- Updated RU/EN/ZH docs and security notes.
Documents
Assets
install.ps1,install.cmd— installerqclaude-code.zip— latest runtime packageqclaude-code-1.0.5.zip— pinned packageuninstall.ps1— removal helperSHA256SUMS.txt— checksums
MIT licensed. Provided “as is”, without warranty.
v1.0.4
QClaude Code v1.0.4
Educational, non-commercial project. Created for demonstration and learning
only. Not affiliated with Anthropic, DeepSeek, Tencent, Alibaba or OpenRouter.
Not intended for commercial use, resale, or violating provider terms. Use at
your own risk.
Учебный некоммерческий проект. Создан только для демонстрации и обучения.
Не связан с Anthropic, DeepSeek, Tencent, Alibaba и OpenRouter. Не предназначен
для коммерческого использования или нарушения условий провайдеров.
ж•™е¦з”Ёйќће•†дёљйЎ№з›®гЂ‚ д»…з”ЁдєЋжј”з¤єе’Ње¦д№ пјЊдёЋ AnthropicгЂЃDeepSeekгЂЃи…ѕи®ЇгЂЃй�їй‡Ње·ґе·ґгЂЃ
OpenRouter ж— е…іиЃ”гЂ‚дёЌеѕ—з”ЁдєЋе•†дёљз”ЁйЂ”гЂЃиЅ¬е”®ж€–иїќеЏЌжњЌеЉЎе•†жќЎж¬ѕгЂ‚
Install on Windows
irm https://github.com/killedfriend/q-claude-bypass/releases/latest/download/install.ps1 | iexThe installer sets up Node.js 22+ if needed, Claude Code, Claude Desktop, the
local gateway, automatic Claude Desktop MITM, qclaude-gw on PATH, logon
autostart, and a key smoke test.
MITM is enabled by default and asks for UAC. It creates a local CA in Trusted
Root, a certificate for api.anthropic.com, a hosts entry, and a PFX used by
the gateway TLS listener on port 443.
Skip it with a downloaded installer:
Invoke-WebRequest https://github.com/killedfriend/q-claude-bypass/releases/latest/download/install.ps1 -OutFile install.ps1
.\install.ps1 -NoMitmImportant
While MITM is installed and the gateway is stopped, api.anthropic.com is
unreachable on this machine because hosts points it to 127.0.0.1.
uninstall.ps1 removes the hosts entry, CA, certificate and PFX automatically.
If UAC is cancelled, the install directory is kept so cleanup can be retried.
Providers
| Provider | Base URL | Key variable | Verified live |
|---|---|---|---|
| DeepSeek | https://api.deepseek.com/anthropic |
DEEPSEEK_API_KEY |
yes |
| Tencent Hunyuan | https://api.hunyuan.cloud.tencent.com/anthropic |
TENCENT_API_KEY |
docs-based |
| Alibaba Bailian | https://dashscope.aliyuncs.com/apps/anthropic |
DASHSCOPE_API_KEY |
docs-based |
| OpenRouter | https://openrouter.ai/api |
OPENROUTER_API_KEY |
docs-based |
Highlights
- Real Claude Code, no forks or binary patches.
- Model routing: opus в†’ heavy, haiku and background calls в†’ cheap.
- Token, cache and cost accounting; exact OpenRouter
usage.cost. - Context pruning for long agent sessions.
- DeepSeek PDF Files API support; OpenRouter native documents.
- Trilingual docs (RU / EN / ZH) and direct-mode settings examples.
- 27 automated tests, CI on Windows and Linux.
Changes in 1.0.4
- MITM HTTPS verification runs only after certificate/hosts setup succeeds.
Changes in 1.0.3
- Automatic Claude Desktop MITM with UAC elevation.
- Idempotent
setup-mitm.ps1and proper exit codes. - Automatic MITM teardown in
uninstall.ps1. - HTTPS interception check after installation.
-NoMitmand-SkipClaudeDesktopopt-outs.- Updated RU/EN/ZH docs and security notes.
Documents
Assets
install.ps1,install.cmd— installerqclaude-code.zip— latest runtime packageqclaude-code-1.0.4.zip— pinned packageuninstall.ps1— removal helperSHA256SUMS.txt— checksums
MIT licensed. Provided “as is”, without warranty.
v1.0.3
QClaude Code v1.0.3
Educational, non-commercial project. Created for demonstration and learning
only. Not affiliated with Anthropic, DeepSeek, Tencent, Alibaba or OpenRouter.
Not intended for commercial use, resale, or violating provider terms. Use at
your own risk.
Учебный некоммерческий проект. Создан только для демонстрации и обучения.
Не связан с Anthropic, DeepSeek, Tencent, Alibaba и OpenRouter. Не предназначен
для коммерческого использования или нарушения условий провайдеров.
教学用非商业项目。 仅用于演示和学习,与 Anthropic、DeepSeek、腾讯、阿里巴巴、
OpenRouter 无关联。不得用于商业用途、转售或违反服务商条款。
Install on Windows
irm https://github.com/killedfriend/q-claude-bypass/releases/latest/download/install.ps1 | iexThe installer sets up Node.js 22+ if needed, Claude Code, Claude Desktop, the
local gateway, automatic Claude Desktop MITM, qclaude-gw on PATH, logon
autostart, and a key smoke test.
MITM is enabled by default and asks for UAC. It creates a local CA in Trusted
Root, a certificate for api.anthropic.com, a hosts entry, and a PFX used by
the gateway TLS listener on port 443.
Skip it with a downloaded installer:
Invoke-WebRequest https://github.com/killedfriend/q-claude-bypass/releases/latest/download/install.ps1 -OutFile install.ps1
.\install.ps1 -NoMitmImportant
While MITM is installed and the gateway is stopped, api.anthropic.com is
unreachable on this machine because hosts points it to 127.0.0.1.
uninstall.ps1 removes the hosts entry, CA, certificate and PFX automatically.
If UAC is cancelled, the install directory is kept so cleanup can be retried.
Providers
| Provider | Base URL | Key variable | Verified live |
|---|---|---|---|
| DeepSeek | https://api.deepseek.com/anthropic |
DEEPSEEK_API_KEY |
yes |
| Tencent Hunyuan | https://api.hunyuan.cloud.tencent.com/anthropic |
TENCENT_API_KEY |
docs-based |
| Alibaba Bailian | https://dashscope.aliyuncs.com/apps/anthropic |
DASHSCOPE_API_KEY |
docs-based |
| OpenRouter | https://openrouter.ai/api |
OPENROUTER_API_KEY |
docs-based |
Highlights
- Real Claude Code, no forks or binary patches.
- Model routing: opus → heavy, haiku and background calls → cheap.
- Token, cache and cost accounting; exact OpenRouter
usage.cost. - Context pruning for long agent sessions.
- DeepSeek PDF Files API support; OpenRouter native documents.
- Trilingual docs (RU / EN / ZH) and direct-mode settings examples.
- 27 automated tests, CI on Windows and Linux.
Changes in 1.0.3
- Automatic Claude Desktop MITM with UAC elevation.
- Idempotent
setup-mitm.ps1and proper exit codes. - Automatic MITM teardown in
uninstall.ps1. - HTTPS interception check after installation.
-NoMitmand-SkipClaudeDesktopopt-outs.- Updated RU/EN/ZH docs and security notes.
Documents
Assets
install.ps1,install.cmd— installerqclaude-code.zip— latest runtime packageqclaude-code-1.0.3.zip— pinned packageuninstall.ps1— removal helperSHA256SUMS.txt— checksums
MIT licensed. Provided “as is”, without warranty.
v1.0.2
QClaude Code v1.0.2
Educational, non-commercial project. Created for demonstration and learning
only. Not affiliated with Anthropic, DeepSeek, Tencent, Alibaba or OpenRouter.
Not intended for commercial use, resale, or violating provider terms. Use at
your own risk.
Учебный некоммерческий проект. Создан только для демонстрации и обучения.
Не связан с Anthropic, DeepSeek, Tencent, Alibaba и OpenRouter. Не предназначен
для коммерческого использования или нарушения условий провайдеров.
教学用非商业项目。 仅用于演示和学习,与 Anthropic、DeepSeek、腾讯、阿里巴巴、
OpenRouter 无关联。不得用于商业用途、转售或违反服务商条款。
Install on Windows
irm https://github.com/killedfriend/q-claude-bypass/releases/latest/download/install.ps1 | iexThe installer sets up Node.js 22+ if needed, Claude Code, Claude Desktop, the
local gateway, qclaude-gw on PATH, a per-user logon autostart entry, and runs
a key smoke test.
Providers
| Provider | Base URL | Key variable | Verified live |
|---|---|---|---|
| DeepSeek | https://api.deepseek.com/anthropic |
DEEPSEEK_API_KEY |
yes |
| Tencent Hunyuan | https://api.hunyuan.cloud.tencent.com/anthropic |
TENCENT_API_KEY |
docs-based |
| Alibaba Bailian | https://dashscope.aliyuncs.com/apps/anthropic |
DASHSCOPE_API_KEY |
docs-based |
| OpenRouter | https://openrouter.ai/api |
OPENROUTER_API_KEY |
docs-based |
Highlights
- Real Claude Code, no forks or binary patches.
- Model routing: opus → heavy, haiku and background calls → cheap.
- Token, cache and cost accounting; exact OpenRouter
usage.cost. - Context pruning for long agent sessions.
- DeepSeek PDF Files API support; OpenRouter native documents.
- Trilingual docs (RU / EN / ZH) and direct-mode settings examples.
- 27 automated tests, CI on Windows and Linux.
Changes in 1.0.2
qclaudeandqclaude-gwcommands are installed to
%LOCALAPPDATA%\QClaudeCode\binand added to the user PATH.- The uninstaller removes those PATH entries.
- Native npm/winget calls no longer abort on harmless stderr in PowerShell 5.1.
- The parity harness no longer deletes its README.
Documents
Assets
install.ps1,install.cmd— installerqclaude-code.zip— latest runtime packageqclaude-code-1.0.2.zip— pinned packageuninstall.ps1— removal helperSHA256SUMS.txt— checksums
MIT licensed. Provided “as is”, without warranty.
v1.0.1
QClaude Code v1.0.1
Educational, non-commercial project. Created for demonstration and learning
only. Not affiliated with Anthropic, DeepSeek, Tencent, Alibaba or OpenRouter.
Not intended for commercial use, resale, or violating provider terms. Use at
your own risk.
Учебный некоммерческий проект. Создан только для демонстрации и обучения.
Не связан с Anthropic, DeepSeek, Tencent, Alibaba и OpenRouter. Не предназначен
для коммерческого использования или нарушения условий провайдеров.
教学用非商业项目。 仅用于演示和学习,与 Anthropic、DeepSeek、腾讯、阿里巴巴、
OpenRouter 无关联。不得用于商业用途、转售或违反服务商条款。
Install on Windows
irm https://github.com/killedfriend/q-claude-bypass/releases/latest/download/install.ps1 | iexThe installer sets up Node.js 22+ if needed, Claude Code, Claude Desktop, the
local gateway, a per-user logon autostart entry, and runs a key smoke test.
Providers
| Provider | Base URL | Key variable | Verified live |
|---|---|---|---|
| DeepSeek | https://api.deepseek.com/anthropic |
DEEPSEEK_API_KEY |
yes |
| Tencent Hunyuan | https://api.hunyuan.cloud.tencent.com/anthropic |
TENCENT_API_KEY |
docs-based |
| Alibaba Bailian | https://dashscope.aliyuncs.com/apps/anthropic |
DASHSCOPE_API_KEY |
docs-based |
| OpenRouter | https://openrouter.ai/api |
OPENROUTER_API_KEY |
docs-based |
Highlights
- Real Claude Code, no forks or binary patches.
- Model routing: opus → heavy, haiku and background calls → cheap.
- Token, cache and cost accounting; exact OpenRouter
usage.cost. - Context pruning for long agent sessions.
- DeepSeek PDF Files API support; OpenRouter native documents.
- Trilingual docs (RU / EN / ZH) and direct-mode settings examples.
- 27 automated tests, CI on Windows and Linux.
Changes in 1.0.1
install.cmdcan bootstrap the latest installer when downloaded alone.- Installer writes
CLAUDE_CODE_EFFORT_LEVELand
CLAUDE_CODE_AUTO_COMPACT_WINDOW; uninstaller removes them. - Documented which provider presets are live-tested and which are based on
provider docs.
Documents
Assets
install.ps1,install.cmd— installerqclaude-code.zip— latest runtime packageqclaude-code-1.0.1.zip— pinned packageuninstall.ps1— removal helperSHA256SUMS.txt— checksums
MIT licensed. Provided “as is”, without warranty.
v1.0.0
QClaude Code v1.0.0
Educational, non-commercial project. Created for demonstration and learning
only. Not affiliated with Anthropic, DeepSeek, Tencent, Alibaba or OpenRouter.
Not intended for commercial use, resale, or violating provider terms. Use at
your own risk.
Учебный некоммерческий проект. Создан только для демонстрации и обучения.
Не связан с Anthropic, DeepSeek, Tencent, Alibaba и OpenRouter. Не предназначен
для коммерческого использования или нарушения условий провайдеров.
教学用非商业项目。 仅用于演示和学习,与 Anthropic、DeepSeek、腾讯、阿里巴巴、
OpenRouter 无关联。不得用于商业用途、转售或违反服务商条款。
Install on Windows
irm https://github.com/killedfriend/q-claude-bypass/releases/latest/download/install.ps1 | iexThe installer sets up Node.js 22+ if needed, Claude Code, Claude Desktop, the
local gateway, a per-user logon autostart entry, and runs a key smoke test.
Providers
| Provider | Base URL | Key variable |
|---|---|---|
| DeepSeek | https://api.deepseek.com/anthropic |
DEEPSEEK_API_KEY |
| Tencent Hunyuan | https://api.hunyuan.cloud.tencent.com/anthropic |
TENCENT_API_KEY |
| Alibaba Bailian | https://dashscope.aliyuncs.com/apps/anthropic |
DASHSCOPE_API_KEY |
| OpenRouter | https://openrouter.ai/api |
OPENROUTER_API_KEY |
Highlights
- Real Claude Code, no forks or binary patches.
- Model routing: opus → heavy, haiku and background calls → cheap.
- Token, cache and cost accounting; exact OpenRouter
usage.cost. - Context pruning for long agent sessions.
- DeepSeek PDF Files API support; OpenRouter native documents.
- Trilingual docs (RU / EN / ZH) and direct-mode settings examples.
- 27 automated tests, CI on Windows and Linux.
Documents
Assets
install.ps1,install.cmd— installerqclaude-code.zip— latest runtime packageqclaude-code-1.0.0.zip— pinned packageuninstall.ps1— removal helperSHA256SUMS.txt— checksums
MIT licensed. Provided “as is”, without warranty.