想体验 AI Coding 做实用工具，却总卡在 “环境配置” —— 这篇指南专为新手小白设计，分系统拆解七牛云 AI Coding 的安装步骤，跟着做就能快速搞定。

本次搭配的七牛云 AI 推理服务，自带多重核心优势：直连服务不卡顿、低成本高性价比、多模型自由选。配置完成后，还能直接对接头条推文《AI Coding 入门：小白 10 分钟做成天气查询工具》，马上用实际案例验证成果，让 AI Coding 从 “听说” 变成 “能用”。

系统快速索引

  • Windows 用户：需管理员身份、图形化配置环境变量

  • Mac 用户：直接执行命令，无需额外权限

  • Linux 用户：操作逻辑同 Mac，直接执行命令即可 

前置环境检查

确认 Node.js 版本

CC 依赖 Node.js 运行，执行以下命令验证版本：  

若输出 

 及以上，直接进入下一步；  

若版本过低或无输出，需前往 Node.js 官网 下载对应系统安装包（Windows 选 .exe，Mac 选 .pkg，Linux 选 .tar.gz），安装后重新验证。 

获取七牛云专属配置：所有系统通用步骤

1. 登录七牛云控制台

访问 七牛云官网，登录已有账号（无账号需先注册，支持手机号/邮箱）。  

2. 获取 API Key

在控制台左侧导航栏，点击 「AI 大模型推理」进入产品服务页面，找到并点击「API Key」选项：

生成或复制 API Key，保存到记事本，待后续配置使用。

七牛云模型广场顶尖大模型齐聚：聚合 DeepSeek、Qwen、GLM 等系列顶级模型，简单脚本开发选 Qwen3-Turbo（成本＜0.1 美元/100 万 Tokens）快速模型，复杂项目用 DeepSeek-V3.2/GLM-4.6（平衡速度与质量）推理模型，支持函数工具调用、驱动各种 Agent 应用等。

安装 AI Coding 工具：分系统操作

1. 通用基础命令

2. 分系统操作说明

Windows 用户

右键「命令提示符」或「PowerShell」→ 选择「以管理员身份运行」打开终端，执行：

Mac / Linux 用户

直接执行基础命令即可，无需 sudo 或额外权限：  

3. 通用安装验证

执行以下命令：

若输出版本信息，如：

说明安装成功

配置七牛云环境变量：分系统操作

1. 环境变量说明

2. 分系统配置方法

关键提醒：ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 只能配置一个，同时设置会导致鉴权失败！

Windows 用户

打开「环境变量」界面：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」；  

添加用户变量：  

  • 在「用户变量」栏点击「新建」，二选一添加鉴权变量（ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN）；

  • 依次添加其他必选变量（ANTHROPIC_BASE_URL 及所有模型变量），按表格填写「变量名」和「变量值」；  

生效：点击「确定」关闭所有窗口，重新打开终端（无需管理员身份），配置即可生效。  

Mac / Linux 用户

终端写入配置文件：  

立即生效：执行命令加载配置文件  

基础功能验证：所有系统通用

1. 启动 AI Coding 工具交互模式

执行命令：

成功标志：终端显示 

 提示符，进入交互界面。  

2. 发送测试指令

在交互界面输入：

成功标志：10 秒内返回带注释的 Python 代码，说明能正常调用七牛云服务：  

分系统避坑指南：常见问题与解决方案

Windows 用户常见问题

安装时提示「EPERM: operation not permitted」原因：未用管理员身份打开终端解决：右键终端 →「以管理员身份运行」，重新执行安装命令（可加 --force 参数）。  

环境变量配置后，echo 输出为空原因：永久配置未重启终端，临时配置换了终端解决：永久配置需关闭所有终端重新打开；临时配置需在同一终端执行验证命令。  

Mac / Linux 用户常见问题

执行 claude 命令提示「command not found」原因：npm 安装目录未加入环境变量（或未配置用户级目录时路径未识别）解决：执行 

（若配置了用户级目录），或直接重新打开终端即可。  

所有系统通用问题

示「API Key 无效」或「认证失败」可能原因：  

  • 同时配置了 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN（互斥变量冲突）；

  • API Key 复制错误（多空格/少字符）；

  • 无七牛云 AI 推理服务权限。解决：

  • 检查环境变量，确保只保留一个鉴权变量；

  • 重新复制七牛云 API Key（确保无多余字符）。

调用模型提示「model not found」原因：模型变量配置与七牛云模型广场标识不一致解决：前往 七牛云 AI 推理模型广场 查看模型「标识」，确保 ANTHROPIC_MODEL 等变量值与之一致（如 x-ai/grok-code-fast-1 不能省略路径）。  

提示「模型配置缺失」原因：未配置 ANTHROPIC_DEFAULT_HAIKU_MODEL 或 ANTHROPIC_SMALL_FAST_MODEL解决：按本文步骤补全所有模型变量配置，重启终端后重试。