【免费下载链接】free-claude-codeUse Claude Code for free in the terminal, VSCode extension, or via Discord项目地址https://gitcode.com/gh_mirrors/fre/free-claude-code点击查看免费下载如果你想在服务器上长期免费运行 Claude Codefree-claude-code 是一个轻量级代理方案它把 Claude Code CLI / VSCode 扩展的 Anthropic API 请求转发到 NVIDIA NIM每分钟 40 次免费、OpenRouter 或本地 LM Studio无需 Anthropic API Key。本文给出一份可直接照做的生产部署清单涵盖环境准备、配置、常驻运行、远程接入与日常运维。 部署前置先备齐 4 样东西准备项说明模型提供方 API KeyNVIDIA NIM免费额度最大推荐或 OpenRouterLM Studio 则完全本地、无需 KeyClaude Code官方 CLI 或 VSCode 扩展作为客户端接入代理uv依赖与运行环境管理工具未安装先装已安装执行uv self update升级Python 3.14项目 pyproject.toml 要求3.14缺失时执行uv python install 3.14️ 第一步拉取代码并安装依赖在服务器上执行git clone https://gitcode.com/gh_mirrors/fre/free-claude-code cd free-claude-code cp .env.example .env uv syncuv sync会根据 pyproject.toml 安装 FastAPI、uvicorn、loguru 等全部运行依赖。可选若要在 Discord/Telegram 使用语音消息转写按需追加 extrasuv sync --extra voice_local # 本地 Whisper免费离线 uv sync --extra voice # NVIDIA NIM 转写需要 NIM API Key⚙️ 第二步配置 .env 关键点清单所有配置都集中在这一个文件里完整参数参考 .env.example运行时由 config/settings.py 统一加载校验。生产环境重点关注这几组1. 模型路由必配— 格式固定为provider/model/name前缀必须是nvidia_nim、open_router或lmstudioNVIDIA_NIM_API_KEYnvapi-你的Key # 或 OPENROUTER_API_KEY MODELnvidia_nim/z-ai/glm4.7 # 兜底模型 MODEL_OPUSnvidia_nim/z-ai/glm4.7 # Opus 请求 → 映射模型可省略 MODEL_SONNETnvidia_nim/moonshotai/kimi-k2-thinking MODEL_HAIKUnvidia_nim/stepfun-ai/step-3.5-flash三个MODEL_*可以混合不同提供方实现分级路由。2. 限流与并发生产必调— 对应 config/settings.py变量默认值生产建议PROVIDER_RATE_LIMIT40按提供方免费额度设置NIM 保持 40PROVIDER_RATE_WINDOW60窗口秒数与上一项配套PROVIDER_MAX_CONCURRENCY5多人共用时调低防止并发打满额度3. 超时与优化开关—HTTP_READ_TIMEOUT默认 120s建议按所选模型的实际响应速度上调ENABLE_*系列优化开关默认全开可拦截 5 类无意义的 API 调用以节省配额生产环境保持默认即可。 第三步启动代理并让它常驻运行启动命令来自 server.py 的官方注释推荐uv run uvicorn server:app --host 0.0.0.0 --port 8082 --timeout-graceful-shutdown 5--timeout-graceful-shutdown 5很关键应用 lifespan 会限时 5 秒完成子进程与连接清理见 api/app.py避免停机时挂起。生产环境推荐用 systemd 托管创建/etc/systemd/system/free-cc.service[Unit] Descriptionfree-claude-code proxy Afternetwork.target [Service] WorkingDirectory/opt/free-claude-code ExecStart/root/.local/bin/uv run uvicorn server:app --host 0.0.0.0 --port 8082 --timeout-graceful-shutdown 5 Restartalways RestartSec5 [Install] WantedBymulti-user.target然后systemctl enable --now free-cc即可开机自启 崩溃自动拉起。 第四步终端与 VSCode 远程接入终端在任意能访问服务器的机器上设置两个环境变量即可把地址换成服务器 IPANTHROPIC_AUTH_TOKENfreecc ANTHROPIC_BASE_URLhttp://服务器IP:8082 claudeVSCode 扩展在settings.json中配置claude-code.environmentVariables将ANTHROPIC_BASE_URL指向服务器地址、ANTHROPIC_AUTH_TOKEN设为freecc重载扩展即可。首次若弹出登录页选择 Anthropic Console 授权后忽略购买引导扩展即可正常工作。想临时换模型可用仓库自带的 claude-pick 交互式模型选择器建议安装 fzf免去每次改.env。 第五步可选部署 Discord / Telegram 远程机器人在.env中追加配置即可平台实现位于 messaging/ 目录MESSAGING_PLATFORMdiscord DISCORD_BOT_TOKEN你的Bot令牌 ALLOWED_DISCORD_CHANNELS频道ID1,频道ID2 CLAUDE_WORKSPACE./agent_workspace # 会话与产物存储目录 ALLOWED_DIR/path/to/你的项目目录 # Claude 实际工作的目录要点Discord 需在开发者门户开启 Message Content IntentTelegram 则配置TELEGRAM_BOT_TOKEN和ALLOWED_TELEGRAM_USER_ID。白名单为空 不允许任何渠道这是安全默认值按需填写。会话树持久化在agent_workspace/sessions.json服务重启后自动恢复重启前进行中的任务会标记清理不会残留僵尸进程。 服务器运维日常 8 项检查清单#检查项说明1看日志日志为 JSON 行格式写入server.log带request_id上下文50MB 自动轮转config/logging_config.py可用jq或grep ERROR快速排查2监控 429内置滚动窗口主动限流 429 指数退避providers/rate_limit.py若频繁出现 429调低PROVIDER_RATE_LIMIT3控制并发多人共用时降低PROVIDER_MAX_CONCURRENCY防止免费额度被瞬间打满4备份会话定期备份agent_workspace/目录即历史会话与产物5磁盘空间关注server.log轮转文件与agent_workspace增长按需清理6端口安全代理本身没有认证机制freecc只是占位令牌8082 端口务必用防火墙限制在局域网或可信 IP切勿裸奔公网7优雅重启更新代码后执行systemctl restart free-cclifespan 会限时清理子进程启动时自动恢复会话树8冒烟测试重启后用一条claude -p hi类短请求验证链路再检查server.log是否出现新请求记录️ 常见问题速查症状原因解决启动即报 Model 前缀错误MODEL前缀不是nvidia_nim/open_router/lmstudio按provider/model/name格式修正 .env启动报 NIM Key 缺失WHISPER_DEVICEnvidia_nim但未配NVIDIA_NIM_API_KEY补 Key或改用cpu设备 本地 Whisper消息平台未启动缺少对应依赖discord.py / python-telegram-bot检查uv sync输出日志中会打印 import 错误详情偶发请求失败触达提供方限流查看server.log中 429 记录调小限流参数✅ 小结free-claude-code 的生产部署其实很简单clone → 配.env→ uvicorn 常驻 → 客户端指过去。真正的功夫在运维细节——限流参数、并发上限、端口白名单和日志巡检。按这份清单逐项勾选就能把一个免费 Claude Code 代理稳定地跑在生产服务器上。赞分享【免费下载链接】free-claude-codeUse Claude Code for free in the terminal, VSCode extension, or via Discord项目地址https://gitcode.com/gh_mirrors/fre/free-claude-code点击查看免费下载相关推荐ART完整部署与运维指南从本地开发到Kubeflow生产环境ART完整部署与运维指南从本地开发到Kubeflow生产环境 Adversarial Robustness Toolbox ART 是一个强大的Python库人工智能模型安全红蓝对抗机器学习AI 评测如何配置ReiverrTMDB、Jellyfin、Radarr和Sonarr完整集成教程如何配置ReiverrTMDB、Jellyfin、Radarr和Sonarr完整集成教程 Reiverr是一款强大的媒体管理工具能够将Jellyfin、TMKityMinder部署与运维指南从本地开发到生产环境的完整流程KityMinder部署与运维指南从本地开发到生产环境的完整流程 KityMinder是百度开源的强大脑图工具提供直观的项目管理和思维导图功能。本指南将详细前端图形学上一篇为什么选择 React-LLM浏览器端 LLM 方案对比分析下一篇通义千问Qwen3-VL震撼发布2350亿参数开启多模态AI实用化新纪元创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/23 2:11:03 · 阅读 1.2k 生产环境部署free-claude-code：从本地开发到服务器运维完整清单
【免费下载链接】free-claude-codeUse Claude Code for free in the terminal, VSCode extension, or via Discord项目地址https://gitcode.com/gh_mirrors/fre/free-claude-code点击查看免费下载如果你想在服务器上长期免费运行 Claude Codefree-claude-code 是一个轻量级代理方案它把 Claude Code CLI / VSCode 扩展的 Anthropic API 请求转发到 NVIDIA NIM每分钟 40 次免费、OpenRouter 或本地 LM Studio无需 Anthropic API Key。本文给出一份可直接照做的生产部署清单涵盖环境准备、配置、常驻运行、远程接入与日常运维。 部署前置先备齐 4 样东西准备项说明模型提供方 API KeyNVIDIA NIM免费额度最大推荐或 OpenRouterLM Studio 则完全本地、无需 KeyClaude Code官方 CLI 或 VSCode 扩展作为客户端接入代理uv依赖与运行环境管理工具未安装先装已安装执行uv self update升级Python 3.14项目 pyproject.toml 要求3.14缺失时执行uv python install 3.14️ 第一步拉取代码并安装依赖在服务器上执行git clone https://gitcode.com/gh_mirrors/fre/free-claude-code cd free-claude-code cp .env.example .env uv syncuv sync会根据 pyproject.toml 安装 FastAPI、uvicorn、loguru 等全部运行依赖。可选若要在 Discord/Telegram 使用语音消息转写按需追加 extrasuv sync --extra voice_local # 本地 Whisper免费离线 uv sync --extra voice # NVIDIA NIM 转写需要 NIM API Key⚙️ 第二步配置 .env 关键点清单所有配置都集中在这一个文件里完整参数参考 .env.example运行时由 config/settings.py 统一加载校验。生产环境重点关注这几组1. 模型路由必配— 格式固定为provider/model/name前缀必须是nvidia_nim、open_router或lmstudioNVIDIA_NIM_API_KEYnvapi-你的Key # 或 OPENROUTER_API_KEY MODELnvidia_nim/z-ai/glm4.7 # 兜底模型 MODEL_OPUSnvidia_nim/z-ai/glm4.7 # Opus 请求 → 映射模型可省略 MODEL_SONNETnvidia_nim/moonshotai/kimi-k2-thinking MODEL_HAIKUnvidia_nim/stepfun-ai/step-3.5-flash三个MODEL_*可以混合不同提供方实现分级路由。2. 限流与并发生产必调— 对应 config/settings.py变量默认值生产建议PROVIDER_RATE_LIMIT40按提供方免费额度设置NIM 保持 40PROVIDER_RATE_WINDOW60窗口秒数与上一项配套PROVIDER_MAX_CONCURRENCY5多人共用时调低防止并发打满额度3. 超时与优化开关—HTTP_READ_TIMEOUT默认 120s建议按所选模型的实际响应速度上调ENABLE_*系列优化开关默认全开可拦截 5 类无意义的 API 调用以节省配额生产环境保持默认即可。 第三步启动代理并让它常驻运行启动命令来自 server.py 的官方注释推荐uv run uvicorn server:app --host 0.0.0.0 --port 8082 --timeout-graceful-shutdown 5--timeout-graceful-shutdown 5很关键应用 lifespan 会限时 5 秒完成子进程与连接清理见 api/app.py避免停机时挂起。生产环境推荐用 systemd 托管创建/etc/systemd/system/free-cc.service[Unit] Descriptionfree-claude-code proxy Afternetwork.target [Service] WorkingDirectory/opt/free-claude-code ExecStart/root/.local/bin/uv run uvicorn server:app --host 0.0.0.0 --port 8082 --timeout-graceful-shutdown 5 Restartalways RestartSec5 [Install] WantedBymulti-user.target然后systemctl enable --now free-cc即可开机自启 崩溃自动拉起。 第四步终端与 VSCode 远程接入终端在任意能访问服务器的机器上设置两个环境变量即可把地址换成服务器 IPANTHROPIC_AUTH_TOKENfreecc ANTHROPIC_BASE_URLhttp://服务器IP:8082 claudeVSCode 扩展在settings.json中配置claude-code.environmentVariables将ANTHROPIC_BASE_URL指向服务器地址、ANTHROPIC_AUTH_TOKEN设为freecc重载扩展即可。首次若弹出登录页选择 Anthropic Console 授权后忽略购买引导扩展即可正常工作。想临时换模型可用仓库自带的 claude-pick 交互式模型选择器建议安装 fzf免去每次改.env。 第五步可选部署 Discord / Telegram 远程机器人在.env中追加配置即可平台实现位于 messaging/ 目录MESSAGING_PLATFORMdiscord DISCORD_BOT_TOKEN你的Bot令牌 ALLOWED_DISCORD_CHANNELS频道ID1,频道ID2 CLAUDE_WORKSPACE./agent_workspace # 会话与产物存储目录 ALLOWED_DIR/path/to/你的项目目录 # Claude 实际工作的目录要点Discord 需在开发者门户开启 Message Content IntentTelegram 则配置TELEGRAM_BOT_TOKEN和ALLOWED_TELEGRAM_USER_ID。白名单为空 不允许任何渠道这是安全默认值按需填写。会话树持久化在agent_workspace/sessions.json服务重启后自动恢复重启前进行中的任务会标记清理不会残留僵尸进程。 服务器运维日常 8 项检查清单#检查项说明1看日志日志为 JSON 行格式写入server.log带request_id上下文50MB 自动轮转config/logging_config.py可用jq或grep ERROR快速排查2监控 429内置滚动窗口主动限流 429 指数退避providers/rate_limit.py若频繁出现 429调低PROVIDER_RATE_LIMIT3控制并发多人共用时降低PROVIDER_MAX_CONCURRENCY防止免费额度被瞬间打满4备份会话定期备份agent_workspace/目录即历史会话与产物5磁盘空间关注server.log轮转文件与agent_workspace增长按需清理6端口安全代理本身没有认证机制freecc只是占位令牌8082 端口务必用防火墙限制在局域网或可信 IP切勿裸奔公网7优雅重启更新代码后执行systemctl restart free-cclifespan 会限时清理子进程启动时自动恢复会话树8冒烟测试重启后用一条claude -p hi类短请求验证链路再检查server.log是否出现新请求记录️ 常见问题速查症状原因解决启动即报 Model 前缀错误MODEL前缀不是nvidia_nim/open_router/lmstudio按provider/model/name格式修正 .env启动报 NIM Key 缺失WHISPER_DEVICEnvidia_nim但未配NVIDIA_NIM_API_KEY补 Key或改用cpu设备 本地 Whisper消息平台未启动缺少对应依赖discord.py / python-telegram-bot检查uv sync输出日志中会打印 import 错误详情偶发请求失败触达提供方限流查看server.log中 429 记录调小限流参数✅ 小结free-claude-code 的生产部署其实很简单clone → 配.env→ uvicorn 常驻 → 客户端指过去。真正的功夫在运维细节——限流参数、并发上限、端口白名单和日志巡检。按这份清单逐项勾选就能把一个免费 Claude Code 代理稳定地跑在生产服务器上。赞分享【免费下载链接】free-claude-codeUse Claude Code for free in the terminal, VSCode extension, or via Discord项目地址https://gitcode.com/gh_mirrors/fre/free-claude-code点击查看免费下载相关推荐ART完整部署与运维指南从本地开发到Kubeflow生产环境ART完整部署与运维指南从本地开发到Kubeflow生产环境 Adversarial Robustness Toolbox ART 是一个强大的Python库人工智能模型安全红蓝对抗机器学习AI 评测如何配置ReiverrTMDB、Jellyfin、Radarr和Sonarr完整集成教程如何配置ReiverrTMDB、Jellyfin、Radarr和Sonarr完整集成教程 Reiverr是一款强大的媒体管理工具能够将Jellyfin、TMKityMinder部署与运维指南从本地开发到生产环境的完整流程KityMinder部署与运维指南从本地开发到生产环境的完整流程 KityMinder是百度开源的强大脑图工具提供直观的项目管理和思维导图功能。本指南将详细前端图形学上一篇为什么选择 React-LLM浏览器端 LLM 方案对比分析下一篇通义千问Qwen3-VL震撼发布2350亿参数开启多模态AI实用化新纪元创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考