ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

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

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/winGit Bash详细安装方法参考上一篇文章“在VS Code中配置Claude Code保姆级部署教程”。https://blog.csdn.net/GuPusheng/article/details/159609181?fromshareblogdetailsharetypeblogdetailsharerId159609181sharereferPCsharesourceGuPushengsharefromfrom_link二、安装 Claude Code CLIMac / Linuxsudo npm install -g anthropic-ai/claude-code输入后需要输入开机密码输入时屏幕不显示任何字符输完回车即可。Windows在 Git Bash 或 PowerShell 中输入不需要 sudonpm install -g anthropic-ai/claude-code安装过程可能需要等待 1 分钟左右看到added X packages或changed X packages说明安装成功。三、获取 API Key由于没有海外信用卡需要使用国内中转平台。本文使用Lino APIhttps://linoapi.com.cn/register?affEwUj。注册账号并充值支持支付宝/微信进入控制台 → API令牌 → 添加令牌(按如图所示进行配置)状态设为启用,复制sk-开头的 Key在模型广场确认可用的 Claude 模型名称推荐选Haiku 系列最便宜四、配置环境变量Mac在终端执行注意⚠️“你的sk-key”要替换为你在API平台创建的Keyecho export ANTHROPIC_AUTH_TOKEN你的sk-key ~/.zshrc echo export ANTHROPIC_BASE_URLhttps://linoapi.com ~/.zshrc echo export ANTHROPIC_MODELclaude-haiku-4-5-20251001 ~/.zshrc source ~/.zshrcLinuxecho export ANTHROPIC_AUTH_TOKEN你的sk-key ~/.bashrc echo export ANTHROPIC_BASE_URLhttps://linoapi.com ~/.bashrc echo export ANTHROPIC_MODELclaude-haiku-4-5-20251001 ~/.bashrc source ~/.bashrcWindows方法一Git Bash 中配置开始菜单搜索Git Bash打开它echo export ANTHROPIC_AUTH_TOKEN你的sk-key ~/.bashrc echo export ANTHROPIC_BASE_URLhttps://linoapi.com ~/.bashrc echo export ANTHROPIC_MODELclaude-haiku-4-5-20251001 ~/.bashrc source ~/.bashrc方法二系统环境变量右键点击此电脑选择属性点击高级系统设置点击环境变量按钮在系统变量区域依次新建三个变量变量名变量值ANTHROPIC_AUTH_TOKEN你的sk-keyANTHROPIC_BASE_URLhttps://linoapi.comANTHROPIC_MODELclaude-haiku-4-5-20251001确定保存重启终端⚠️ 注意如果已配过 VS Code 插件版可以直接用同一个 Key“你的sk-key”要替换为你在API平台创建的Key模型名以 Lino API 模型广场显示的为准五、启动 Claude Code进入你的项目目录输入claude首次启动会依次出现以下设置1. 选择主题推荐选2. Dark mode2. 终端设置选1. Yes, use recommended settings3. 信任文件夹选1. Yes, I trust this folder进入对话界面后即可开始使用。六、常用命令命令说明claude启动 Claude Codeclaude -p 任务描述直接执行任务不进入交互模式claude --continue继续上次对话/clear清除当前对话/compact压缩对话节省 token/theme切换主题/help查看所有可用命令七、省钱建议Claude Code CLI 每次对话会消耗大量 token建议使用Haiku 模型比 Sonnet 便宜约 10 倍长对话定期使用/compact压缩上下文任务完成后用/clear清除对话再开始新任务尽量在项目目录下启动避免加载无关文件常见问题Q安装时报EACCES permission denied错误AMac/Linux 加sudo前缀重新执行Windows 用管理员身份运行终端。QWindows 报requires git-bash错误A先安装 Git for Windows安装完重启终端再试。Q启动后报 401 错误A检查 Key 是否正确填写以及平台余额是否充足。Q启动后报 405 错误AANTHROPIC_BASE_URL填错了检查地址是否正确。Q一直显示 Ruminating 不回复A检查模型名是否填写正确必须是 Claude 系列模型名。QCLI 版和 VS Code 插件版可以共存吗A可以两者互不影响可以共用同一个 API Key。QCLI 版和插件版有什么区别ACLI 版支持 Skill 等更多高级功能插件版操作更直观新手推荐插件版入门。如有问题欢迎评论区留言
返回列表