CLIProxyAPI 配置, Claude Code GPT 5.6 Sol, claudex 教程, Claude Code 更换模型, 模型代理 Claude Code
这两天 X 上有个帖子火了——110 万浏览，6500 个赞，近 6000 个收藏。OpenAI Codex 团队成员 Tibo 公开发了一个叫 claudex 的玩法：让 Claude Code 跑 GPT-5.6 Sol。

图里 Claude Code 的界面没变，橙色图标还在，工具调用方式也跟以前一样。但头顶显示的模型名变成了 GPT-5.6 Sol。

这事有意思——但它不是"Claude 和 GPT 合体了"。事实上离得还很远。

这不是模型融合，是三层架构

截图看多了容易产生错觉。真相是三块拼图各干各的：

  • Agent 外壳（Claude Code）：负责终端界面、系统提示词、权限控制、工具编排、子 Agent 管理、上下文压缩——交互层的事全是它
  • 协议代理（CLIProxyAPI）：接收 Anthropic 格式请求→转成 GPT 后端能懂→拿到响应→再转回 Claude 能读的格式。纯粹的翻译层
  • 模型（GPT-5.6 Sol）：理解任务、规划步骤、生成代码、决定调用哪些工具

请求链路长这样：

Plain Text
Claude Code → 本地 CLIProxyAPI → Codex OAuth 鉴权 → GPT-5.6 Sol → CLIProxyAPI 翻译 → Claude Code 展示

所以claudex 不是新模型，也没得到任何官方背书。它只是一组环境变量 + alias 的别名。

但为什么值得聊？因为它在验证一个方向：Agent Harness 和模型可以解耦。你喜欢的交互方式你没丢，但底下的引擎换了。

CLIProxyAPI 到底干了什么

CLIProxyAPI 是 MIT 开源项目，做的是 API 兼容代理。它支持 OpenAI、Gemini、Claude、Codex、Grok 等多种接口的互转。

在这里它扛两件事：

  1. 鉴权：通过 Codex OAuth 拉来本地授权，让请求能打给 GPT-5.6 Sol
  2. 协议翻译：Claude Code 说的是 Anthropic 方言，GPT 后端只认 OpenAI 口音——它在中间做同声传译

只复制网上的 alias 贴进终端是跑不起来的。Claude Code 必须通过 ANTHROPIC_BASE_URL 指向代理，代理也必须完成 OAuth 登录并识别 gpt-5.6-sol。 三条链任意一条断了都不行。

五步配置手把手

我在 macOS 和 Windows 上各跑了一遍，以下是完整步骤：

Step 1：安装 CLIProxyAPI

macOS 上一条 Homebrew 搞定：

PHP
brew install cliproxyapi

需要后台运行加一句：

PHP
brew services start cliproxyapi

Windows 用户去 GitHub Releases 下载对应架构的版本，放固定目录后运行。

Step 2：限制只监听本机

默认端口 8317，配置里必须绑 127.0.0.1，绝对不能暴露到公网：

PHP
host: "127.0.0.1"
port: 8317
api-keys:
  - "替换为一段足够长的本地随机密钥"
auth-dir: "~/.cli-proxy-api"
debug: false

注意：api-keys 是 Claude Code 访问代理的口令，不是 OAuth Token。别把 OAuth 凭证塞进 shell alias 或 Git 仓库。

Step 3：Codex OAuth 登录

PHP
cliproxyapi --codex-login

执行后会弹浏览器完成授权。OAuth 回调用端口 1455。打不开浏览器的话加 --no-browser，手动复制链接。

Step 4：让 Claude Code 接上代理

编辑 ~/.claude/settings.json（Windows 对应 %USERPROFILE%\.claude\settings.json）：

PHP
{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:8317",
    "ANTHROPIC_AUTH_TOKEN": "替换为config.yaml中配置的本地随机密钥"
  }
}

两项缺一不可。

Step 5：定义 claudex alias

zsh 用户写入 ~/.zshrc：

PHP
alias claudex='CLAUDE_CODE_SUBAGENT_MODEL=gpt-5.6-sol \
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT=1 \
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=3 \
ENABLE_TOOL_SEARCH=false \
claude --model gpt-5.6-sol'

source ~/.zshrc 后敲 claudex 即可。主模型和子 Agent 都会用 GPT-5.6 Sol，并发工具调用限制为 3。

Windows 用户怎么跑

PowerShell 不支持 zsh alias。在当前窗口设置环境变量然后启动：

PHP
$env:CLAUDE_CODE_SUBAGENT_MODEL = "gpt-5.6-sol"
$env:CLAUDE_CODE_ALWAYS_ENABLE_EFFORT = "1"
$env:CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY = "3"
$env:ENABLE_TOOL_SEARCH = "false"

claude --model gpt-5.6-sol

