用途：free-claude-code-proxy 是一个本地代理服务器，用于把 Claude Code CLI、VS Code 扩展或 JetBrains ACP 发出的 Anthropic Messages API 请求，重新路由到其他云端或本地模型提供方，同时保持 Claude Code 的客户端协议。
主要能力：支持 NVIDIA NIM、Kimi、Wafer、OpenRouter、DeepSeek、LM Studio、llama.cpp、Ollama、OpenCode Zen、Z.ai 等提供方；支持流式、工具调用与推理块；可通过 Admin UI 配置提供方、API Key 与模型；支持按 Opus/Sonnet/Haiku 分层路由到不同提供方；在 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 时，/model 选择器可从代理的 /v1/models 端点发现模型；可自动剥离本地模型不支持的参数、转换 thinking 块、处理 SSE 差异、在提供方出错时用备用模型重试。
使用方式：先安装 uv 与 Python 3.14，再安装 Claude Code；随后执行 uv tool install --force git+https://github.com/Alishahryar1/free-claude-code.git 安装代理；运行 fcc-server，默认监听 http://127.0.0.1:8082，Admin UI 位于 /admin。通过 Admin UI 或 .env 配置提供方 API Key 与 MODEL，模型名需带提供方前缀，如 nvidia_nim/z-ai/glm4.7。CLI 推荐使用 fcc-claude 启动；也可手动设置 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 后运行 claude。VS Code 需在 settings.json 的 claudeCode.environmentVariables 中加入对应变量；JetBrains ACP 需在 installed.json 或 acp.json 中为 claude-acp 添加 env。
限制与说明：需保持 fcc-server 运行；默认端口 8082，可用 PORT 调整；AUTH_TOKEN 默认 freecc，需与客户端一致，否则返回 401。本地模型需支持工具调用并配置足够上下文，llama.cpp 可用 --ctx-size 调整。MODEL 留空时 /v1/models 返回空列表。代理仅在本地运行，不提供密钥托管。其余未在资料中说明的细节暂未提供。