Claudex：通过 CLIProxyAPI 在 Claude Code 中运行 GPT-5.6 Sol

可以，你能把 GPT-5.6 Sol 用作 Claude Code CLI 背后的模型。Claude Code 继续负责读取代码仓、制定计划、调用工具和调度子智能体。CLIProxyAPI 在本机把 Anthropic Messages 格式翻译后，通过你的 Codex OAuth 登录将请求发送给 OpenAI。社区把这套组合称为 Claudex。

网上流传的四行别名不是完整配置。它只会在网关已经安装、认证并连接之后选择模型。没有 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN，Claude Code 不知道要把请求发给 CLIProxyAPI。

下面补上缺失的连接步骤，将代理限制在 localhost，并在每一层都做验证。这个别名只影响 claudex，不会改变正常的 claude 会话。事实与命令核对于 2026 年 7 月 26 日。

Claudex 到底是什么

CLIProxyAPI 的源代码在 GitHub，但它不是 Anthropic 或 OpenAI 的产品。Anthropic 文档允许 Claude Code 连接兼容网关，同时明确不支持通过网关把 Claude Code 路由到非 Claude 模型。技术上可行，不代表官方提供支持。

本文只解决部署意图。如果你在做产品选型，请看单独的 Claude Code 与 OpenCode 团队成本对比。如果你要选生产网关，请看 LLM 网关与路由器对比。三篇内容分别回答安装、购买和基础设施问题，避免关键词互相竞争。

真的只要两分钟吗

如果 Homebrew、Claude Code 和有权限的 Codex 账户都已准备好，顺利路径只需几分钟。第一次安全配置通常更久，因为你需要检查配置、生成客户端 key、完成浏览器 OAuth，并验证模型列表。这些检查不能为了截图速度而省略。

1. 在 macOS 安装 CLIProxyAPI

brew install cliproxyapi
brew services start cliproxyapi

这是 CLIProxyAPI 快速开始中的当前命令。Homebrew 通常读取 $(brew --prefix)/etc/cliproxyapi.conf。修改之前先确认实际生效的路径。

2. 仅监听 localhost，并设置客户端 key

项目示例把 host 留空，这会绑定所有 IPv4 与 IPv6 接口。保存 OAuth 凭据的个人代理应该只监听 127.0.0.1：

host: "127.0.0.1"
port: 8317

remote-management:
  allow-remote: false
  secret-key: ""

api-keys:
  - "claudex-REPLACE-WITH-A-LONG-RANDOM-SECRET"

用 openssl rand -hex 32 在本机生成值，不要把它贴进代码仓、issue 或截图。官方配置参考说明了监听地址、端口、认证目录与 API key。

brew services restart cliproxyapi

3. 连接 Codex 账户

cliproxyapi --codex-login

浏览器会打开 OpenAI OAuth。对于无界面的远程机器，Codex OAuth 文档提供 --no-browser，本地回调端口是 1455。请选择你打算消耗 Codex 配额的工作区。

CLIProxyAPI 会在配置的认证目录中保存敏感材料，通常是 ~/.cli-proxy-api。不要提交到 Git，保护系统账户，并及时更新代理。通过第三方客户端使用订阅之前，应自行核对最新产品规则与服务条款。

4. 打开 Claude Code 之前先验证代理

curl -sS http://127.0.0.1:8317/v1/models \
  -H "Authorization: Bearer claudex-REPLACE-WITH-A-LONG-RANDOM-SECRET"

JSON 中出现 gpt-5.6-sol 之后再继续。OpenAI 在 GPT-5.6 Sol 模型页面公布了这个模型 ID、105 万 token 上下文、最多 12.8 万输出 token，以及从 none 到 max 的推理等级。实际访问仍可能受计划与滚动发布影响。

如果返回 401，客户端 key 与 api-keys 不一致。如果列表没有模型，先更新 CLIProxyAPI、检查 OAuth，并确认原生 Codex 能看到模型。别名无法创造账户权限。

