القائمة
客户端配置指南，教用户如何在 Claude Code、Codex 等 Agent 工具中配置 Protocol Proxy
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
多模态服务指南，包括图片生成、视频生成、语音合成、音乐生成的配置与使用
系统概述，介绍 Protocol Proxy 的定位、核心能力和典型使用场景
供应商管理指南，包括创建供应商、配置 API Key、密钥轮换
监控与日志指南，包括用量统计、请求日志、系统日志查看
智控助手使用指南，包括对话、技能管理、斜杠命令、快捷键
MCP 服务配置指南，包括添加、连接、排查 MCP 服务器
| name | guide-client-config |
| description | 客户端配置指南，教用户如何在 Claude Code、Codex 等 Agent 工具中配置 Protocol Proxy |
| trigger | 用户询问怎么在 Claude Code 中配置、怎么接入 Codex、客户端怎么配置、Agent 工具怎么设置、API 地址怎么改、怎么连到代理、OPENAI_BASE_URL、ANTHROPIC_BASE_URL、Claude Code 怎么用、Codex 怎么用 |
本技能指导用户将 Claude Code、Codex CLI 等 Agent 工具接入 Protocol Proxy。
8080）Claude Code 通过环境变量配置 API 端点。编辑 ~/.claude/settings.json：
{
"env": {
"ANTHROPIC_BASE_URL": "http://localhost:8080",
"ANTHROPIC_AUTH_TOKEN": "你的 API Key"
}
}
| 变量 | 说明 | 示例 |
|---|---|---|
ANTHROPIC_BASE_URL | 代理地址（必填） | http://localhost:8080 |
ANTHROPIC_AUTH_TOKEN | API Key（必填） | sk-xxx |
API_TIMEOUT_MS | 请求超时（毫秒） | 3000000（50 分钟） |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 禁用非必要请求 | 1 |
ANTHROPIC_AUTH_TOKEN 填 Protocol Proxy 代理配置的认证 Token（如启用了认证），或供应商的 API KeyANTHROPIC_AUTH_TOKEN 可填任意非空字符串假设代理监听在 localhost:8080，未启用认证：
{
"env": {
"ANTHROPIC_BASE_URL": "http://localhost:8080",
"ANTHROPIC_AUTH_TOKEN": "sk-placeholder",
"API_TIMEOUT_MS": "3000000"
}
}
Codex CLI 使用 TOML 配置文件。编辑 ~/.codex/config.toml：
model_provider = "proxy"
model = "你要使用的模型名"
[model_providers.proxy]
name = "Protocol Proxy"
base_url = "http://localhost:8081"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
request_max_retries = 4
stream_max_retries = 10
stream_idle_timeout_ms = 300000
| 配置项 | 说明 | 示例 |
|---|---|---|
model_provider | 指定使用自定义 provider | proxy |
model | 默认模型名 | gpt-4o、deepseek-chat |
base_url | 代理地址 | http://localhost:8081 |
env_key | 从环境变量读取 API Key 的变量名 | OPENAI_API_KEY |
wire_api | API 格式 | responses（推荐）或 chat |
env_key 指定从哪个环境变量读取 API Key，需确保该环境变量已设置wire_api 设为 responses 使用 Responses API 格式，设为 chat 使用 Chat Completions 格式假设代理监听在 localhost:8081，使用 DeepSeek 模型：
model_provider = "proxy"
model = "deepseek-chat"
[model_providers.proxy]
name = "DeepSeek via Proxy"
base_url = "http://localhost:8081"
env_key = "OPENAI_API_KEY"
wire_api = "chat"
request_max_retries = 4
stream_max_retries = 10
stream_idle_timeout_ms = 300000
大多数支持 OpenAI API 的工具都可以通过以下方式接入：
| 配置项 | 值 |
|---|---|
| API Base URL | http://localhost:<代理端口> |
| API Key | 供应商的 API Key 或代理的认证 Token |
| 模型名 | 代理配置的默认模型，或供应商支持的任意模型名 |
| 工具 | Base URL 变量 | API Key 变量 |
|---|---|---|
| 通用 OpenAI SDK | OPENAI_BASE_URL | OPENAI_API_KEY |
| LangChain | OPENAI_API_BASE | OPENAI_API_KEY |
| Vercel AI SDK | OPENAI_BASE_URL | OPENAI_API_KEY |
增大超时时间：
API_TIMEOUT_MS 为更大的值（如 3000000）stream_idle_timeout_msProtocol Proxy 会自动转换协议，但需确保：