把 agent 的模型接口地址指向本机端口
本页内容
2026-11-22,启动 Claude Code 时把它的模型接口地址指向了本机的一个端口,一个本地程序收到了这条连接。这是一次工作会话里的第一手观察。它验证了重定向可行。它没有验证本地代理能读取或脱敏请求。
做了什么
- 情境。 当时在排查 Microsoft Foundry 的一个 API 连接错误。目的是看 Claude Code 发出的 TLS ClientHello。
- 设置。
ANTHROPIC_FOUNDRY_BASE_URL=https://127.0.0.1:18443/anthropic。CLAUDE_CODE_MAX_RETRIES=0,外加一个假的 API key。没有用真 key。- 执行的命令是
timeout 30 claude -p "hi"。 - 本机装的是 Claude Code 2.1.330。抓取时的版本没有单独记录,大概率相同。
- 监听程序。 一个很短的 Python 脚本,只是临时文件。它在 127.0.0.1 上接受一个 TCP 连接,读第一个 TLS 记录,解析 ClientHello,然后关闭连接。它不完成 TLS 握手。
- 结果。 约 19:28(UTC+8)连接到达。ClientHello 记录是 1477 字节,另加 5 字节的记录头。它的 key share 是 X25519MLKEM768 和 X25519。
发现
- base URL 写哪个地址,Claude Code 就连哪个地址,包括回环接口上的端口。
- 本地程序能拿到这条连接。所以由终端启动 agent 时,可以在路径上放一个代理,不需要 agent 配合。
对 cotty 的含义
这支持能力里"由终端启动"那条路:启动 agent 时把它的模型接口地址指向本地代理。目前只验证了重定向。下一步要试的是一个终结 TLS 连接、读出请求再转发的代理。
没有覆盖
- 读取请求。 监听程序没有完成握手,所以没有看到请求内容。
- 在代理里终结 TLS。 有两种做法,都没有试过:
- base URL 改用
http://。不确定 Claude Code 是否接受明文的本地地址。 - 给代理一张客户端信任的证书,比如通过
NODE_EXTRA_CA_CERTS。
- base URL 改用
- 其他 agent 和其他设置。 只试了 Claude Code 加 Foundry 的设置。没有试
ANTHROPIC_BASE_URL,也没有试 Codex 加OPENAI_BASE_URL。