前言
作为一名开发者，你是否也遇到过这些困扰：
- 想用 Claude Code 这种强大的 AI 编程助手，但官方账号动不动封号
- 网络环境不稳定，梯子时好时坏，影响开发心情
- 国外的 AI 服务价格昂贵，而且支付不方便
最近国产开源模型迎来了质变时刻！智谱 GLM 4.7、MiniMax M2.1、Kimi K2 等模型的代码能力已经突破可用阈值。这意味着我们可以用百分之一的价格，在国内网络环境下，享受接近 Claude 官方模型的开发体验。
本文将详细介绍如何在**飞牛NAS（基于Debian 12）**上搭建完整的 Claude Code + 智谱 AI 开发环境。
什么是 Claude Code？
Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，虽然名字叫 "Code"，但功能远不止写代码。
核心能力
- 代码开发：生成、调试、重构代码
- 数据分析：处理 Excel、CSV，生成报表
- 文档处理：格式转换、内容提取
- 系统管理：自动化运维任务
- Web 开发：前后端全栈开发
- 多媒体处理：音视频合成、转码
为什么选择命令行版本？
相比 Web 界面，CLI 版本有独特优势：
- 直接访问文件系统：读写本地文件，无需上传下载
- 执行系统命令：真正掌控你的电脑/NAS
- 无限上下文记忆：项目级知识库
- 完全本地化：数据不经过第三方服务器
环境准备
硬件要求
- 设备：飞牛NAS（或其他基于 Debian 的 NAS 系统）
- 架构：x86_64
- 内存：建议 4GB 以上
- 网络：能访问智谱 API（无需梯子）
软件要求
飞牛NAS 基于 Debian 12，需要 Node.js 20+ 环境。
# 检查系统版本
cat /etc/os-release
# 检查 Node.js（需要 20+）
node --version
# 检查 npm
npm --version
# 检查 git
git --version
``
如果缺少 Node.js 或版本过低，需要先安装或升级。
---
## 第一步：安装 Claude Code
### 1.1 配置 npm 国内镜像
```bash
# 为当前用户配置
npm config set registry https://registry.npmmirror.com
# 为 root 用户配置（后续 sudo 安装需要）
echo '你的sudo密码' | sudo -S npm config set registry https://registry.npmmirror.com
``
### 1.2 安装 Claude Code CLI
```bash
# 全局安装 Claude Code
sudo npm install -g @anthropic-ai/claude-code
``
安装过程约 10-30 秒。
### 1.3 验证安装
```bash
# 查看版本
claude --version
``
输出示例：2.0.76 (Claude Code)
如果显示版本号，说明安装成功！
---
## 第二步：获取智谱 AI API Key
### 2.1 注册智谱账号
访问 [智谱开放平台](https://open.bigmodel.cn/)，点击右上角"注册/登录"。
### 2.2 创建 API Key
1. 进入个人中心 → [API Keys](https://bigmodel.cn/usercenter/proj-mgmt/apikeys)
2. 点击"创建新的 API Key"
3. 复制保存 Key（格式类似：83448ef9xxxxx.xxxxxx）
### 2.3 购买 Coding 套餐（强烈推荐）
**为什么买套餐？**
- 按量付费容易欠费
- 套餐可以尽情使用，不用担心额度
- 价格非常亲民
**推荐套餐**：
- **Coding Lite（季卡）**：54 元/3个月
- **Coding Pro（月卡）**：根据需求选择
购买链接：https://www.bigmodel.cn/glm-coding
**性价比**：相比 Claude 官方每月 20 美元（约 140 元），智谱套餐只要 1/10 的价格。
---
## 第三步：配置 Claude Code 使用智谱模型（重要）
### 3.1 使用配置工具（推荐方式）
**⚠️ 重要提示**：手动配置文件容易出错，强烈建议使用智谱官方提供的配置工具。
```bash
# 运行配置工具
npx @z_ai/coding-helper
``
按照工具提示：
1. 输入你的智谱 API Key
2. 选择使用 GLM 模型
3. 工具会自动生成正确的配置文件
配置完成后，工具菜单中可以直接启动 Claude Code 进行测试。
### 3.2 配置文件说明
配置工具会在 `~/.claude/settings.json` 生成正确的配置：
```json
{
"apiKey": "你的API_Key",
"baseURL": "https://open.bigmodel.cn/api/anthropic",
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的API_Key",
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic"
}
}
``
**⚠️ 注意**：不要手动修改配置文件，使用配置工具更安全可靠。
---
## 第四步：创建工作目录并启动
### 4.1 创建工作目录
```bash
# 创建主工作目录
mkdir -p /vol2/1000/docker/claude-code
# 进入目录
cd /vol2/1000/docker/claude-code
``
### 4.2 首次启动 Claude Code
```bash
claude
``
### 4.3 首次启动配置
启动后会提示：Do you want to use this directory?
**输入**：Yes 或 Always
接着会询问权限级别，选择 **Yes (full access)** 以获得完整功能。
### 4.4 测试对话
试试第一个命令：
你好！请帮我创建一个测试文件 hello.txt
``
如果文件创建成功，恭喜你，已经完全配置好了！
参考资源
以上由AI修改完成！
