letcode 提供可选的客户端特征仿真机制(Fake / Request Disguise)。该能力主要面向特定编码服务商的兼容性要求,负责规范化封装网络传输元数据与宿主环境报告块。
用户可在 letcode.toml 中配置仿真参数,也可以在会话运行期间使用 /fake 命令开启或关闭仿真。
仿真机制严格约束在网络传输的外围契约中:
- 仅修饰请求传输元数据(如请求头、客户端标识、会话安装 ID);
- 仅提供服务商协议约定的环境报告块(如终端环境、Git 状态与工作区路径)与客户端自述块;
- Agent 自身系统提示词保持原样,置于客户端自述块之后;
- 不篡改 Agent 的核心系统提示词;
- 不篡改工具目录的真实定义与安全参数。
系统支持两种面向主流协议的传输剖面,各自模仿一个真实的编码客户端。
- Codex 剖面:面向基于 Responses 协议的服务商,构造匹配的客户端版本标头与回合扩展元数据;
- Claude Code 剖面:面向 Anthropic Messages 协议,构造匹配的 Claude Code 客户端标头与
/messages?beta=true端点形态,在系统块首位报告客户端归属行x-anthropic-billing-header与客户端声明行You are a Claude agent, built on Anthropic's Claude Agent SDK.,并在请求体的metadata.user_id中报告当前会话。
两个剖面模仿的客户端不同,可配置项各成一段。Codex 剖面读取 [fake.codex],Claude Code 剖面读取 [fake.claude]。auto 模式下,系统按当前激活的服务商协议选择剖面。
仿真数据并非全部虚构。对于能够在本地确认的信息,系统直接读取主机的真实状态:
- 操作系统与架构:直接采集当前运行环境的系统类型(如 Mac OS / Linux)与 CPU 架构(如
aarch64/x86_64); - 终端与 Shell:检测当前活动的终端程序与用户登录 Shell(如
zsh或bash); - 工作区与版本库:读取当前工作区的绝对路径,并自动探测当前 Git 提交哈希(
git rev-parse HEAD)与工作区变更状态; - 时区与日期:默认依据本机系统时钟与 IANA 本地时区换算。
部分服务商的网关只接受携带客户端自述块(归属行与 Agent 声明行)且附带 metadata.user_id 的请求,缺少任一项时以 Service Unavailable 类响应退回;主轮次与 helper 请求在仿真开启时都发送这两项。
无法从本机确认的属性取自被模仿客户端的典型值,如客户端版本、依赖包版本和能力标记。这些值描述同一个已发布客户端:标头的 claude-cli/<version>、归属行的 cc_version=<version>.<build>、x-stainless-package-version、x-stainless-runtime-version 与 anthropic-beta 列表随被模仿客户端发版整体变化,需要同步更新。针对特定服务商专有的沙箱标记(如 sandbox_mode 与 node_repl_disabled),系统填充规范的默认值。用户也可以在配置文件的 [fake.codex.extra] 中添加自定义键值对,最多允许配置 16 项。
客户端特征仿真默认处于关闭状态。
启用仿真有两种方式:
- 配置文件声明:在
letcode.toml中配置[fake.codex]、[fake.claude]等字段; - 会话动态切换:在 TUI 交互界面中输入
/fake命令,即可在当前会话中即时切换开启或关闭状态。
未启用仿真时,网络请求使用标准协议格式,不添加额外的客户端元数据。
src/fake.rs:实现客户端特征仿真模型、宿主环境检测与请求元数据添加。src/agent/protocol_stream.rs:在普通回合请求准备流程中连接装饰器。src/tui/slash.rs:处理/fake斜杠命令的即时切换逻辑。src/config.rs:解析配置文件中的[fake]相关结构体。