Claude Code 手动配置

大约 8 分钟

Claude Code 手动配置

接入结论

接口地址（ANTHROPIC_BASE_URL）：https://www.yuzhixiaolongxia.com（不带 /v1）
认证字段：ANTHROPIC_AUTH_TOKEN
令牌分组：Claude 家族令牌分组
推荐模型 ID：claude-opus-4-7（最新旗舰）
模型 ID 查询：模型广场

程序员专属福利：异常断线不扣费

平台对 Claude Code 实现了 异常断线不扣费 策略——长任务跑到一半被网络掐断，已发出但没收完的部分 不会计费，可以放心跑大块代码生成、长文档分析。

这篇文档适合谁

适合：会基础命令行、想用 AI 写代码 / 改代码 / 解释代码的程序员或开发者
不适合：完全没碰过终端的小白——建议你走一键安装包

Claude Code 适合做什么

在终端里跟 AI 对话，让它帮你写代码、修 bug、解释代码
直接读取本地项目文件，让 AI 理解项目上下文后再回答
长任务、长上下文（支持 /compact 压缩对话）

前置条件

继续之前，请先完成环境检查。Node.js 版本 ≥ 20 是硬性要求，低了跑不起来。

极简步骤一览

装好 Claude Code（一行 npm install）
在 ~/.claude/ 下创建 settings.json
把接口地址 + 令牌粘进去
重开终端，跑 claude 验证

下面是每一步的详细操作。

第一步：确认 Claude Code 已经安装

打开终端，输入：

claude --version

有版本号显示：已经装了，跳到第二步。

显示 command not found：还没装，继续看下面。

安装 Claude Code

npm install -g @anthropic-ai/claude-code@latest

等它跑完（1–3 分钟）。

装完必须重开终端

关掉这个终端窗口，重新打开一个新的，再输一遍 claude --version 确认有版本号。

安装失败了？

Windows 权限错误：右键开始菜单 → 选"终端（管理员）"，重新运行命令
Mac 出现 EACCES：在命令前加 sudo：sudo npm install -g @anthropic-ai/claude-code@latest

第二步：找到配置文件位置

Claude Code 的配置保存在 settings.json 里，藏在隐藏文件夹 .claude 中。

配置文件的完整路径

系统	路径
Windows	`C:\Users\你的用户名\.claude\settings.json`
Mac / Linux	`~/.claude/settings.json`

不知道自己 Windows 用户名是什么？

PowerShell 里输入：

echo $env:USERNAME

显示隐藏文件夹

.claude 是隐藏文件夹（点开头的），系统默认不显示。

Windows：文件资源管理器 → 查看 → 勾选"隐藏的项目"
Mac：在 Finder 里按 Command + Shift + . 切换显示

`.claude` 文件夹不存在？

手动创建一个：

Windows（PowerShell）

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude"

Mac / Linux

mkdir -p ~/.claude

第三步：创建或编辑 settings.json

推荐用 VS Code 或记事本编辑。

方法一：用 VS Code 打开（推荐）

Windows

code "$env:USERPROFILE\.claude\settings.json"

Mac / Linux

code ~/.claude/settings.json

如果文件不存在，VS Code 会自动创建一个新的空文件给你编辑。

方法二：用记事本打开（Windows）

按 Win + R，输入 notepad，打开记事本
文件 → 打开
在地址栏输入 %USERPROFILE%\.claude，按回车
看到 settings.json 就双击；没有就在"文件名"里输入 settings.json，选择"所有文件"类型，点"打开"

方法三：用终端编辑器（Mac / Linux）

nano ~/.claude/settings.json

Ctrl + X → Y → 回车保存。

第四步：填写配置内容

把文件原内容 全部清空，然后把下面这段完整复制粘贴进去：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.yuzhixiaolongxia.com",
    "ANTHROPIC_AUTH_TOKEN": "你的Claude令牌填这里",
    "ANTHROPIC_MODEL": "claude-opus-4-7",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1"
  }
}

重点：接口地址不带 /v1

Claude Code 的接口地址 必须是 https://www.yuzhixiaolongxia.com，末尾不要加 /v1。这是 Claude Code 与其他工具最大的差异——多了 /v1 会直接 404。

各字段含义

字段	作用
`ANTHROPIC_BASE_URL`	平台地址，不要改
`ANTHROPIC_AUTH_TOKEN`	你的令牌，必须换成你自己的
`ANTHROPIC_MODEL`	用哪个模型，推荐 `claude-opus-4-7`
后三行	关闭一些不必要的功能，直接复制用就行

第五步：把你的令牌填进去

令牌在哪里找？

新用户不用自己创建

平台为新用户预设了 Claude 家族令牌分组，登录后到令牌页面直接复制就能用。

如果你想自定义令牌（设置额度、有效期），参考：创建令牌教程

必须选对分组

Claude Code 只能用 "Claude 家族令牌分组" 的令牌。Codex / Gemini 分组的令牌在这里用不了，会直接 401。

令牌长这个样子：

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

怎么填进去？

找到 settings.json 里的：

"ANTHROPIC_AUTH_TOKEN": "你的Claude令牌填这里",

把 你的Claude令牌填这里 替换成你复制的令牌，引号要保留，只替换里面的内容：

"ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",

令牌就是你的密码

不要把它分享给别人、发到群里截图、发朋友圈。

第六步：保存文件

VS Code：Ctrl + S（Windows）或 Command + S（Mac）
记事本：文件 → 保存
nano：Ctrl + X → Y → 回车

第七步：测试是否配置成功

必须重开终端

关掉当前所有终端窗口（这步很重要，旧终端会用旧的环境变量），然后 重新打开一个新的终端。

在新终端里输入：

claude

按回车。

成功了：出现一个交互界面，提示你输入问题或命令（比如显示 > 或 Human: 之类的提示符）。

你可以输入一句话测试，比如"你好"，如果 Claude 回复了，完全搞定。

想换其他模型

settings.json 里的 ANTHROPIC_MODEL 改成别的模型 ID 就行，可用模型 ID 全在模型广场。

要退出 Claude Code，按 Ctrl + C 或输入 /exit 回车。

常见错误与处理

错误一：401 Unauthorized

Error: 401 Unauthorized

原因：令牌输错了、过期了、或选错了分组。

怎么修：

重新去令牌页面检查令牌是否有效
确认用的是 Claude 家族令牌分组 的令牌
重新打开 settings.json，检查令牌有没有写错（特别注意：不要多空格，不要少引号）
保存后重开终端再试

错误二：连接失败 / 网络超时

Error: connect ECONNREFUSED
Error: Failed to fetch

原因：网络问题，或 ANTHROPIC_BASE_URL 填错了。

怎么修：

浏览器打开 https://www.yuzhixiaolongxia.com 确认网络通畅
检查 settings.json 里的 ANTHROPIC_BASE_URL，确认不带 /v1，不多斜杠，不少字母
关闭代理软件后重试

错误三：`command not found: claude`

原因：Claude Code 没装好，或终端没有重新打开。

怎么修：

先确认关闭了旧终端，打开了新终端
还是不行就重新运行：npm install -g @anthropic-ai/claude-code@latest
装完再重开终端

错误四：配置改了但没效果

原因：终端进程还在用旧配置。

怎么修：完全关掉终端（包括所有标签页），重新打开一个全新的终端窗口。

错误五：JSON 格式错误

SyntaxError: Unexpected token

原因：settings.json 的格式写错了——少了引号、多了逗号、括号没对齐。

怎么修：

把里面所有内容删掉
重新完整地复制粘贴本页第四步的配置模板
只替换令牌部分，其他地方不要动
保存

错误六：403 Forbidden

Error: 403 Forbidden

原因：账户权限问题——最常见的是余额不足、令牌分组权限不够、或账户异常。

怎么修：

登录平台控制台，检查账户余额是否充足
确认令牌绑定的是 Claude 家族令牌分组
如果余额和分组都没问题，联系平台客服

错误七：413 上下文太长了

Error: 413 Request Entity Too Large

原因：这一轮对话累积的上下文已经太长，超过了单次请求的限制。

怎么修：在 Claude Code 里输入：

/compact

这会把历史对话压缩成摘要，释放上下文空间，之后可以继续对话。下次别让单个任务拖太长。

错误八：529 服务繁忙

Error: 529 Overloaded

原因：服务器压力过大，临时性的，不是你配置问题。

怎么修：

等 1–2 分钟后重试
如果你是新账号或刚开始大量调用，逐步增加请求频率，别一上来就高频调用

可选：在 VS Code 插件里使用

除了终端，你也可以通过 VS Code 里的扩展来使用 Claude 接口。

Roo Code / Kilo Code（VS Code 扩展）

这两个扩展是专门针对代码的 AI 助手，可以直接接入平台的 Claude 接口：

在 VS Code 扩展商店里安装 Roo Code 或 Kilo Code
打开扩展设置，找到 API 供应商 或 Provider
供应商类型按扩展自身的"Claude 兼容"选项配置（不是绑定上游账号，只是协议格式）
填写你的令牌
Base URL 填：https://www.yuzhixiaolongxia.com（不带 /v1）
保存即可

VS Code 官方 Claude Code 插件强制登录问题

某些版本的官方 Claude Code 插件会强制要求登录。绕过方法：

新建文件 ~/.claude/config.json（注意是 config.json，不是 settings.json），内容：

{
  "primaryApiKey": "fox"
}

保存后重启 VS Code，插件就不会再强制登录，走的是 settings.json 里配好的接口。

常见坑速查（base URL / 模型 ID / 分组）

坑	现象	解决
接口地址加了 `/v1`	404 或连不上	Claude Code 地址不带 /v1
令牌选错分组	401 Unauthorized	必须用 Claude 家族令牌分组
改完配置没重开终端	配置不生效	完全关掉所有终端，重新打开
令牌粘贴时多了空格	401 Unauthorized	仔细检查令牌前后是否有空格
`settings.json` 缺逗号或括号	JSON SyntaxError	重新复制本页模板，只改令牌
模型 ID 拼错	model not found	去模型广场直接复制

配置完成

你已经搞定 Claude Code 的手动配置，可以用 claude 命令启动，开始 AI 辅助编程之旅。

上一步：环境检查｜下一步：Codex CLI 手动配置