企业官网建设流程全解析

1. 为什么要在本地跑 Claude Code 接 GLM

Claude 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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 注册账号，然后在控制台里创建 API Key。控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，Key 管理页在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。创建后把 Key 复制下来，形如sk-xxxx或带前缀的字符串，后面配置里会用到。

API 的基础地址是 https://taotoken.net/api ，注意这个地址不带任何查询参数，配置时直接填这个即可。如果你需要查接入文档，可以看 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有各模型对应的端点说明和参数格式。

注意：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 | bash

Windows PowerShell 用：

irm https://claude.ai/install.ps1 | iex

Windows CMD 用：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

装完之后，你的用户目录下会出现这些关键路径，理解它们对后面排障很重要：

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.json，Windows 是用户目录/.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.json，macOS/Linux 在~/.claude.json，Windows 在用户目录/.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_URL="https://taotoken.net/api"

Windows 在系统环境变量里新增这两项，或者用 PowerShell 临时设置：

$env:ANTHROPIC_AUTH_TOKEN="你的_TaoToken_API_Key" $env:ANTHROPIC_BASE_URL="https://taotoken.net/api"

改完记得重开终端或source一下配置文件。

接下来进入一个你的代码工作目录，执行claude启动交互模式。第一次启动如果弹出「Do you want to use this API key」，选 Yes。然后你会看到欢迎界面，说明配置生效了。

验证调用是否真的成功，最直接的方式是让它做一件小事。在交互模式里输入：

解释一下当前目录下的 package.json 是做什么的

如果它能读取文件并给出合理回答，说明请求已经打到 GLM 上并且返回正常。你也可以用一次性查询模式快速验证：

claude -p "用一句话说明这个项目是干什么的"

这条命令跑完就退出，适合脚本化验证。如果返回了内容，连通性就没问题。想进一步确认模型对话效果，可以到 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite 里用同一个 Key 试一下 GLM 的对话，对比两边输出是否一致，能帮你判断是配置问题还是模型本身的问题。

6. Claude 常用命令速查清单

配置跑通之后，日常用得最多的就是这些命令。CLI 启动类：

交互模式里的斜杠命令：

快捷键方面，Ctrl+C取消当前生成，Ctrl+R搜索命令历史，Tab切换思考过程显示，Shift+Tab在普通、自动接受、计划三种模式间循环，连按两次Esc打开回退菜单。

如果你打算长期用 Claude Code 做编码或跑 Agent 任务，可以关注一下 Coding Plan，地址是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，它针对高频编码场景做了额度优化，比按量计费更适合天天用的开发者。

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_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 核对一遍。

第四个是请求超时。长文件分析或大范围重构时容易触发，把API_TIMEOUT_MS调大，同时用/compact压缩上下文，减少单次请求的 token 量。

第五个是改了配置不生效。Claude Code 启动时读一次配置，改完要退出重进。如果系统环境变量和settings.json里的值冲突，以环境变量为准，所以两边保持一致最省心。

第六个是 Windows 下路径带空格导致脚本失败。安装脚本对路径敏感，建议用户名不要带空格，或者手动把.claude目录放到无空格路径下再配置。

排查时有个通用思路：先用claude -p "test"做最小验证，如果这条都失败，问题一定在配置层；如果这条成功但交互模式里某些操作失败，那多半是模型能力或上下文长度的问题，跟接入无关。