首页
/
行业洞察
/
正文
INDUSTRY INSIGHT · 深度
随时随地远程编程:free-claude-code Discord机器人搭建完整教程
📅 2026/10/23 2:08:11
✍️ 爱科研究院
👁 阅读 3,247
【免费下载链接】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 代理工具它把 Claude Code 的 API 请求转发到 NVIDIA NIM、OpenRouter 或本地 LM Studio无需 Anthropic 官方 API 密钥。除了本地终端使用它最亮眼的功能之一就是内置的Discord 机器人你只需要一条消息就能让 Claude Code 在服务器上自主完成编码任务并实时推送思考过程、工具调用和运行结果。本文将带你从零完成搭建创建 Discord Bot、配置环境变量、启动服务最后用手机或电脑远程下发生成代码的任务。它能做什么为什么值得搭搭好之后free-claude-code 的 Discord 机器人提供这些能力远程编程在 Discord 频道发一条任务消息Claude Code 就会在服务器上自主探索代码库、读写文件、运行命令树状会话线程回复某条消息即可分支出新对话互不干扰支持多条任务并发实时进度推送思考 token、工具调用、命令输出都会以流式消息回传到频道会话持久化服务器重启后之前的会话记录依然保留语音消息直接发语音条会被转写成文字当任务处理需安装额外依赖⚡控制命令/stop取消任务、/clear清理会话、/stats查看统计准备工作安装 free-claude-code 与依赖开始前需要准备三样东西一台长期开机的电脑或服务器Windows / Linux 均可uv 包管理器和 Claude Code一个模型提供商的 API KeyNVIDIA NIM免费额度 40 次请求/分钟推荐新手使用OpenRouter数百个免费/付费模型可选LM Studio完全本地运行无需 API Key克隆仓库并初始化git clone https://gitcode.com/gh_mirrors/fre/free-claude-code cd free-claude-code cp .env.example .env 所有配置都写在.env文件中下面几步只需要改这一个文件。第一步创建 Discord Bot 并获取 Token这一步在 Discord 开发者后台完成全程免费打开 Discord Developer Portal登录你的账号点击New Application给应用起个名字比如freecc-bot进入Bot页面点击Reset Token复制生成的 Token——这是机器人的身份凭证只会出现一次妥善保管在 Bot 页面的Privileged Gateway Intents中务必开启Message Content Intent否则机器人读不到你发的消息内容接下来邀请机器人加入你的服务器进入OAuth2 → URL GeneratorScopes 勾选botBot Permissions 勾选Read Messages / Send Messages / Manage Messages / Read Message History复制生成的链接用浏览器打开选择要加入的服务器完成邀请第二步配置 .env 接入 Discord编辑.env文件加入以下配置# —— 模型提供商以 NVIDIA NIM 为例—— NVIDIA_NIM_API_KEYnvapi-你的key MODELnvidia_nim/stepfun-ai/step-3.5-flash # —— Discord 机器人 —— MESSAGING_PLATFORMdiscord DISCORD_BOT_TOKEN你的bot_token ALLOWED_DISCORD_CHANNELS123456789,987654321其中ALLOWED_DISCORD_CHANNELS是允许使用机器人的频道 ID 白名单多个频道用逗号分隔。如何获取频道 IDDiscord 默认不显示频道 ID需要先开启开发者模式打开 Discord 的Settings设置→ Advanced高级开启Developer Mode回到频道右键点击频道名称选择Copy ID把复制到的数字填入ALLOWED_DISCORD_CHANNELS⚠️ 这个白名单是安全防线留空意味着没有任何频道可以使用机器人。只开放自己信任的私有频道即可。再配置 Claude Code 的工作目录# 机器人操作的工作区目录 CLAUDE_WORKSPACE./agent_workspace # 允许 agent 访问的目录按需填写你的项目路径 ALLOWED_DIRC:/Users/yourname/projectsCLAUDE_WORKSPACE是机器人启动 Claude Code 会话的默认目录首次运行会自动创建。第三步启动服务在项目根目录执行uv run uvicorn server:app --host 0.0.0.0 --port 8082服务启动后会同时拉起两个角色代理服务器端口 8082把 Claude Code 的 Anthropic 格式请求转发给你的模型提供商Discord 机器人连接 Discord 网关等待你的任务消息看到日志中 Discord 平台成功连接的提示后就可以开始使用了。第四步在 Discord 里下达第一个任务进入白名单频道直接发消息帮我用 Python 写一个脚本批量重命名当前目录下所有 jpg 图片为 序号.jpg几秒内你会看到机器人开始回传 Claude Code 的实时进度——工具调用、文件操作、命令输出都会以消息流的形式出现直到任务完成给出总结。常用控制命令命令作用/stop直接发送取消所有任务回复某条消息只取消那条任务/clear直接发送重置全部会话回复某条消息清理该分支往下/stats查看当前 CLI 会话与消息树的统计信息小技巧回复消息分支出新会话对机器人的某条回复使用「回复」功能发新任务就会在消息树上分叉出一条独立对话线源码中的树状消息处理见 messaging/trees/不同任务的上下文互不串扰非常适合同时跑多个编码需求。进阶发送语音消息描述需求在 Telegram 或 Discord 直接发语音条机器人会调用 Whisper 将其转写成文字再处理。需要先安装可选依赖# 本地 Whisper免费、离线、支持 CUDA uv sync --extra voice_local转写相关配置与实现分别位于 config/settings.py 和 messaging/transcription.py。常见问题排查机器人不回复消息检查Message Content Intent是否已开启确认消息发在ALLOWED_DISCORD_CHANNELS白名单频道内查看终端日志确认机器人是否成功连上 Discord收到 429 限流报错项目内置了滚动窗口限流与指数退避见 providers/rate_limit.py可以通过调低PROVIDER_RATE_LIMIT默认 40 次/分钟窗口让请求更平滑。Discord 消息超过 2000 字符被截断这是 Discord 平台本身的单条消息上限实现在 messaging/platforms/discord.py长输出会自动分段发送。想用 Telegram 替代 Discord只需把MESSAGING_PLATFORM改为telegram并配置TELEGRAM_BOT_TOKEN和ALLOWED_TELEGRAM_USER_ID即可其余流程完全一致。写在最后至此你已经在手机上拥有了一个随叫随到的 AI 编程助手出门在外打开 Discord 发一句任务描述家里的服务器就开始写代码进度实时推送到聊天框。核心流程回顾克隆 free-claude-code配置模型提供商 API Key在 Discord Developer Portal 创建 Bot 并开启 Message Content Intent在.env中填入DISCORD_BOT_TOKEN与频道白名单uv run uvicorn server:app --host 0.0.0.0 --port 8082启动在白名单频道发消息远程编程即刻开始完整的参数说明包括语音转写、限流、超时等 30 余项配置可以参考项目 README 中的 Configuration 表格或 config/settings.py 中的定义。赞分享【免费下载链接】free-claude-codeUse Claude Code for free in the terminal, VSCode extension, or via Discord项目地址https://gitcode.com/gh_mirrors/fre/free-claude-code点击查看免费下载相关推荐终极指南如何快速搭建Gulf of Mexico远程开发环境随时随地编码终极指南如何快速搭建Gulf of Mexico远程开发环境随时随地编码 Gulf of Mexico原名DreamBerd是一款创新的编程语言项目被GitHub_Trending/om/OM1 Unitree Go2远程控制随时随地操控你的机器人GitHub_Trending/om/OM1 Unitree Go2远程控制随时随地操控你的机器人 你是否曾想过在办公室就能指挥家里的Unitree Go2机人工智能AI Agent多模态具身智能大模型机器人MCP ClientsRAG语音本地部署Sunshine终极教程3步搭建个人云游戏服务器随时随地畅玩PC大作Sunshine终极教程3步搭建个人云游戏服务器随时随地畅玩PC大作 Sunshine是一款完全免费开源的 自托管游戏串流服务器 专为Moonlight客音视频后端上一篇Automa循环功能终极指南轻松处理重复性任务的5大技巧下一篇提升hand-gesture-recognition-mediapipe识别准确率的7个实用技巧创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
📌 标签:
工业官网
设计趋势
AI 建站
SEO
获取完整报告 →
RELATED ARTICLES
推荐阅读
2026/10/23 2:08:11
5分钟装好Caelestia:从一条curl命令到成品桌面的快速开始指南
2026/10/23 2:03:10
8分钟上手Path of Building PoE2:流放之路2构建模拟器,DPS与换装取舍别再盲猜
2026/10/23 2:03:10
QtHttpServer安装配置:SSL证书、CMake与ctest避坑
2026/10/23 3:03:16
财务人未来怎么走?真正值得考虑的出路,就这3条
2026/10/23 3:03:16
动能公式E=½mv²:从物理原理到工程应用避坑指南
2026/10/23 3:03:16
2026年小程序十大开发公司怎么看:榜单要回到交付清单
2026/10/23 3:03:16
Win11 0x80070035网络路径错误排查与SMB共享修复指南
2026/10/23 3:03:16
5 张图带你理解 RocketMQ 延时消息机制
2026/10/23 2:58:15
2026品牌战略咨询公司榜单:代表机构的实战案例看增长路径是否复用到各自企业
2026/10/23 0:02:44
Verilog实现FPGA密码锁:矩阵键盘与状态机设计实战
2026/10/23 0:02:44
数据服务监控运维实战:从指标体系到告警治理与故障排查
2026/10/23 0:02:44
FreeRTOS任务通知实战详解:内核原理、API与避坑指南
2026/10/23 0:52:23
OpenResearch实战:Claude Code、Codex、OpenCode、Cursor 工作流搭建与故障排查
2026/10/22 17:15:21
知识管理核弹:用Obsidian构建第二大脑的工程化方案(TaoToken 统一 Key 接入版)
2026/10/23 0:52:11
金融AI落地指南:从调研报告到技术选型与工程实践
2026/10/22 5:06:15
我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频
2026/10/22 2:07:18
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证
2026/10/21 19:01:08
2026 大模型集体涨价:用 Python 做企业 Token 成本测算与选型避坑(附配置)