Free Claude Code Discord机器人配置教程：手机一句话指挥AI编程（5步完成完整指南）-编程实验室

Free Claude Code Discord机器人配置教程：手机一句话指挥AI编程（5步完成完整指南）

【免费下载链接】free-claude-codeUse Claude Code, Codex, Pi, and OpenCode and more for free (1.3B+ free tokens) from your terminal, app, IDE, or phone like OpenClaw (voice supported + ToS friendly)项目地址: https://gitcode.com/GitHub_Trending/fr/free-claude-code

Free Claude Code是一个开源的免费 AI 编程代理网关，让你免费使用 Claude Code、Codex、OpenCode 等 9 款编程 AI，每月提供 13 亿+ 免费 token。它的 Discord 机器人功能更是亮点：配置完成后，你在手机上发一句话，AI 就能在你的电脑上帮你写代码、改文件、跑命令，出门在外也能远程指挥整个编程工作流。本文带你 5 步完成 Discord 机器人配置，全程只需在网页上填几个框，几乎不写代码。

先认识一下 Free Claude Code

简单说，Free Claude Code（下文简称 FCC）就是一个"模型中转站 + 编程代理管理器"：

🆓50 个 ToS 友好的服务商，一个可搜索的界面里切换免费、订阅和本地模型，不冒账号风险
🤖9 款编程 AI 通用：Claude Code、Codex、Pi、OpenCode、Cline 等都能接上 FCC 的模型目录
📱终端、桌面、IDE、手机全支持：Discord 和 Telegram 是最方便的"手机入口"
🔊语音消息进、代码出：发一条语音，本地 Whisper 或 NVIDIA NIM 自动转文字再执行
🛟模型自动降级：主模型挂了会自动切换到你配置的备用模型，不用重开对话

想深入了解项目结构可以看 ARCHITECTURE.md 和 README.md。

第 1 步：安装并启动 FCC 服务

在终端中克隆仓库后运行一键安装脚本 scripts/install.sh（Windows 用 scripts/install.ps1），按提示选择至少一个编程代理即可。

启动服务后 FCC 会自动打开 Admin 管理界面：

fcc-server

💡 启动后保持终端开着；Windows 和 macOS 也可以从桌面或托盘图标启动，并随时打开 Admin 页面。

第 2 步：在 Admin UI 配置模型服务商

Discord 机器人再强，也得先有模型可用。打开 Admin 页面左侧的Providers，填写你服务商的 API Key，点Validate验证后Apply保存：

推荐新手从免费门槛低的服务商入手，比如 NVIDIA NIM（只需一个 API Key，默认模型就能直接用）。配置字段定义都在 src/free_claude_code/config/admin/manifest.py 里，界面每个输入框都一一对应。

配置时建议顺手加一个Fallback Models（备用模型列表），服务商抽风时自动切换，手机上体验会稳定很多。

第 3 步：在 Discord 开发者门户创建机器人

这是唯一要跳出 Admin 页面的环节，只需做两件事：

登录 Discord 开发者门户，创建一个新应用并添加Bot
在 Bot 设置里复制Token；同时打开Message Content Intent（必须开，否则机器人读不到你的消息）

邀请机器人进服务器时，勾选以下权限：

权限	用途
Read Messages / Send Messages	收发消息
View Message History	维护会话上下文
Manage Messages	让`/clear`命令能删除你的历史提问

第 4 步：在 Admin UI 填入 Discord 配置

回到 Admin 页面，点开左侧Messaging标签页，按下面填：

配置项	怎么填
Messaging Platform	选`discord`
Discord Bot Token	粘贴第 3 步复制的 Token
Allowed Discord Channels	填你允许使用机器人的频道 ID（安全白名单）
Allowed Directory	填一个绝对路径，这是 AI 被允许操作代码的目录

⚠️Allowed Directory 是安全关键：机器人只在这个目录内读写文件，建议专门建一个项目目录（如D:/projects），不要把整个磁盘交给它。

填完点右下角Validate→Apply，如提示需要则重启服务即可。Discord 平台的连接逻辑在 src/free_claude_code/messaging/platforms/discord.py，配置校验规则见 src/free_claude_code/config/settings.py。

第 5 步：手机发一句话，开码！

在允许的 Discord 频道里直接 @机器人或直接发消息，比如：

"帮我在项目里写一个 FastAPI 的待办事项接口，并加上单元测试"

FCC 会调用你配置的编程代理执行任务，并把流式结果回帖到频道。内置的几个实用命令（实现在 src/free_claude_code/messaging/command_dispatcher.py）：

命令	作用
`/stats`	查看当前会话状态
`/stop`（独立发送）	取消所有正在执行的任务
`/stop`（回复某条消息）	只取消那一条请求，队列中其他任务继续
`/clear`（独立发送）	重置全部 FCC 状态并清掉该频道所有跟踪消息
`/clear`（回复某条消息）	只删除指定消息及其回复子树

进阶：语音消息指挥 AI

在Messaging → Voice区域勾选Voice Notes，选择 Whisper 设备（cpu/cuda/nvidia_nim）和模型即可。之后手机上直接发语音条："把登录页的按钮颜色改成蓝色"，本地 Whisper 会自动转成文字交给编程代理执行——通勤路上就能改完代码。

相关源码可以对照 src/free_claude_code/messaging/voice.py 和 src/free_claude_code/messaging/transcription.py。

常见问题速查

机器人不回消息？先确认 Message Content Intent 已开启、Token 填对、你所在的频道在Allowed Discord Channels白名单里
换了模型没生效？应用设置后按提示重启fcc-server
想换 Telegram？同一页面把平台改成telegram，填 Bot Token 和你的用户 ID 即可，一套配置页面两个平台通吃