★ FEATURED ARTICLE 1. 为什么我要在本地跑一个 AI AgentAI Agent 这个词这两年出现频率很高但真正动手搭过的人其实不多。简单说大语言模型像一本会说话的百科全书你问它答而 Agent 更像一个能自己动手的数字员工——它能理解目标、拆解步骤、调用工具、读写文件、执行命令最后把一件多步骤的事做完。Claude Code 就是这样一个跑在终端里的自主编程 Agent它能读取整个代码库、编辑文件、跑命令、处理 Git 工作流把自然语言指令变成真实的代码改动。那为什么还要配 GLM4.7 而不是默认模型原因很实际默认模型在国内网络环境下调用不稳定而且成本不低。GLM4.7 在代码理解和工具调用上的表现已经足够撑起日常 Agent 任务配合一个稳定的 API 接入层整个链路会顺畅很多。这篇就聚焦从零搭建的完整链路——环境准备、Claude Code 安装、GLM4.7 模型接入配置最后交付一份可复制的 settings.json 骨架和连通性验证动作让你在本地跑通第一个 Agent 任务。适合刚接触 Agent、想在终端里拥有一个能干活的编程助手的开发者。2. 前置准备TaoToken 接入层与 API KeyClaude Code 本身是一个客户端它需要一个能响应 Anthropic 协议的后端。默认它连的是官方服务但我们可以把请求指向兼容的接入层再让这个接入层去调用 GLM4.7。TaoToken 在这里扮演的就是这个接入层角色——它提供统一的 API 入口把 Claude Code 发出的 Anthropic 格式请求转发到 GLM 系列模型你只需要在配置里改几个环境变量。先拿到 API Key。打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进入控制台在 API Keys 页面创建一个新 Key。这个 Key 就是后面 settings.json 里要填的凭证创建后立刻复制保存页面刷新后就看不到了。创建 Key 的入口在这里https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你还没想好具体用哪个模型可以先到模型对话页面感受一下 GLM4.7 的输出风格https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注意API Key 只显示一次建议创建后直接写进配置文件不要留在聊天记录或截图里。如果怀疑泄露回控制台吊销重建即可。3. 安装 Claude Code 并配置 GLM4.73.1 安装 Claude CodeClaude Code 支持多种安装方式macOS 上最省事的是 Homebrew跨平台通用的是 npm。我实测下来 npm 方式最稳版本也好管理。# 方式一npm 全局安装推荐 npm install -g anthropic-ai/claude-code # 方式二HomebrewmacOS brew install claude-code # 方式三官方脚本 curl -fsSL https://claude.ai/install.sh | bash安装完成后验证一下claude --version # 输出类似2.1.84 (Claude Code)如果提示claude: command not found说明安装目录没进 PATH。npm 全局安装的包一般在~/.npm-global/bin或/usr/local/bin脚本安装的会在~/.local/bin。把它加进 shell 配置echo export PATH$HOME/.local/bin:$PATH ~/.zshrc source ~/.zshrc3.2 配置 GLM4.7 模型Claude Code 的模型配置集中在~/.claude/settings.json。这个文件如果不存在就手动创建。核心是把 Anthropic 的三个模型档位Haiku/Sonnet/Opus映射到 GLM 系列同时把 API 请求指向 TaoToken 的接入地址。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_DEFAULT_HAIKU_MODEL: glm-4.5-air, ANTHROPIC_DEFAULT_SONNET_MODEL: glm-4.7, ANTHROPIC_DEFAULT_OPUS_MODEL: glm-4.7 } }几个参数的作用对照参数作用建议值ANTHROPIC_BASE_URLAPI 请求入口https://taotoken.net/apiANTHROPIC_AUTH_TOKEN鉴权凭证控制台创建的 KeyANTHROPIC_DEFAULT_HAIKU_MODEL轻量任务模型glm-4.5-airANTHROPIC_DEFAULT_SONNET_MODEL主力模型glm-4.7ANTHROPIC_DEFAULT_OPUS_MODEL复杂推理模型glm-4.7Haiku 档位负责快速的小任务比如补全、简单问答用 glm-4.5-air 省钱又快Sonnet 和 Opus 档位是主力统一指向 glm-4.7保证代码理解和工具调用的质量。提示如果你更习惯用环境变量而不是配置文件也可以在 shell 里 export 这几个变量效果一样。但 settings.json 的好处是跟着项目走换机器时复制一份就行。3.3 重启并切换模型配置写完后重启 Claude Code输入/model命令就能看到当前可用的模型列表里出现了 GLM 系列。选中 glm-4.7 作为默认模型即可。claude # 进入交互界面后输入 /model # 列表里选择 glm-4.74. 验证连通性跑通第一个 Agent 任务配置对不对跑一个真实任务就知道。我一般用一个最小的文件操作任务来验证让 Agent 读一个文件、改一行内容、再确认改动。先准备一个测试文件mkdir -p ~/agent-test cd ~/agent-test echo def greet(name): hello.py echo return Hello, name hello.py然后在~/agent-test目录下启动 Claude Codecd ~/agent-test claude在交互界面里输入指令读取 hello.py把 greet 函数改成支持默认参数 nameWorld然后运行一个测试确认输出正确。如果配置正确你会看到 Agent 依次执行读取文件、编辑内容、运行 python 验证。预期输出类似已修改 hello.py def greet(nameWorld): return Hello, name 运行测试python -c from hello import greet; print(greet()) 输出Hello, World看到这个结果说明 Claude Code 已经通过 TaoToken 接入层成功调用了 GLM4.7并且工具调用链路是通的。如果 Agent 只回复文字但没有实际改文件多半是模型档位没映射对回去检查 settings.json 里的 SONNET/OPUS 是否都指向了 glm-4.7。再验证一下 API 层是否正常响应可以直接用 curl 打一次curl https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的TaoToken密钥 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: glm-4.7, max_tokens: 100, messages: [{role: user, content: 用一句话说明什么是 AI Agent}] }返回里有正常的content字段就说明接入层工作正常。这一步能帮你把「客户端配置问题」和「API 服务问题」区分开。5. 本篇常见错误排查配置过程中最容易踩的几个坑我按出现频率排一下。报错一401 Unauthorized或invalid api key九成是 Key 填错或过期。检查 settings.json 里ANTHROPIC_AUTH_TOKEN的值注意不要带多余空格或引号嵌套错误。如果 Key 是在别的项目里用过的回控制台确认它还有效。报错二model not found或模型列表为空说明模型名写错了。GLM4.7 的正确标识是glm-4.7不是glm4.7也不是GLM-4.7。大小写和连字符都要对。改完重启 Claude Code 再试。报错三Agent 只聊天不动手模型能回复但不会调用工具通常是档位映射问题。Claude Code 判断是否调用工具依赖 SONNET/OPUS 档位的模型能力如果这两个还指向默认的 Claude 模型而网络又不通就会退化成纯文本回复。确认三个档位都正确映射。报错四ECONNREFUSED或连接超时检查ANTHROPIC_BASE_URL是否写成了https://taotoken.net/api不要漏掉/api路径也不要多加斜杠。另外确认本机网络能正常访问该地址。报错五修改 settings.json 后不生效Claude Code 只在启动时读取配置。改完文件必须完全退出再重新claude启动热重载不生效。如果排查完还是不通可以到接入文档页面核对最新的参数说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。文档里会同步接口地址和鉴权头的最新要求。6. 下一步把 Agent 用起来跑通第一个任务之后真正的价值在于把它嵌进日常开发流。几个我常用的方向让它处理 Git 工作流比如「把当前改动整理成一个 commit消息写清楚改了什么」让它修 lint 错误直接说「跑一遍 lint把报错都修了」或者让它读一个陌生模块用自然语言解释调用关系。如果你打算长期用 Agent 做编码任务建议了解一下 Coding Plan它在调用额度和模型调度上更适合高频场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。日常想快速验证某个模型的表现模型对话页面更轻量https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。需要管理多个项目的 Key 时控制台的 API Keys 页面可以按项目分建https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后分享一个实用技巧把~/.claude/settings.json纳入你的 dotfiles 仓库管理换机器时一条软链接就恢复全部配置。Agent 的配置本身就是生产力资产别让它只躺在本地。
阅读完成 · 觉得有帮助？
