AI之Anthropic：free-claude-code的简介、安装和使用方法、案例应用之详细攻略

AI之Anthropicfree-claude-code的简介、安装和使用方法、案例应用之详细攻略目录free-claude-code的简介1、特点free-claude-code的安装和使用方法1、安装T1、运行源码T2、使用 fcc-server2、使用方法free-claude-code的案例应用Claude Code 使用免费模型Claude Code 接入 GeminiClaude Code 使用本地模型不同任务自动路由不同模型远程 Coding Assistant语音驱动 Claude Codefree-claude-code的简介Free Claude Code 是一个 Anthropic Messages API 兼容代理Proxy。项目定位是让 Claude Code 可以通过兼容 Anthropic Messages API 的代理使用任意 Anthropic-compatible Provider免费、付费或本地模型而不仅限于 Anthropic 官方 API。官方 README 对其定义非常明确“Use Claude Code CLI, VS Code, JetBrains ACP, or chat bots through your own Anthropic-compatible proxy。”它本身不是 Claude Code 的替代品也不是一个新的 AI Agent真正的作用是位于 Claude Code 与真正的大模型之间负责转发 Anthropic API 请求。当 Claude Code 发起请求时请求经由 Free Claude Code Proxy 根据配置路由至 OpenRouter、Google Gemini、DeepSeek、Groq、NVIDIA NIM、LM Studio、Ollama、llama.cpp 等任意后端。整个过程中Claude Code 仍认为自己连接的是 Anthropic APIProxy 对协议进行兼容最终真正调用的是用户自己配置的模型因此官方称其为“Drop-in proxy for Claude Codes Anthropic API calls”。项目核心目标包括保持 Claude Code 客户端协议不变支持任意 Anthropic Compatible Provider支持免费模型、本地模型和商业模型用户可自由选择 Provider。官方原文强调“It keeps Claude Codes client-side protocol stable while letting you choose free, paid, or local models。”Github地址GitHub - Alishahryar1/free-claude-code: Use claude code and codex for free in the terminal, VSCode extension, and discord like OpenClaw (voice supported) · GitHub1、特点特点详细说明支持大量模型提供商17 个 Provider目前支持 NVIDIA NIM、OpenRouter、Google AI StudioGemini、DeepSeek、Mistral La Plateforme、Codestral、OpenCode Zen、OpenCode Go、Wafer、Kimi、Cerebras Inference、Groq、Fireworks AI、Z.ai、LM Studio、llama.cpp、Ollama官方称之为“Seventeen provider backends”。支持免费、本地、商业模型混用README 强调不同 Claude 模型可以分别映射到不同 Provider。例如 Claude Opus 映射到 OpenRouterClaude Sonnet 映射到 GeminiClaude Haiku 映射到本地 OllamaFallback 映射到 NVIDIA NIM。官方称其为“Per-model routing”支持 Opus、Sonnet、Haiku、Fallback 分别配置不同 Provider。完整兼容 Claude Code官方强调它不是 Hack而是保持 Claude Code 的协议不变。Streaming、Tool Use、Thinking Blocks、Token Usage、Model Picker 以及 Claude Code 自动压缩上下文等功能全部继续正常工作。支持 Claude Code Model PickerREADME 专门介绍了支持 Claude Code 的 /model 模型选择器原因是 Proxy 实现了 /v1/models 接口因此 Claude Code 可以正常列出所有模型。本地管理后台项目自带 /admin 管理页面可以修改 Provider、检查配置、验证 API、重启 Proxy、管理 Messaging 和 Voice。README 强调所有 Proxy 配置建议通过 Admin UI 修改。支持远程 BotREADME 提供 Messaging Integration支持 Discord Bot 和 Telegram Bot可以远程启动 Claude Code、实时查看输出、停止任务、清空 Session并支持 Reply Thread。支持语音输入项目支持 Voice Notes有两种方式NVIDIA NIM远程语音识别和 Local Whisper本地 Whisper支持 CPU 和 CUDA。甚至可以 Whisper NIM 同时安装。请求优化README 提到 Proxy 不只是转发还会本地回答部分探测请求以减少 Token 消耗、降低 Latency、节约配额官方称其为“Local request optimizations”。free-claude-code的安装和使用方法1、安装T1、运行源码README 给出的源码运行方式git clone GitHub - Alishahryar1/free-claude-code: Use claude code and codex for free in the terminal, VSCode extension, and discord like OpenClaw (voice supported) · GitHubcd free-claude-codeuv run uvicorn server:app --host 0.0.0.0 --port 8082启动以后Proxy 默认监听 localhost:8082Claude Code 将连接这里。T2、使用 fcc-server安装以后README 提供几个 CLIfcc-server 启动 Proxyfcc-claude 启动 Claude Codefcc-init 初始化配置free-claude-code 兼容入口。2、使用方法VS Code 配置README 给出了完整环境变量主要包括 ANTHROPIC_BASE_URL 设为 http://localhost:8082ANTHROPIC_AUTH_TOKEN 设为 freeccCLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY 设为 1CLAUDE_CODE_AUTO_COMPACT_WINDOW 设为 190000。配置完成后 Reload VS CodeClaude Code Extension 即可通过 Proxy 工作。JetBrains 配置README 说明修改 acp.json加入 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、MODEL_DISCOVERY然后重启 IDE。Discord Bot 配置README 给出完整步骤包括创建 Discord Bot、开启 Message Content Intent、获取 Bot Token 和 Channel ID在 Admin UI 配置允许目录Validate 并 Apply即可远程控制 Claude Code。Telegram Bot类似流程通过 BotFather 创建 Bot、获取 Token 和 User ID在 Admin UI 配置允许用户即可开始使用。Voice NotesREADME 提供 Linux、macOS、Windows 三套安装命令可以安装 Whisper、NVIDIA NIM 或 CUDA Whisper。安装后在 Admin UI 的 Messaging → Voice 中开启 Voice Notes 即可。free-claude-code的案例应用Claude Code 使用免费模型这是 README 最典型的应用——Claude Code 经 Proxy 路由至 NVIDIA NIM利用 NVIDIA 免费额度完成 Claude Code 推理。Claude Code 接入 Gemini通过 Google AI Studio 让 Claude Code 使用 Gemini无需修改 Claude Code 本身。Claude Code 使用本地模型README 支持 LM Studio、Ollama、llama.cpp即 Claude Code 经 Proxy 调用本地模型无需联网调用 Anthropic。不同任务自动路由不同模型README 举例支持 Opus 路由到 OpenRouterSonnet 路由到 GeminiHaiku 路由到 OllamaFallback 路由到 NVIDIA NIM根据 Claude 请求自动路由不同 Provider实现成本、性能与能力之间的平衡。远程 Coding Assistant利用 Discord Bot 或 Telegram Bot可以提交 Coding 任务、实时查看执行进度、停止任务、清空 Session适用于远程控制 Claude Code 进行开发工作。语音驱动 Claude CodeREADME 展示了 Voice Notes 集成方案用户发送语音 → Whisper本地或 NVIDIA NIM转写 → Free Claude Code → Claude Code 执行任务 → 结果返回聊天机器人。这一流程适合在移动端或即时通信平台中以语音方式发起开发和自动化任务。