# 把 agent 的模型接口地址指向本机端口

地址: https://nowa.im/cotty/zh/research/field-notes/2026-11-model-endpoint-redirect/  
创建: 2026-11-22

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 的含义

这支持[能力](https://nowa.im/cotty/zh/product/capabilities/)里"由终端启动"那条路：启动 agent 时把它的模型接口地址指向本地代理。目前只验证了重定向。下一步要试的是一个终结 TLS 连接、读出请求再转发的代理。

## 没有覆盖

- **读取请求。** 监听程序没有完成握手，所以没有看到请求内容。
- **在代理里终结 TLS。** 有两种做法，都没有试过：
  - base URL 改用 `http://`。不确定 Claude Code 是否接受明文的本地地址。
  - 给代理一张客户端信任的证书，比如通过 `NODE_EXTRA_CA_CERTS`。
- **其他 agent 和其他设置。** 只试了 Claude Code 加 Foundry 的设置。没有试 `ANTHROPIC_BASE_URL`，也没有试 Codex 加 `OPENAI_BASE_URL`。
