告别海外账号与网络限制稳定直连全球优质大模型限时半价接入中。 点击领取海量免费额度1. 先把目标定清楚让 Claude Code 真正“动手”操作文件Filesystem MCP 是 modelcontextprotocol/servers 仓库里最容易被低估的一个官方服务。它本身不复杂就是把本地目录的读写能力暴露成一组标准工具让 Claude Code 这类 Agent 客户端可以像调用函数一样去 list 目录、read 文件、write 内容。听起来平平无奇但它是理解 MCP 整套机制最省事的入口工具描述、参数 schema、调用回执、权限边界全都能在一个临时目录里跑完。这篇要做的任务很具体让 Claude Code 挂载 Filesystem MCP在临时目录里完成 list、read、write 三个操作并且确认整个 Agent 动作都通过 TaoToken 消耗同一把 Key。也就是说模型推理走 TaoToken工具调用由 Claude Code 本地执行两条链路各司其职但账单入口只有一个。适合谁看已经装好 Claude Code、想第一次把 MCP 跑通的人或者用过 MCP 但没搞清楚“模型请求”和“工具执行”边界的人。全程不需要改系统配置所有动作都在一个临时目录里完成跑完删掉即可。我试过在 macOS 和 Linux 上各跑一遍流程一致Windows 下路径写法略有差异文中会标注。2. 操作步骤从临时目录到三个操作日志2.1 准备临时目录和测试文件先建一个隔离目录避免误操作污染真实项目。下面命令在 macOS/Linux 通用mkdir -p /tmp/mcp-fs-demo cd /tmp/mcp-fs-demo printf hello from filesystem mcp\nsecond line\n note.txt ls -la执行后你应该看到note.txt大小约 40 字节左右。这个文件就是后面 read 操作的目标。write 操作会新建一个文件list 操作则列出整个目录。Windows PowerShell 对应写法New-Item -ItemType Directory -Force -Path $env:TEMP\mcp-fs-demo Set-Location $env:TEMP\mcp-fs-demo hello from filesystem mcpnsecond line | Out-File -Encoding utf8 note.txt Get-ChildItem2.2 确认 Claude Code 已就绪Claude Code 的安装方式以官方文档为准这里只确认它能启动claude --version能打印版本号即可。如果提示找不到命令先按官方指引完成安装再回来。这一步不涉及任何网络配置纯粹是本地可执行性检查。2.3 注册 Filesystem MCPClaude Code 通过claude mcp add注册 MCP server。Filesystem 官方实现是 Node 包modelcontextprotocol/server-filesystem用npx拉起最省事。注册片段如下claude mcp add filesystem-demo \ --scope user \ -- npx -y modelcontextprotocol/server-filesystem /tmp/mcp-fs-demo参数拆解filesystem-demo是给这个 MCP 起的别名后面在会话里引用--scope user表示当前用户全局可用也可以换成--scope project只对当前项目生效--之后是实际启动命令最后一个参数是允许访问的根目录这里就是刚才建的临时目录。注册完检查一下claude mcp list正常会看到filesystem-demo处于 connected 状态。如果显示 failed先单独跑一次npx -y modelcontextprotocol/server-filesystem /tmp/mcp-fs-demo看是不是 Node 版本或网络拉包的问题。2.4 让 Claude Code 执行三个操作启动交互式会话claude然后在会话里依次给出指令。为了让日志清晰建议一条一条来不要合并成一句话。第一条list用 filesystem-demo 列出 /tmp/mcp-fs-demo 下的所有文件第二条read用 filesystem-demo 读取 /tmp/mcp-fs-demo/note.txt 的内容第三条write用 filesystem-demo 在 /tmp/mcp-fs-demo 下新建 output.txt内容写 written by claude code via mcp每条指令执行时Claude Code 会先请求模型判断该调用哪个工具、传什么参数模型返回 tool_use 后本地 MCP server 真正执行文件操作再把结果回传给模型生成自然语言回复。这个来回就是 MCP 的核心循环。2.5 三个操作的预期日志list 的回执大致长这样[filesystem-demo] list_directory path: /tmp/mcp-fs-demo result: note.txtread 的回执[filesystem-demo] read_file path: /tmp/mcp-fs-demo/note.txt result: hello from filesystem mcp second linewrite 的回执[filesystem-demo] write_file path: /tmp/mcp-fs-demo/output.txt result: success最后本地验证cat /tmp/mcp-fs-demo/output.txt应该输出written by claude code via mcp。到这一步三个操作全部闭环。3. TaoToken 接入与配置让 Claude Code 默认走 TaoTokenClaude Code 支持通过环境变量指定 API 供应商。TaoToken 在这里的角色就是 Claude Code 的默认供应商模型推理请求全部发到 TaoToken 的 API 端点工具执行仍然在本地。3.1 拿 Key打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册后在控制台创建 API Key。Key 只在创建时完整显示一次复制后妥善保存。控制台入口在 https://taotoken.net/console Key 管理页在 https://taotoken.net/api-keys 。3.2 配置环境变量Claude Code 读取ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN两个变量。Base URL 填https://taotoken.net/api注意不要带任何查询参数。macOS/Linux 写入 shell 配置export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKEN你的 TaoToken KeyWindows PowerShell$env:ANTHROPIC_BASE_URL https://taotoken.net/api $env:ANTHROPIC_AUTH_TOKEN 你的 TaoToken Key写入后重开终端或者source ~/.zshrc让配置生效。验证echo $ANTHROPIC_BASE_URL应输出https://taotoken.net/api。3.3 确认 Claude Code 走的是 TaoToken重新启动claude随便问一句“你好”然后回到 TaoToken 控制台的用量页面应该能看到刚才这次请求的记录。如果用量没变化说明请求没走 TaoToken检查环境变量是否在当前 shell 生效以及是否有其他配置文件覆盖了这两个变量。关于模型选择Claude Code 默认会请求 Claude 系列模型TaoToken 侧支持的具体模型和版本以官网文档为准https://taotoken.net/doc 。不同模型的计费差异较大跑 MCP 这种短交互任务用轻量模型就够没必要上最贵的。3.4 同一把 Key 覆盖整个 Agent 动作这里要区分两件事模型推理请求走 TaoToken消耗的是 TaoToken 的额度文件读写由本地 MCP server 执行不产生任何 API 消耗。所以“同一把 Key”指的是整个会话里所有模型请求都用这一个 Key而不是说文件操作也要计费。理解这一点后面看账单就不会困惑。如果你还想把 Claude Code 的 coding-plan 能力也接进来可以参考 https://taotoken.net/coding-plan 配置方式类似都是围绕 Base URL 和 Key 展开。4. 可验证结果与失败分支4.1 可复现产出跑完后你手里应该有三样东西一份 MCP 注册片段就是 2.3 那条claude mcp add命令、三份操作日志list/read/write 的回执、以及本地output.txt文件。这三样合起来就是完整的可复现证据链。验证清单检查项预期结果验证方式MCP 已注册connectedclaude mcp listlist 可用列出 note.txt会话日志read 可用返回两行内容会话日志write 可用output.txt 生成cat output.txt走 TaoToken控制台有用量用量页面4.2 常见失败分支第一种MCP 显示 failed。多半是npx拉包失败或 Node 版本过低。单独执行启动命令看报错Node 建议 18 以上。第二种工具调用被拒绝。Filesystem MCP 只允许访问注册时指定的根目录如果你让它读/etc/passwd会被明确拒绝。这是设计如此不是 bug。第三种模型请求 401。Key 错误或环境变量没生效。重新echo两个变量确认注意 Base URL 结尾不要多斜杠。第四种模型请求 404。Base URL 写错了必须是https://taotoken.net/api不要带/v1之类的后缀具体以文档为准。第五种会话里模型不调用工具只是用自然语言描述。这通常是提示词不够明确把“列出目录”改成“用 filesystem-demo 工具列出目录”强制它走工具路径。5. 限制、成本与模型选择Filesystem MCP 的权限模型是白名单目录注册时给几个根目录就只能访问这几个子目录自动包含。这个设计对 Agent 场景很关键你不可能让一个自动化流程拥有整个文件系统的读写权。成本方面跑完这篇的三个操作模型请求大概三到五次每次输入输出都不长。具体单价以官网为准不同模型差异明显。如果只是验证流程用便宜模型完全够如果要让 Agent 做复杂的多步文件操作再考虑更强的模型。模型选择上Claude Code 默认请求的模型在 TaoToken 侧有对应映射实际可用列表和版本以 https://taotoken.net/doc 为准。我的经验是MCP 工具调用对模型的“指令遵循”能力要求高于“知识量”选一个工具调用稳定的模型比选一个参数大的模型更实用。最后提醒一点临时目录跑完记得清理rm -rf /tmp/mcp-fs-demo即可。MCP 注册如果不想留着用claude mcp remove filesystem-demo移除。整个流程从建目录到验证完成熟练后确实能在十分钟内走完第一次跑可能会在环境变量和 Node 版本上多花几分钟。 告别海外账号与网络限制稳定直连全球优质大模型限时半价接入中。 点击领取海量免费额度