5. 添加完整 Claudex 别名

把下面内容加入 ~/.zshrc，替换 key 后打开新终端：

alias claudex='ANTHROPIC_BASE_URL=http://127.0.0.1:8317 \
ANTHROPIC_AUTH_TOKEN=claudex-REPLACE-WITH-A-LONG-RANDOM-SECRET \
CLAUDE_CODE_SUBAGENT_MODEL=gpt-5.6-sol \
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=3 \
ENABLE_TOOL_SEARCH=auto:5 \
claude --model gpt-5.6-sol'

运行 claudex，发送一条最小提示，再执行 /status。根据 Claude Code 网关连接指南，状态页应显示自定义 base URL 与 token 来源。这能证明会话继承了网关设置。普通 claude 不受影响。

为什么不照抄流传中的别名

Tool Search 文档说明，第三方 ANTHROPIC_BASE_URL 通常会退回提前加载。auto:5 会在工具 schema 超过上下文的 5% 时启用延迟发现。只有当 CLIProxyAPI 拒绝 beta header 或 tool_reference 时，才改用 false。

不用隐藏开关也能设置推理等级

GPT-5.6 Sol 支持 none、low、medium、high、xhigh 与 max。CLIProxyAPI 正式记录了 gpt-5.6-sol(high) 这类后缀，并会翻译成 OpenAI 推理参数：

claude --model 'gpt-5.6-sol(high)'

建议从 medium 或 high 开始，再测量每个验收通过任务的成本。更深推理可能消耗更多配额，也可能调用更多工具。我们的 每 token 成本与每任务成本分析解释了为什么最深的一次调用未必带来最便宜的合格改动。

GPT-5.6 Sol 放进 Claude Code 会更强吗

模型本身没有变化，变化的是 harness。Claude Code 决定读取哪些仓库上下文、如何暴露工具、何时委派，以及如何把结果送回对话。GPT-5.6 Sol 在这个循环中负责决策与输出。开发者可能更喜欢 Claude Code 的编排方式，但代理不会改变 OpenAI 的模型权重。

请在同一代码 commit、同一测试、权限、推理等级和审阅标准下，对比原生 Codex、原生 Claude Code 与 Claudex。我们的 Claude Fable 编程工作流介绍了另一条路线：让 Claude 同时担任编排者与判断模型。

快速排错

• 仍然显示 Claude：检查 /status，重新加载 ~/.zshrc，并排查覆盖 shell 的 settings。
• 401：ANTHROPIC_AUTH_TOKEN 必须与本地 api-keys 条目一致。
• Unknown model：查询 /v1/models 并使用返回的精确 ID。
• Tool Search 返回 400：暂时改为 ENABLE_TOOL_SEARCH=false，代理更新后再测试。
• 压缩时机异常：观察 /context，只在可丢弃会话中测试上下文相关修改。

什么时候适合用 Claudex

它适合可回滚的个人比较，前提是你懂本地 OAuth 存储和代理维护，会用测试、diff 与人工审阅验证结果，并接受 Anthropic 不提供该组合的支持。

如果涉及客户代码、受监管数据或公司密钥，不要悄悄把本地别名变成团队标准。企业需要按用户撤销、审计与脱敏、预算、模型 allowlist、升级责任、评测和事故负责人。本地订阅代理不是生产 API 合同。

团队落地应使用独立凭据、集中配置、密钥管理、版本固定、脱敏日志与回滚。如果你需要的是可运营的多模型体系，而不是周末实验，Wavect 的 AI 赋能与架构服务可以协助设计网关、评测和治理层。

一手来源与时效边界

核对日期为 2026 年 7 月 26 日。使用前请重新查看 OpenAI 模型页面、OpenAI 可用性说明、Claude Code 网关指南、环境变量参考、CLIProxyAPI 快速开始、Codex OAuth 文档与 推理等级翻译说明。