长期使用建议封装成 PowerShell 函数写进 $PROFILE——但别把真实代理密钥写进去。

验证成功的六个标志：

  1. CLIProxyAPI 在运行且只监听本机
  2. Claude Code 启动无报错
  3. 顶部显示 gpt-5.6-sol
  4. 代理日志里请求模型确认为 gpt-5.6-sol
  5. 临时项目完成最小测试（读文件→改一行→调工具）
  6. 子 Agent 路由也符合预期

别用「你是谁」来验证——模型自我报告不可靠，去翻代理日志才准。

评论区吵起来了：三个关键争议

原帖数据炸裂，评论区自然分化：

赞成的：Theo（另一位知名开发者）表示自己代理早配好了，两轮提示就搞定切换。大量收藏数也说明开发者想要 Claude Code 的交互方式 + GPT 的模型。

质疑一：同一模型换个 Harness 凭啥表现更好？
Jonny Gravity 问了句很对的话——模型没变，换个壳就更好？这可能来自系统提示词、工具定义、任务拆分方式、并发策略的变化，而不是"Harness 让模型变聪明了"。没有同一仓库 + 同一任务 + 相同权限的对照测试，下不了结论。

质疑二：已经有 Codex CLI 了，加这层代理图啥？
Tom Arnold 说得直接：酷，但没必要。如果 Codex App 或 CLI 已经够用了，额外加代理层意味着更多安装、日志、兼容和安全维护。对大部分只想写代码的人来说，直接走官方路径更省心。

质疑三：额度消耗和重置不透明
有用户报告额度掉太快、承诺的 reset 没到账。这不能直接甩锅给 claudex，更像是 Codex 配额机制本身的反馈——但用了代理后请求链路更长，你不自己记着消耗量，就更难判断到底花在哪了。

谁该试、谁别碰

适合试的：

  • 你本来就重度用 Claude Code，喜欢它的终端交互、工具编排和子 Agent 体系
  • 已经在跑 CLIProxyAPI，切换成本很低
  • 你是想对比同一模型在不同 Harness 下的表现，这是正经的对照实验思路
  • 你能自己读日志、处理端口冲突、排查 OAuth 问题

别碰的：

  • 你只是想稳定用 GPT-5.6 Sol，对 Claude Code 没特别需求——直接用 Codex App
  • 企业生产环境、受监管业务、含敏感代码的项目——没有商量的余地
  • 你无法判断第三方代理是否安全——别碰
  • 你不想承担环境变量和兼容层随版本变化的维护成本

四个你必须知道的风险

  1. 非官方路径。 Tibo 的帖子是个人分享，不是正式文档、不是服务条款、不是技术支持承诺。他最后那句「被封就补一次 reset」明显是玩笑，不能当账号保障。
  2. OAuth 凭证交给了第三方。 代理只在本地运行没错，但它接触了你的认证信息和模型请求。务必从官方仓库下载，检查更新记录，绑定 127.0.0.1，设置访问密钥，别用来路不明的二次打包版。
  3. 协议兼容 ≠ 行为一致。 Claude Code 的工具格式、事件流和上下文机制围绕 Anthropic 模型设计。代理翻译得再好，也不能保证所有边界行为都和原生一致——工具调用失败、流式响应异常、上下文压缩偏差，都可能发生。
  4. 并发和子 Agent 是额度黑洞。 主 Agent 用 5.6 Sol，子 Agent 也用 5.6 Sol，还允许三个工具并发。一个复杂任务能烧掉好几个简易任务的额度。开始测试时必须限制任务规模、记录消耗，再看要不要长期用。

看法

claudex 最有价值的地方不是「Claude 和 GPT 的合体」——那种叙事好看但离真相很远。真正的好方向是：Agent Harness 和模型可以分开选。

你保留了 Claude Code 的交互习惯，底下换了 GPT-5.6 Sol 的推理。对喜欢终端工作流的开发者，这是个值得做的对照实验。如果你想系统性地对比不同模型在 Claude Code 环境下的表现，这套方案能给你不少一手数据。

但对只想稳定写代码的人来说——直接用 Codex App 或 Codex CLI 更简单，也更接近官方支持路径。

一句话收尾：把这个方案当成实验跑着玩没问题，但别把 OAuth、额度和生产代码绑在一个第三方代理上不做任何保护。

本文最后更新于2026年7月13日，若涉及的内容可能已经失效，直接留言反馈补链即可，我们会处理，谢谢
声明：本站所有内容均由互联网收集整理、网友上传，并且以计算机技术研究交流为目的，仅供大家参考、学习，请勿用于任何商业目的与商业用途，如需商用请支持正版！如亲下载后改变其用途与使用方式，与本站无任何关系，本站已经进行告知义务！我们只做安全认证测试如果资源侵犯了您的版权利益，请联系站长邮箱：17606723350@163.com