1. 为什么要在本地跑 Claude Code 接 GLMClaude Code 是 Anthropic 推出的终端 AI 编程助手它跟普通聊天窗口最大的区别是它能直接读写你本地的代码文件、执行命令、跑测试、提交 Git相当于一个坐在你终端里的结对程序员。但官方默认走 Anthropic 的账号体系对国内开发者来说注册、计费、网络这几关都不太顺。好在 Claude Code 支持通过环境变量把请求转发到兼容 Anthropic 协议的第三方端点这就给了我们接入国产大模型的空间。GLM 系列智谱的 glm-4.5-air、glm-4.6v 等在代码补全、长上下文理解上表现不错价格也比官方友好很适合作为 Claude Code 的后端模型。这篇面向的是想在本地一次性跑通 AI 编程助手的开发者你会拿到一份可直接复制的settings.json配置模版、一份 Claude 常用命令速查清单以及通过统一 Key/API 通道完成接入和连通性验证的完整流程。目标很明确——装完就能用用起来能确认调用真的成功而不是配了半天发现请求根本没发出去。我试过在 macOS 和 Windows 两套环境各跑一遍踩过的坑主要集中在配置文件路径、环境变量优先级、以及模型名映射这三块下面会逐个说清楚。2. 前置准备TaoToken 通道与 Key 获取Claude Code 要接 GLM本质上需要三样东西一个能访问的 Anthropic 兼容端点、一个可用的 API Key、以及正确的模型名映射。TaoToken 在这里扮演的是统一 Key/API 通道的角色——你不用为每个模型单独维护一套鉴权和端点通过一个 Key 就能在多个模型之间切换配置层只改ANTHROPIC_BASE_URL和模型名即可。先到官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号然后在控制台里创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建后把 Key 复制下来形如sk-xxxx或带前缀的字符串后面配置里会用到。API 的基础地址是 https://taotoken.net/api 注意这个地址不带任何查询参数配置时直接填这个即可。如果你需要查接入文档可以看 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各模型对应的端点说明和参数格式。注意Key 只显示一次创建后立刻保存到本地密码管理器或临时文件里别直接贴在聊天记录或公开仓库中。环境方面Claude Code 依赖 Node.js 和 Git。Node 建议 18 以上Git 用于它执行提交操作。这两个装好之后剩下的就是配置文件的事了。3. 安装 Claude Code 与目录结构说明Claude Code 的安装方式按平台分几种官方脚本会把它装到用户目录下的.claude文件夹。macOS、Linux、WSL 用curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell 用irm https://claude.ai/install.ps1 | iexWindows CMD 用curl -fsSL https://claude.ai/install.cmd -o install.cmd install.cmd del install.cmd装完之后你的用户目录下会出现这些关键路径理解它们对后面排障很重要路径作用~/.claude/Claude Code 主目录~/.claude/settings.json核心配置文件env 字段在这里~/.claude.json项目记忆与引导状态~/.claude/projects/会话历史~/.claude/skills/Agent skills 目录Windows 下把~换成C:\Users\你的用户名\。比如配置文件就是C:\Users\你的用户名\.claude\settings.json。这里有个容易忽略的点settings.json和.claude.json是两个不同层级的文件前者在.claude目录里后者在用户根目录下。很多人只改了其中一个结果启动时一直卡在引导页或者报鉴权失败就是因为hasCompletedOnboarding没设。4. 可复制的 settings.json 配置模版配置分两个文件缺一不可。先看settings.json这是核心env 字段决定了 Claude Code 往哪里发请求、用什么 Key、用哪个模型。macOS/Linux 路径是~/.claude/settings.jsonWindows 是用户目录/.claude/settings.json。内容如下{ env: { ANTHROPIC_AUTH_TOKEN: 你的_TaoToken_API_Key, ANTHROPIC_BASE_URL: https://taotoken.net/api, API_TIMEOUT_MS: 3000000, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1, ANTHROPIC_DEFAULT_HAIKU_MODEL: glm-4.5-air, ANTHROPIC_DEFAULT_SONNET_MODEL: glm-4.5-air, ANTHROPIC_DEFAULT_OPUS_MODEL: glm-4.6v }, autoUpdatesChannel: latest, model: opus[1m] }几个字段逐个解释。ANTHROPIC_AUTH_TOKEN填你刚才在控制台创建的 Key。ANTHROPIC_BASE_URL填 TaoToken 的 API 地址注意不要带末尾斜杠也不要加查询参数。API_TIMEOUT_MS设大一点长上下文任务容易超时3000000 毫秒约等于 50 分钟够用。CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC设为 1 可以关掉一些非必要的遥测请求减少干扰。模型映射这三个字段是关键Claude Code 内部会按 Haiku、Sonnet、Opus 三档去请求模型我们把它们分别映射到 GLM 的具体型号。glm-4.5-air适合日常补全和轻量任务glm-4.6v适合复杂推理和长上下文。你可以按自己的套餐和需求调整但模型名必须和通道支持的名称一致写错了会直接报模型不存在。第二个文件是.claude.jsonmacOS/Linux 在~/.claude.jsonWindows 在用户目录/.claude.json。最少只需要一个字段{ hasCompletedOnboarding: true }这个字段的作用是跳过首次启动的引导流程。如果不设Claude Code 启动时会尝试走官方登录而我们用的是自定义端点就会卡住。设成 true 之后它直接进入可用状态。提示如果你之前已经跑过 Claude Code.claude.json里可能已经有一堆字段不用删只要确保hasCompletedOnboarding是 true 即可。5. 环境变量与启动验证配置文件写好后还有一步是环境变量。虽然settings.json里的 env 字段已经能生效但有些 shell 环境下 Claude Code 会优先读系统环境变量所以建议在 shell 配置里也同步一份避免行为不一致。macOS/Linux 编辑~/.bash_profile或~/.zshrc加上export ANTHROPIC_AUTH_TOKEN你的_TaoToken_API_Key export ANTHROPIC_BASE_URLhttps://taotoken.net/apiWindows 在系统环境变量里新增这两项或者用 PowerShell 临时设置$env:ANTHROPIC_AUTH_TOKEN你的_TaoToken_API_Key $env:ANTHROPIC_BASE_URLhttps://taotoken.net/api改完记得重开终端或source一下配置文件。接下来进入一个你的代码工作目录执行claude启动交互模式。第一次启动如果弹出「Do you want to use this API key」选 Yes。然后你会看到欢迎界面说明配置生效了。验证调用是否真的成功最直接的方式是让它做一件小事。在交互模式里输入解释一下当前目录下的 package.json 是做什么的如果它能读取文件并给出合理回答说明请求已经打到 GLM 上并且返回正常。你也可以用一次性查询模式快速验证claude -p 用一句话说明这个项目是干什么的这条命令跑完就退出适合脚本化验证。如果返回了内容连通性就没问题。想进一步确认模型对话效果可以到 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 里用同一个 Key 试一下 GLM 的对话对比两边输出是否一致能帮你判断是配置问题还是模型本身的问题。6. Claude 常用命令速查清单配置跑通之后日常用得最多的就是这些命令。CLI 启动类命令功能claude启动交互模式claude task运行一次性任务claude commit创建 Git 提交claude -c恢复最近会话claude -r恢复之前的对话claude -p query一次性查询后退出交互模式里的斜杠命令命令功能/init项目初始化生成 CLAUDE.md/compact压缩上下文省 token/clear完全清除对话历史/model切换模型/cost查看 token 用量/context查看上下文窗口用量/diff查看最近更改/memory编辑 CLAUDE.md/resume继续过去的会话/plan计划模式只读/rewind撤销对话或代码快捷键方面CtrlC取消当前生成CtrlR搜索命令历史Tab切换思考过程显示ShiftTab在普通、自动接受、计划三种模式间循环连按两次Esc打开回退菜单。如果你打算长期用 Claude Code 做编码或跑 Agent 任务可以关注一下 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它针对高频编码场景做了额度优化比按量计费更适合天天用的开发者。7. 本篇常见错误排查配置过程中最容易撞上的几个问题我按出现频率排一下。第一个是启动后一直提示登录或卡在引导页。九成是.claude.json里的hasCompletedOnboarding没设成 true或者文件放错了位置。确认它在用户根目录下不是.claude目录里。第二个是报鉴权失败 401。检查ANTHROPIC_AUTH_TOKEN是否填了完整的 Key有没有多余空格或换行。另外确认ANTHROPIC_BASE_URL是https://taotoken.net/api不要带末尾斜杠也不要误填成官网首页地址。第三个是模型不存在或 404。这是模型名映射写错了。ANTHROPIC_DEFAULT_HAIKU_MODEL等字段的值必须是通道实际支持的模型名大小写和连字符都要对。不确定的话去接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 核对一遍。第四个是请求超时。长文件分析或大范围重构时容易触发把API_TIMEOUT_MS调大同时用/compact压缩上下文减少单次请求的 token 量。第五个是改了配置不生效。Claude Code 启动时读一次配置改完要退出重进。如果系统环境变量和settings.json里的值冲突以环境变量为准所以两边保持一致最省心。第六个是 Windows 下路径带空格导致脚本失败。安装脚本对路径敏感建议用户名不要带空格或者手动把.claude目录放到无空格路径下再配置。排查时有个通用思路先用claude -p test做最小验证如果这条都失败问题一定在配置层如果这条成功但交互模式里某些操作失败那多半是模型能力或上下文长度的问题跟接入无关。