☰
AI 编程助手天花板!Claude Code 使用完整教程(Windows/Mac/Linux 三大系统手把手配置教学)
2026/10/24 12:34:04 网站建设 项目流程

前言

Claude Code CLI 是 Anthropic 官方推出的命令行 AI 编程助手,相比 VS Code 插件版,CLI 版支持 Skill 等更多高级功能。本文介绍如何在 Windows、Mac、Linux 三个系统上通过国内中转平台配置使用。


一、环境准备

检查 Node.js 是否已安装

三个系统都在终端输入:

node --version

如果显示版本号说明已安装,可跳过此步。

如未安装,去 https://nodejs.org 下载安装 LTS 版本(点获取Node.js,根据自己电脑的型号,点获取Windows安装程序,安装时保持默认选项一路next到最后就行)。

⚠️Windows 额外要求:必须先安装 Git Bash,否则 Claude Code 无法运行。下载地址:https://git-scm.com/downloads/win,Git Bash详细安装方法参考上一篇文章“在VS Code中配置Claude Code:保姆级部署教程”。https://blog.csdn.net/GuPusheng/article/details/159609181?fromshare=blogdetail&sharetype=blogdetail&sharerId=159609181&sharerefer=PC&sharesource=GuPusheng&sharefrom=from_link


二、安装 Claude Code CLI

Mac / Linux

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

输入后需要输入开机密码(输入时屏幕不显示任何字符,输完回车即可)。

Windows

在 Git Bash 或 PowerShell 中输入(不需要 sudo):

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

安装过程可能需要等待 1 分钟左右,看到added X packages或changed X packages说明安装成功。


三、获取 API Key

由于没有海外信用卡,需要使用国内中转平台。

本文使用Lino API(https://linoapi.com.cn/register?aff=EwUj)。

  1. 注册账号并充值(支持支付宝/微信)
  2. 进入控制台 → API令牌 → 添加令牌(按如图所示进行配置),状态设为启用,复制sk-开头的 Key
  3. 在模型广场确认可用的 Claude 模型名称,推荐选Haiku 系列(最便宜)


四、配置环境变量

Mac

在终端执行(注意⚠️“你的sk-key”要替换为你在API平台创建的Key):

echo 'export ANTHROPIC_AUTH_TOKEN="你的sk-key"' >> ~/.zshrc echo 'export ANTHROPIC_BASE_URL="https://linoapi.com"' >> ~/.zshrc echo 'export ANTHROPIC_MODEL="claude-haiku-4-5-20251001"' >> ~/.zshrc source ~/.zshrc

Linux

echo 'export ANTHROPIC_AUTH_TOKEN="你的sk-key"' >> ~/.bashrc echo 'export ANTHROPIC_BASE_URL="https://linoapi.com"' >> ~/.bashrc echo 'export ANTHROPIC_MODEL="claude-haiku-4-5-20251001"' >> ~/.bashrc source ~/.bashrc

Windows

方法一:Git Bash 中配置(开始菜单搜索Git Bash,打开它)

echo 'export ANTHROPIC_AUTH_TOKEN="你的sk-key"' >> ~/.bashrc echo 'export ANTHROPIC_BASE_URL="https://linoapi.com"' >> ~/.bashrc echo 'export ANTHROPIC_MODEL="claude-haiku-4-5-20251001"' >> ~/.bashrc source ~/.bashrc

方法二:系统环境变量

  1. 右键点击此电脑
  2. 选择属性
  3. 点击高级系统设置
  4. 点击环境变量按钮
  5. 在系统变量区域依次新建三个变量:
变量名变量值
ANTHROPIC_AUTH_TOKEN你的sk-key
ANTHROPIC_BASE_URLhttps://linoapi.com
ANTHROPIC_MODELclaude-haiku-4-5-20251001

确定保存,重启终端

⚠️ 注意:

  • 如果已配过 VS Code 插件版,可以直接用同一个 Key
  • “你的sk-key”要替换为你在API平台创建的Key
  • 模型名以 Lino API 模型广场显示的为准

五、启动 Claude Code

进入你的项目目录,输入:

claude

首次启动会依次出现以下设置:

1. 选择主题:推荐选2. Dark mode

2. 终端设置:选1. Yes, use recommended settings

3. 信任文件夹:选1. Yes, I trust this folder

进入对话界面后即可开始使用。


六、常用命令

命令说明
claude启动 Claude Code
claude -p "任务描述"直接执行任务,不进入交互模式
claude --continue继续上次对话
/clear清除当前对话
/compact压缩对话节省 token
/theme切换主题
/help查看所有可用命令

七、省钱建议

Claude Code CLI 每次对话会消耗大量 token,建议:

  • 使用Haiku 模型,比 Sonnet 便宜约 10 倍
  • 长对话定期使用/compact压缩上下文
  • 任务完成后用/clear清除对话再开始新任务
  • 尽量在项目目录下启动,避免加载无关文件

常见问题

Q:安装时报EACCES permission denied错误?A:Mac/Linux 加sudo前缀重新执行,Windows 用管理员身份运行终端。

Q:Windows 报requires git-bash错误?A:先安装 Git for Windows,安装完重启终端再试。

Q:启动后报 401 错误?A:检查 Key 是否正确填写,以及平台余额是否充足。

Q:启动后报 405 错误?A:ANTHROPIC_BASE_URL填错了,检查地址是否正确。

Q:一直显示 Ruminating 不回复?A:检查模型名是否填写正确,必须是 Claude 系列模型名。

Q:CLI 版和 VS Code 插件版可以共存吗?A:可以,两者互不影响,可以共用同一个 API Key。

Q:CLI 版和插件版有什么区别?A:CLI 版支持 Skill 等更多高级功能;插件版操作更直观,新手推荐插件版入门。


如有问题欢迎评论区留言!

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询