【免费下载链接】free-claude-codeUse Claude Code for free in the terminal, VSCode extension, or via Discord项目地址https://gitcode.com/gh_mirrors/fre/free-claude-code点击查看免费下载使用 free-claude-code 免费运行 Claude Code绕不开一个现实问题你的 API 密钥是否安全这个轻量级代理Proxy将 Claude Code 的 Anthropic API 请求转发到 NVIDIA NIM、OpenRouter 或 LM Studio需要你在.env文件中配置NVIDIA_NIM_API_KEY、OPENROUTER_API_KEY等密钥。本文结合源码带你完整梳理 free-claude-code 的 6 大安全机制与 4 类部署风险帮你把「免费跑 AI 编程助手」这件事做安全。密钥存在哪里先搞清楚密钥流转路径所有敏感凭证都通过环境变量注入统一由 config/settings.py 中的 Pydantic Settings 加载读取.env文件见.env.example密钥类型环境变量说明NVIDIA NIMNVIDIA_NIM_API_KEYNIM 提供商免费额度 40 req/minOpenRouterOPENROUTER_API_KEY数百个模型含免费模型Discord BotDISCORD_BOT_TOKEN消息平台机器人令牌Telegram BotTELEGRAM_BOT_TOKEN消息平台机器人令牌好消息项目的 .gitignore 已将.env、agent_workspace、server.log全部排除密钥文件不会被提交到版本库。安全机制解析项目内置了哪些防线1. 白名单访问控制最关键的防线这是 Bot 模式的第一道闸门Telegram只有ALLOWED_TELEGRAM_USER_ID中指定的用户 ID 能发消息其他用户会被直接静默拒绝并记录告警日志实现见 messaging/platforms/telegram.pyDiscord只有ALLOWED_DISCORD_CHANNELS中列出的频道才处理消息列表为空 全部拒绝实现见 messaging/platforms/discord.py 注意Telegram 的校验是「配置了才检查」如果不填ALLOWED_TELEGRAM_USER_ID任何人都能驱动你的 Bot——这是最大的配置陷阱。2. 工作目录沙箱ALLOWED_DIRBot 驱动 Claude CLI 时代理会把 CLI 子进程的cwd锁定在ALLOWED_DIR指定的工作区见 api/app.py通过--add-dir参数向 Claude Code 显式声明可访问目录见 cli/session.py这样代理的文件操作被限定在你指定的项目根目录内配合会话数据集中存放在CLAUDE_WORKSPACE默认./agent_workspace已被 gitignore 排除。3. 子代理失控拦截Subagent ControlClaude Code 的 Task 工具会派生后台子代理容易「跑飞」烧光配额。free-claude-code 在响应流中拦截 Task 工具调用强制改写run_in_backgroundFalse见 providers/openai_compat.py杜绝失控子代理。4. 三层限流保护配额providers/rate_limit.py 实现了完整的双向限流主动滚动窗口严格保证任意 60 秒内最多 40 个请求PROVIDER_RATE_LIMIT/PROVIDER_RATE_WINDOW绝不突发被动 429 熔断一旦遇到限流错误全局指数退避重试含随机抖动并发上限PROVIDER_MAX_CONCURRENCY默认 5限制同时打开的流数量消息平台侧另有独立滑动窗口限流messaging/limiter.py防止高频消息打爆上游。5. 进程生命周期兜底每个 Claude CLI 子进程 PID 都会注册到 cli/process_registry.py注册atexit钩子即使服务被CtrlC中断导致清理逻辑没跑完也会尽力杀掉自己派生的进程不会误杀无关系统进程避免遗留的 AI 进程在后台继续执行命令。6. 全量可追溯日志config/logging_config.py 将所有日志以 JSON Lines 写入server.log50MB 自动轮转并拦截未授权访问尝试日志中出现Unauthorized access attempt from ...。日志文件本身在.gitignore中不会泄露到仓库。部署风险清单这 4 个坑必须避风险一代理端口对全网暴露 ⚠️服务默认监听0.0.0.0:8082见 config/settings.py。代理端口本身没有鉴权——ANTHROPIC_AUTH_TOKENfreecc只是占位符。后果是同一局域网内的人都能免费把你的 NIM 配额当公共 API 用。✅对策本机使用改为--host 127.0.0.1多人共用场景建议加反向代理Nginx Basic Auth / 令牌校验再转发到 8082。风险二--dangerously-skip-permissions是双刃剑Bot 模式下 CLI 以--dangerously-skip-permissions启动见 cli/session.py意味着 AI 可免确认执行任意命令。此时安全性完全依赖第 1、2 节两道防线白名单 ALLOWED_DIR沙箱。✅对策务必配置ALLOWED_DIR指向专用工作目录切勿指向你的家目录或包含密钥、凭证的项目目录只信任的白名单用户才允许接入。风险三.env文件保管不当.env是唯一同时存放 NIM 密钥、Bot 令牌、HF Token 的文件。常见事故截图外传、打包备份时带上、放进共享网盘。✅对策保持文件权限最小化定期在 build.nvidia.com/settings/api-keys 轮换 NIM 密钥若密钥泄露第一时间重置对应平台密钥Bot 令牌泄露则立即在 Developer Portal 重新生成风险四忽略 LM Studio 本地方案的隐私优势对隐私要求高的场景MODELlmstudio/...走纯本地推理localhost:1234代码与上下文零出网、无需任何 API 密钥——这是从根源上消除密钥泄露风险的方案。安全部署检查清单部署前逐项打勾5 分钟搞定ALLOWED_TELEGRAM_USER_ID/ALLOWED_DISCORD_CHANNELS已配置且非空Discord 空值 拒绝全部ALLOWED_DIR指向专用工作目录不含敏感文件代理监听地址仅本机用请改127.0.0.1或加鉴权反向代理.env未提交 git、未截图外传、权限最小化确认PROVIDER_RATE_LIMIT40/PROVIDER_MAX_CONCURRENCY5未随意调大关注server.log中的Unauthorized告警记录总结free-claude-code 的安全设计思路可以概括为「默认不信任外部配额绝不失控」——白名单拒绝一切未授权用户、目录沙箱圈定 AI 操作范围、三层限流锁死配额消耗、进程兜底清理防止后台残留。真正的风险集中在部署层面代理端口无鉴权 --dangerously-skip-permissions免确认执行。只要按上文清单配置好监听地址、白名单与沙箱目录免费使用 Claude Code 完全可以做到安全可控。想体验完整功能可从项目仓库获取代码git clone https://gitcode.com/gh_mirrors/fre/free-claude-code然后阅读 README.md 快速上手。赞分享【免费下载链接】free-claude-codeUse Claude Code for free in the terminal, VSCode extension, or via Discord项目地址https://gitcode.com/gh_mirrors/fre/free-claude-code点击查看免费下载相关推荐API Key 存本地真的安全吗T3 Code 密钥安全实测API Key 存本地真的安全吗T3 Code 密钥安全实测 把 Claude、Codex、Cursor 等 AI 编程 Agent 的 API Key 统一AI Agent代码智能体人工智能后端前端移动开发桌面应用Symphony-Coord 安全与部署指南Risk Guard 风险守卫、API 密钥安全与边缘设备落地Symphony Coord 安全与部署指南Risk Guard 风险守卫、API 密钥安全与边缘设备落地 Symphony Coord 是一个去中心化的多智Claude Code Router安全配置API密钥保护与访问控制Claude Code Router安全配置API密钥保护与访问控制 ?️ 安全配置核心原则 Claude Code Router作为AI模型路由中间件处理人工智能LLM 网关API网关AI 应用后端前端桌面应用上一篇League Akari英雄联盟玩家的终极本地化智能辅助工具下一篇Natron Read 节点完全指南素材导入、时序控制、解码与色彩管理创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考