AI 编程助手天花板！Claude Code 国内使用完整教程(Windows/Mac/Linux 三大系统手把手配置教学)

前言

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）。

四、配置环境变量

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

方法二：系统环境变量

确定保存，重启终端

⚠️ 注意：

• 如果已配过 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 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 等更多高级功能；插件版操作更直观，新手推荐插件版入门。

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