[Feature]可否增加请求头自动构造为CC的功能？

[Tongzhao9417]

首先感谢开发者的辛苦付出！

有一个小的feature想和佬讨论一下：能否增加请求头伪造为CC的功能？类似于axonhub里，如果选中供应商为Claude code，那么无论客户端使用的是cc、opencode还是openclaw，请求头都会变为cc

使用cch自带的请求过滤功能，一来是需要设置的比较多，二来不知为何，有一些中转商还是会识别出非CC客户端

感谢开发者！

[github-actions]

Thank you for this feature suggestion.

Summary of Request:
You are requesting an automatic request header spoofing feature to make requests appear as if they come from Claude Code, similar to axonhub's implementation. This would allow clients like opencode or openclaw to be recognized as CC by relay providers.

Current Architecture Analysis:

Based on the codebase, Claude Code client detection relies on 4 signals (defined in src/app/v1/_lib/proxy/client-detector.ts:45-84):

1. x-app: cli header
2. User-Agent starting with claude-cli/
3. anthropic-beta header present
4. metadata.user_id in request body

All 4 signals must be present to confirm a Claude Code client.

Existing Request Filter Feature:

The current request filtering system (src/lib/request-filter-engine.ts) supports:

• Header modifications (set/remove actions)
• Body modifications (JSON path / text replacement)
• Binding to global, specific providers, or provider groups

You can configure filters to:

• Set user-agent header to a Claude Code UA string
• Set x-app header to cli
• Inject anthropic-beta header

Why Current Filters May Not Work:

As you noted, some relay providers may still detect non-CC clients. Possible reasons:

1. Only modifying headers, not the request body metadata
2. Relay providers checking additional signals beyond standard headers
3. TLS fingerprinting or other low-level detection methods

Implementation Considerations:

A built-in "spoof as CC" feature would need to:

1. Override User-Agent to match Claude CLI format (e.g., claude-cli/1.0.0 (external, cli))
2. Set x-app: cli header
3. Ensure anthropic-beta header is present
4. Inject metadata.user_id into request body (currently filters support this via JSON path)

This could be implemented as:

• A provider-level boolean flag (e.g., spoofAsClaudeCode: boolean)
• A preset template for request filters
• A dedicated guard in the proxy pipeline

Related Code:

• src/app/v1/_lib/proxy/client-detector.ts - Client detection logic
• src/lib/request-filter-engine.ts - Request filter engine
• src/app/v1/_lib/proxy/forwarder.ts:2814-2914 - Header building logic
• src/repository/request-filters.ts - Request filter types

---

Automated response from Claude AI