【免费下载链接】free-claude-code
Use Claude Code for free in the terminal, VSCode extension, or via Discord
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 Key：
- NVIDIA 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 Generator
- Scopes 勾选
bot；Bot Permissions 勾选Read Messages / Send Messages / Manage Messages / Read Message History - 复制生成的链接，用浏览器打开，选择要加入的服务器，完成邀请
第二步：配置 .env 接入 Discord
编辑.env文件，加入以下配置：
# —— 模型提供商（以 NVIDIA NIM 为例）—— NVIDIA_NIM_API_KEY="nvapi-你的key" MODEL="nvidia_nim/stepfun-ai/step-3.5-flash" # —— Discord 机器人 —— MESSAGING_PLATFORM="discord" DISCORD_BOT_TOKEN="你的bot_token" ALLOWED_DISCORD_CHANNELS="123456789,987654321"其中ALLOWED_DISCORD_CHANNELS是允许使用机器人的频道 ID 白名单，多个频道用逗号分隔。
如何获取频道 ID？
Discord 默认不显示频道 ID，需要先开启开发者模式：
- 打开 Discord 的Settings（设置）→ Advanced（高级），开启Developer Mode
- 回到频道，右键点击频道名称，选择Copy ID
- 把复制到的数字填入
ALLOWED_DISCORD_CHANNELS
⚠️ 这个白名单是安全防线：留空意味着没有任何频道可以使用机器人。只开放自己信任的私有频道即可。
再配置 Claude Code 的工作目录：
# 机器人操作的工作区目录 CLAUDE_WORKSPACE="./agent_workspace" # 允许 agent 访问的目录（按需填写你的项目路径） ALLOWED_DIR="C:/Users/yourname/projects"CLAUDE_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-code
Use Claude Code for free in the terminal, VSCode extension, or via Discord
相关推荐
终极指南：如何快速搭建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客
音视频后端
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
