--- title: "CLIProxyAPI：在 Claude Code 中运行 GPT-5.6 Sol" canonical: https://wavect.io/zh/blog/claude-code-gpt-5-6-sol-cliproxyapi/ language: zh description: "通过 CLIProxyAPI 在 Claude Code 中运行 GPT-5.6 Sol：安全的 macOS 安装、完整 Claudex 别名、模型验证、token 控制与故障排查。" image: "https://wavect.io/img/blog/headers/header_claude-code-gpt-5-6-sol-cliproxyapi.png" --- [**返回**](/zh/blog/overview/) [![Kevin Riedl](/img/team/kevin.webp)](/zh/team/kevin-riedl/) [Kevin Riedl](/zh/team/kevin-riedl/) https://linkedin.com/in/wsdt 10 分钟 阅读 · 2026年7月26日 最近审核 2026年8月7日 [**下一篇**](/zh/blog/claude-code-vs-opencode-team-cost-2026/) # 用 CLIProxyAPI 在 Claude Code 中运行 GPT-5.6 Sol 要点速览 Claudex 是一种非官方配置：保留 Claude Code CLI 与智能体编排框架，由 CLIProxyAPI 翻译 Anthropic 格式的请求并路由到 OpenAI 的 GPT-5.6 Sol。流传中的别名如果缺少 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，就无法完成连接。在 macOS 上先用 Homebrew 安装 CLIProxyAPI，将监听地址限制为 127.0.0.1，创建强客户端 API key，完成 Codex OAuth 登录，确认 /v1/models 返回 gpt-5.6-sol，再通过作用域明确的 claudex 别名启动 Claude Code。代理支持 tool_reference 时，应使用 ENABLE_TOOL_SEARCH=auto:5 或 true；false 会把全部工具定义装入上下文。CLAUDE_CODE_ALWAYS_ENABLE_EFFORT 是未公开文档的兼容性开关，不能当成稳定依赖。这个方案适合个人实验与可回滚的模型对比，但 Anthropic 不支持通过网关运行非 Claude 模型，本地订阅代理也不能替代生产级团队网关。 **可以，你能把 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 年 8 月 7 日重新核对。 ## Claudex 到底是什么 | 层 | 运行内容 | 维护方 | | --- | --- | --- | | 智能体框架 | Claude Code CLI、工具、权限、记忆与子智能体 | Anthropic | | 协议桥 | 你电脑上的 CLIProxyAPI，通常监听 8317 端口 | 独立开源项目 | | 模型 | `gpt-5.6-sol` | OpenAI | | 认证 | 代理保存的 Codex OAuth，加上你自己的代理客户端 key | 你 | [CLIProxyAPI 的源代码在 GitHub](https://github.com/router-for-me/CLIProxyAPI) ，但它不是 Anthropic 或 OpenAI 的产品。Anthropic 文档允许 Claude Code 连接兼容网关，同时明确不支持通过网关把 Claude Code 路由到非 Claude 模型。技术上可行，不代表官方提供支持。 本文只解决部署意图。如果你在做产品选型，请看单独的 [Claude Code 与 OpenCode 团队成本对比](/zh/blog/claude-code-vs-opencode-team-cost-2026/) 。如果你要选生产网关，请看 [LLM 网关与路由器对比](/zh/blog/llm-gateway-router-comparison-2026/) 。三篇内容分别回答安装、购买和基础设施问题，避免关键词互相竞争。 ## 真的只要两分钟吗 如果 Homebrew、Claude Code 和有权限的 Codex 账户都已准备好，顺利路径只需几分钟。第一次安全配置通常更久，因为你需要检查配置、生成客户端 key、完成浏览器 OAuth，并验证模型列表。这些检查不能为了截图速度而省略。 ## 1. 在 macOS 安装 CLIProxyAPI ``` brew install cliproxyapi brew services start cliproxyapi ``` 这是 [CLIProxyAPI 快速开始](https://help.router-for.me/introduction/quick-start) 中的当前命令。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 或截图。 [官方配置参考](https://help.router-for.me/configuration/basic) 说明了监听地址、端口、认证目录与 API key。 ``` brew services restart cliproxyapi ``` ## 3. 连接 Codex 账户 ``` cliproxyapi --codex-login ``` 浏览器会打开 OpenAI OAuth。对于无界面的远程机器， [Codex OAuth 文档](https://help.router-for.me/configuration/provider/codex) 提供 `--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 模型页面](https://developers.openai.com/api/docs/models/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 网关连接指南](https://code.claude.com/docs/en/llm-gateway-connect) ，状态页应显示自定义 base URL 与 token 来源。这能证明会话继承了网关设置。普通 `claude` 不受影响。 ## 为什么不照抄流传中的别名 | 变量 | 建议 | 原因 | | --- | --- | --- | | `ANTHROPIC_BASE_URL` | 必需 | 真正把 Claude Code 路由到本地网关。 | | `ANTHROPIC_AUTH_TOKEN` | 必需 | 客户端用于登录本地代理，它不是 OpenAI OAuth token。 | | `CLAUDE_CODE_SUBAGENT_MODEL` | 通常保留 | 官方文档把它列为子智能体模型选择的最高优先级。 | | `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=3` | 可选 | 把默认并发从 10 降到 3，可缓解限流，但可能更慢。 | | `ENABLE_TOOL_SEARCH=false` | 默认不要 | 会把全部工具定义装进每一轮上下文。 | | `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT=1` | 实验性 | Anthropic 的公开环境变量参考没有记录它。 | [Tool Search 文档](https://code.claude.com/docs/en/agent-sdk/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 成本与每任务成本分析](/zh/blog/cost-per-token-vs-cost-per-task/) 解释了为什么最深的一次调用未必带来最便宜的合格改动。 ## GPT-5.6 Sol 放进 Claude Code 会更强吗 模型本身没有变化，变化的是 harness。Claude Code 决定读取哪些仓库上下文、如何暴露工具、何时委派，以及如何把结果送回对话。GPT-5.6 Sol 在这个循环中负责决策与输出。开发者可能更喜欢 Claude Code 的编排方式，但代理不会改变 OpenAI 的模型权重。 请在同一代码 commit、同一测试、权限、推理等级和审阅标准下，对比原生 Codex、原生 Claude Code 与 Claudex。我们的 [Claude Fable 编程工作流](/zh/blog/coding-with-claude-fable-5/) 介绍了另一条路线：让 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 赋能与架构服务](/zh/services/ai-enablement/) 可以协助设计网关、评测和治理层。 ## 一手来源与时效边界 核对日期为 2026 年 8 月 7 日。使用前请重新查看 [OpenAI 模型页面](https://developers.openai.com/api/docs/models/gpt-5.6-sol) 、 [OpenAI 可用性说明](https://help.openai.com/en/articles/20001354-gpt-56-in-chatgpt/) 、 [Claude Code 网关指南](https://code.claude.com/docs/en/llm-gateway-connect) 、 [环境变量参考](https://code.claude.com/docs/en/env-vars) 、 [CLIProxyAPI 快速开始](https://help.router-for.me/introduction/quick-start) 、 [Codex OAuth 文档](https://help.router-for.me/configuration/provider/codex) 与 [推理等级翻译说明](https://help.router-for.me/configuration/thinking) 。 ## 常见问题 ### Claude Code 能运行 GPT-5.6 Sol 吗？ 可以，通过 CLIProxyAPI 这类 Anthropic 兼容网关。Claude Code 仍是客户端与智能体框架，网关翻译请求并路由到 GPT-5.6 Sol。Anthropic 不支持在 Claude Code 中使用非 Claude 模型，因此这是非官方集成。 ### Claudex 是什么？ Claudex 是社区对 Claude Code 智能体框架加 OpenAI GPT 模型这一组合的称呼。它不是 Anthropic、OpenAI 或 CLIProxyAPI 推出的正式产品。 ### 为什么只复制流传的别名不能工作？ 它会选择 gpt-5.6-sol，却不一定把 Claude Code 连接到 CLIProxyAPI。安装、配置和 Codex OAuth 之后，完整别名还需要 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN。 ### ENABLE_TOOL_SEARCH 应该设为 false 吗？ 默认不应该。false 会把全部工具定义装入上下文。代理支持 tool_reference 时使用 auto:5 或 true，只有协议报错时才退回 false。 ### 代理会暴露在局域网吗？ 示例配置的 host 留空时会监听所有接口。本地使用应设为 127.0.0.1，使用强客户端 key，关闭远程管理，并且不要公开 8317 端口。 ### Claudex 适合企业吗？ 本地别名适合受控实验。企业还需要批准的供应商条款、按用户凭据、集中撤销、审计与脱敏、预算、模型 allowlist、升级、评测和事故负责人。 ## 最终思考 Claudex 把两个经常被混在一起的选择拆开了：智能体 harness 与模型。你可以保留 Claude Code 的工作流，同时测试底层的 GPT-5.6 Sol。但代理、凭据和协议桥也会成为系统的一部分，必须像其他开发基础设施一样验证。 先安装代理，限制为 localhost，完成 Codex 认证，验证模型端点，再使用作用域明确的别名。衡量验收通过的任务，而不是主观印象。如果实验成为团队依赖，应把个人别名替换为有治理的正式网关。 ## 你可能也喜欢.. [**Claude Code vs OpenCode：2026 年哪个团队成本更低？** 选择 harness 前，对比 token 开销、缓存、订阅、企业控制和每个验收通过任务的成本。](/zh/blog/claude-code-vs-opencode-team-cost-2026/) [**AI 赋能还是普通 AI 咨询？** 比较可运营、可衡量的生产体系与只提供策略的咨询项目。](/zh/compare/ai-enablement-vs-generic-ai-consultancy/) 智能体工程 ## 继续浏览此集群 编程智能体、MCP、上下文系统、评估与可靠自动化控制。 [从核心文章开始**AI 智能体的图工程：知识图谱什么时候值得做？**](/zh/blog/graph-engineering-ai-agents/) - [Cloudflare Kitesurf 评测：成本、限制与生产适用性](/zh/blog/cloudflare-kitesurf-browser-ai-agents/) - [GitHub Spec Kit 评测：这套流程值得吗？](/zh/blog/github-spec-kit-production-guide/) - [企业内部 AI 智能体市场：2026 架构与落地指南](/zh/blog/internal-ai-agent-marketplace/) - [Linux 是 AI 智能体的最佳操作系统吗？2026 基础设施指南](/zh/blog/linux-for-ai-agents/) - [MCP Cloud 对比 Manufact Cloud：MCP 托管指南](/zh/blog/mcp-cloud-vs-manufact-cloud/) 只收重要内容 ## 关注与你相关的内容 每当我们发布新文章，你会收到一封简短邮件。你可以关注整个博客，也可以只选感兴趣的主题。 [**返回**](/zh/blog/overview/) [![Kevin Riedl](/img/team/kevin.webp)](/zh/team/kevin-riedl/) [Kevin Riedl](/zh/team/kevin-riedl/) https://linkedin.com/in/wsdt 10 分钟 阅读 · 2026年7月26日 最近审核 2026年8月7日 [**下一篇**](/zh/blog/claude-code-vs-opencode-team-cost-2026/) 邮件订阅新文章 × × 通过邮件获取新文章 我们发布时给你一封简短邮件。免费，不做跟踪。 ## Structured Data ```json { "@context": "https://schema.org", "@graph": [ { "@id": "https://wavect.io/#organization", "@type": [ "Organization", "ProfessionalService", "LocalBusiness" ], "employee": [ { "@id": "https://wavect.io/team/kevin-riedl/#person", "@type": "Person", "jobTitle": "Managing Director", "name": "Kevin Riedl", "url": "https://wavect.io/team/kevin-riedl/", "worksFor": { "@id": "https://wavect.io/#organization", "@type": [ "Organization", "ProfessionalService", "LocalBusiness" ] } }, { "@id": "https://wavect.io/team/christof-jori/#person", "@type": "Person", "jobTitle": "Managing Director", "name": "Christof Jori", "url": "https://wavect.io/team/christof-jori/", "worksFor": { "@id": "https://wavect.io/#organization", "@type": [ "Organization", "ProfessionalService", "LocalBusiness" ] } } ], "founder": [ { "@id": "https://wavect.io/team/kevin-riedl/#person", "@type": "Person", "jobTitle": "Managing Director", "name": "Kevin Riedl", "url": "https://wavect.io/team/kevin-riedl/", "worksFor": { "@id": "https://wavect.io/#organization", "@type": [ "Organization", "ProfessionalService", "LocalBusiness" ] } }, { "@id": "https://wavect.io/team/christof-jori/#person", "@type": "Person", "jobTitle": "Managing Director", "name": "Christof Jori", "url": "https://wavect.io/team/christof-jori/", "worksFor": { "@id": "https://wavect.io/#organization", "@type": [ "Organization", "ProfessionalService", "LocalBusiness" ] } } ], "legalRepresentative": [ { "@id": "https://wavect.io/team/kevin-riedl/#person", "@type": "Person", "jobTitle": "Managing Director", "name": "Kevin Riedl", "url": "https://wavect.io/team/kevin-riedl/", "worksFor": { "@id": "https://wavect.io/#organization", "@type": [ "Organization", "ProfessionalService", "LocalBusiness" ] } }, { "@id": "https://wavect.io/team/christof-jori/#person", "@type": "Person", "jobTitle": "Managing Director", "name": "Christof Jori", "url": "https://wavect.io/team/christof-jori/", "worksFor": { "@id": "https://wavect.io/#organization", "@type": [ "Organization", "ProfessionalService", "LocalBusiness" ] } } ], "name": "Wavect GmbH", "subjectOf": { "@id": "https://wavect.io/verified-claims.json#dataset", "@type": "Dataset", "creator": { "@id": "https://wavect.io/#organization", "@type": [ "Organization", "ProfessionalService", "LocalBusiness" ] }, "description": "A machine-readable registry of quantitative and qualitative claims published by Wavect, with review dates, localized page appearances and public third-party citations where available.", "inLanguage": "en", "isAccessibleForFree": true, "license": "https://creativecommons.org/licenses/by/4.0/", "name": "Wavect verified publication claims", "url": "https://wavect.io/verified-claims.json" }, "url": "https://wavect.io/" }, { "@id": "https://wavect.io/team/kevin-riedl/#person", "@type": "Person", "jobTitle": "Managing Director", "name": "Kevin Riedl", "sameAs": [ "https://www.wikidata.org/wiki/Q139796365", "https://www.linkedin.com/in/wsdt", "https://github.com/wsdt" ], "url": "https://wavect.io/team/kevin-riedl/", "worksFor": { "@id": "https://wavect.io/#organization", "@type": [ "Organization", "ProfessionalService", "LocalBusiness" ] } }, { "@id": "https://wavect.io/team/christof-jori/#person", "@type": "Person", "jobTitle": "Managing Director", "name": "Christof Jori", "sameAs": [ "https://www.wikidata.org/wiki/Q139796367", "https://www.linkedin.com/in/jocr77/", "https://github.com/jo-chris" ], "url": "https://wavect.io/team/christof-jori/", "worksFor": { "@id": "https://wavect.io/#organization", "@type": [ "Organization", "ProfessionalService", "LocalBusiness" ] } }, { "@id": "https://wavect.io/#website", "@type": "WebSite", "inLanguage": [ "en", "de", "es", "zh" ], "name": "Wavect", "potentialAction": { "@type": "SearchAction", "query-input": "required name=search_term_string", "target": { "@type": "EntryPoint", "urlTemplate": "https://wavect.io/search/?q={search_term_string}" } }, "publisher": { "@id": "https://wavect.io/#organization", "@type": [ "Organization", "ProfessionalService", "LocalBusiness" ] }, "url": "https://wavect.io/" }, { "@id": "https://wavect.io/zh/blog/claude-code-gpt-5-6-sol-cliproxyapi/#webpage", "@type": "WebPage", "dateModified": "2026-07-26", "inLanguage": "zh", "isPartOf": { "@id": "https://wavect.io/#website", "@type": "WebSite" }, "lastReviewed": "2026-07-26", "url": "https://wavect.io/zh/blog/claude-code-gpt-5-6-sol-cliproxyapi/" } ] } ``` ```json { "@context": "https://schema.org", "@type": "BlogPosting", "abstract": "Claudex 是一种非官方配置：保留 Claude Code CLI 与智能体编排框架，由 CLIProxyAPI 翻译 Anthropic 格式的请求并路由到 OpenAI 的 GPT-5.6 Sol。流传中的别名如果缺少 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，就无法完成连接。在 macOS 上先用 Homebrew 安装 CLIProxyAPI，将监听地址限制为 127.0.0.1，创建强客户端 API key，完成 Codex OAuth 登录，确认 /v1/models 返回 gpt-5.6-sol，再通过作用域明确的 claudex 别名启动 Claude Code。代理支持 tool_reference 时，应使用 ENABLE_TOOL_SEARCH=auto:5 或 true；false 会把全部工具定义装入上下文。CLAUDE_CODE_ALWAYS_ENABLE_EFFORT 是未公开文档的兼容性开关，不能当成稳定依赖。这个方案适合个人实验与可回滚的模型对比，但 Anthropic 不支持通过网关运行非 Claude 模型，本地订阅代理也不能替代生产级团队网关。", "articleBody": " 博客概览/AI 与智能体/智能体工程 用 CLIProxyAPI 在 Claude Code 中运行 GPT-5.6 Sol 要点速览 Claudex 是一种非官方配置：保留 Claude Code CLI 与智能体编排框架，由 CLIProxyAPI 翻译 Anthropic 格式的请求并路由到 OpenAI 的 GPT-5.6 Sol。流传中的别名如果缺少 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，就无法完成连接。在 macOS 上先用 Homebrew 安装 CLIProxyAPI，将监听地址限制为 127.0.0.1，创建强客户端 API key，完成 Codex OAuth 登录，确认 /v1/models 返回 gpt-5.6-sol，再通过作用域明确的 claudex 别名启动 Claude Code。代理支持 tool_reference 时，应使用 ENABLE_TOOL_SEARCH=auto:5 或 true；false 会把全部工具定义装入上下文。CLAUDE_CODE_ALWAYS_ENABLE_EFFORT 是未公开文档的兼容性开关，不能当成稳定依赖。这个方案适合个人实验与可回滚的模型对比，但 Anthropic 不支持通过网关运行非 Claude 模型，本地订阅代理也不能替代生产级团队网关。 可以，你能把 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 年 8 月 7 日重新核对。 Claudex 到底是什么 层运行内容维护方 智能体框架Claude Code CLI、工具、权限、记忆与子智能体Anthropic 协议桥你电脑上的 CLIProxyAPI，通常监听 8317 端口独立开源项目 模型gpt-5.6-solOpenAI 认证代理保存的 Codex OAuth，加上你自己的代理客户端 key你 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 不受影响。 为什么不照抄流传中的别名 变量建议原因 ANTHROPIC_BASE_URL必需真正把 Claude Code 路由到本地网关。 ANTHROPIC_AUTH_TOKEN必需客户端用于登录本地代理，它不是 OpenAI OAuth token。 CLAUDE_CODE_SUBAGENT_MODEL通常保留官方文档把它列为子智能体模型选择的最高优先级。 CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=3可选把默认并发从 10 降到 3，可缓解限流，但可能更慢。 ENABLE_TOOL_SEARCH=false默认不要会把全部工具定义装进每一轮上下文。 CLAUDE_CODE_ALWAYS_ENABLE_EFFORT=1实验性Anthropic 的公开环境变量参考没有记录它。 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 年 8 月 7 日。使用前请重新查看 OpenAI 模型页面、OpenAI 可用性说明、Claude Code 网关指南、环境变量参考、CLIProxyAPI 快速开始、Codex OAuth 文档与 推理等级翻译说明。 常见问题 Claude Code 能运行 GPT-5.6 Sol 吗？ 可以，通过 CLIProxyAPI 这类 Anthropic 兼容网关。Claude Code 仍是客户端与智能体框架，网关翻译请求并路由到 GPT-5.6 Sol。Anthropic 不支持在 Claude", "articleSection": "Engineering", "author": { "@id": "https://wavect.io/team/kevin-riedl/#person", "@type": "Person", "name": "Kevin Riedl", "sameAs": [ "https://www.wikidata.org/wiki/Q139796365", "https://www.linkedin.com/in/wsdt", "https://github.com/wsdt" ], "url": "https://wavect.io/team/kevin-riedl/" }, "dateModified": "2026-08-07", "datePublished": "2026-07-26", "description": "Claudex 是一种非官方配置：保留 Claude Code CLI 与智能体编排框架，由 CLIProxyAPI 翻译 Anthropic 格式的请求并路由到 OpenAI 的 GPT-5.6 Sol。流传中的别名如果缺少 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，就无法完成连接。在 macOS 上先用 Homebrew 安装 CLIProxyAPI，将监听地址限制为 127.0.0.1，创建强客户端 API key，完成 Codex OAuth 登录，确认 /v1/models 返回 gpt-5.6-sol，再通过作用域明确的 claudex 别名启动 Claude Code。代理支持 tool_reference 时，应使用 ENABLE_TOOL_SEARCH=auto:5 或 true；false 会把全部工具定义装入上下文。CLAUDE_CODE_ALWAYS_ENABLE_EFFORT 是未公开文档的兼容性开关，不能当成稳定依赖。这个方案适合个人实验与可回滚的模型对比，但 Anthropic 不支持通过网关运行非 Claude 模型，本地订阅代理也不能替代生产级团队网关。", "headline": "用 CLIProxyAPI 在 Claude Code 中运行 GPT-5.6 Sol", "image": "https://wavect.io/img/blog/headers/header_claude-code-gpt-5-6-sol-cliproxyapi.svg", "inLanguage": "zh", "keywords": "AI 智能体, Claude Code, GPT-5.6", "mainEntityOfPage": { "@id": "https://wavect.io/zh/blog/claude-code-gpt-5-6-sol-cliproxyapi/", "@type": "WebPage" }, "publisher": { "@id": "https://wavect.io/#organization", "@type": [ "Organization", "ProfessionalService", "LocalBusiness" ] }, "url": "https://wavect.io/zh/blog/claude-code-gpt-5-6-sol-cliproxyapi/", "wordCount": 622 } ``` ```json { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "item": "https://wavect.io/zh/", "name": "首页", "position": 1 }, { "@type": "ListItem", "item": "https://wavect.io/zh/blog/overview/", "name": "博客概览", "position": 2 }, { "@type": "ListItem", "item": "https://wavect.io/zh/blog/topics/ai-agents/", "name": "AI 与智能体", "position": 3 }, { "@type": "ListItem", "item": "https://wavect.io/zh/blog/clusters/agent-engineering/", "name": "智能体工程", "position": 4 }, { "@type": "ListItem", "item": "https://wavect.io/zh/blog/claude-code-gpt-5-6-sol-cliproxyapi/", "name": "CLIProxyAPI：在 Claude Code 中运行 GPT-5.6 Sol | ", "position": 5 } ] } ``` ```json { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "acceptedAnswer": { "@type": "Answer", "text": "可以，通过 CLIProxyAPI 这类 Anthropic 兼容网关。Claude Code 仍是客户端与智能体框架，网关翻译请求并路由到 GPT-5.6 Sol。Anthropic 不支持在 Claude Code 中使用非 Claude 模型，因此这是非官方集成。" }, "name": "Claude Code 能运行 GPT-5.6 Sol 吗？" }, { "@type": "Question", "acceptedAnswer": { "@type": "Answer", "text": "Claudex 是社区对 Claude Code 智能体框架加 OpenAI GPT 模型这一组合的称呼。它不是 Anthropic、OpenAI 或 CLIProxyAPI 推出的正式产品。" }, "name": "Claudex 是什么？" }, { "@type": "Question", "acceptedAnswer": { "@type": "Answer", "text": "它会选择 gpt-5.6-sol，却不一定把 Claude Code 连接到 CLIProxyAPI。安装、配置和 Codex OAuth 之后，完整别名还需要 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN。" }, "name": "为什么只复制流传的别名不能工作？" }, { "@type": "Question", "acceptedAnswer": { "@type": "Answer", "text": "默认不应该。false 会把全部工具定义装入上下文。代理支持 tool_reference 时使用 auto:5 或 true，只有协议报错时才退回 false。" }, "name": "ENABLE_TOOL_SEARCH 应该设为 false 吗？" }, { "@type": "Question", "acceptedAnswer": { "@type": "Answer", "text": "示例配置的 host 留空时会监听所有接口。本地使用应设为 127.0.0.1，使用强客户端 key，关闭远程管理，并且不要公开 8317 端口。" }, "name": "代理会暴露在局域网吗？" }, { "@type": "Question", "acceptedAnswer": { "@type": "Answer", "text": "本地别名适合受控实验。企业还需要批准的供应商条款、按用户凭据、集中撤销、审计与脱敏、预算、模型 allowlist、升级、评测和事故负责人。" }, "name": "Claudex 适合企业吗？" } ] } ```