企业官网建设流程全解析

如果你想在服务器上长期免费运行 Claude Code，free-claude-code 是一个轻量级代理方案：它把 Claude Code CLI / VSCode 扩展的 Anthropic API 请求转发到 NVIDIA NIM（每分钟 40 次免费）、OpenRouter 或本地 LM Studio，无需 Anthropic API Key。本文给出一份可直接照做的生产部署清单，涵盖环境准备、配置、常驻运行、远程接入与日常运维。

📋 部署前置：先备齐 4 样东西

🖥️ 第一步：拉取代码并安装依赖

在服务器上执行：

git clone https://gitcode.com/gh_mirrors/fre/free-claude-code cd free-claude-code cp .env.example .env uv sync

• uv sync会根据 pyproject.toml 安装 FastAPI、uvicorn、loguru 等全部运行依赖。
• 可选：若要在 Discord/Telegram 使用语音消息转写，按需追加 extras：

uv 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或lmstudio：

NVIDIA_NIM_API_KEY="nvapi-你的Key" # 或 OPENROUTER_API_KEY MODEL="nvidia_nim/z-ai/glm4.7" # 兜底模型 MODEL_OPUS="nvidia_nim/z-ai/glm4.7" # Opus 请求 → 映射模型（可省略） MODEL_SONNET="nvidia_nim/moonshotai/kimi-k2-thinking" MODEL_HAIKU="nvidia_nim/stepfun-ai/step-3.5-flash"

三个MODEL_*可以混合不同提供方，实现分级路由。

2. 限流与并发（生产必调）— 对应 config/settings.py：

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] Description=free-claude-code proxy After=network.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 Restart=always RestartSec=5 [Install] WantedBy=multi-user.target

然后systemctl enable --now free-cc，即可开机自启 + 崩溃自动拉起。

🔌 第四步：终端与 VSCode 远程接入

终端：在任意能访问服务器的机器上设置两个环境变量即可，把地址换成服务器 IP：

ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://服务器IP:8082" claude

VSCode 扩展：在settings.json中配置claude-code.environmentVariables，将ANTHROPIC_BASE_URL指向服务器地址、ANTHROPIC_AUTH_TOKEN设为freecc，重载扩展即可。首次若弹出登录页，选择 Anthropic Console 授权后忽略购买引导，扩展即可正常工作。

想临时换模型，可用仓库自带的 claude-pick 交互式模型选择器（建议安装 fzf），免去每次改.env。

🤖 第五步（可选）：部署 Discord / Telegram 远程机器人

在.env中追加配置即可，平台实现位于 messaging/ 目录：

MESSAGING_PLATFORM="discord" DISCORD_BOT_TOKEN="你的Bot令牌" ALLOWED_DISCORD_CHANNELS="频道ID1,频道ID2" CLAUDE_WORKSPACE="./agent_workspace" # 会话与产物存储目录 ALLOWED_DIR="/path/to/你的项目目录" # Claude 实际工作的目录

要点：

• Discord 需在开发者门户开启 Message Content Intent；Telegram 则配置TELEGRAM_BOT_TOKEN和ALLOWED_TELEGRAM_USER_ID。
• 白名单为空 = 不允许任何渠道，这是安全默认值，按需填写。
• 会话树持久化在agent_workspace/sessions.json，服务重启后自动恢复；重启前进行中的任务会标记清理，不会残留僵尸进程。

🩺 服务器运维：日常 8 项检查清单

🛠️ 常见问题速查

✅ 小结

free-claude-code 的生产部署其实很简单：clone → 配.env→ uvicorn 常驻 → 客户端指过去。真正的功夫在运维细节——限流参数、并发上限、端口白名单和日志巡检。按这份清单逐项勾选，就能把一个免费 Claude Code 代理稳定地跑在生产服务器上。