仅需 7.9 元:全网最简单的 Claude Code 跑通教程
适用系统:macOS / Linux / Windows
现在还有很多人都没用过 Claude Code,我觉得挺可惜的。Anthropic 被吐槽的地方有不少,但模型能力是真的强。
我之前也没碰过任何 AI Agent,就是一个 Chatbot 用户,只会在网页和 App 里聊天。后来折腾了很久,才把 Claude Code 搭好。为了以后能够复用,就重新从零再来一遍。我在 Mac 和 Windows 上各跑了两次,文末提到的坑,也都是复现时真实踩到的。废话不多说,打开电脑照跟着做起来吧。
为什么先用阿里百炼?
阿里云百炼 API 平台的 Coding Plan 现在有活动,首月 7.9 元。选它的理由也很实际:国内付款方便,支持千问、Kimi、GLM、MiniMax 这些模型,新手够用,日常也够用。就算以后想切到官方订阅,这里还能当备用。
官方原生订阅的教程我后面会写。顺序是:先跑通 → 整理环境 → 上官方订阅。
第一步:订阅 Coding Plan
1. 登录 阿里云大模型服务平台(百炼)
2. 找到 Coding Plan,点「立即购买」
3. 确认页面显示首月 7.9 元,开通
4. 购买后复制 API Key,存好
第二步:安装 Claude Code
最新版有兼容问题,直接装指定版本。
macOS(Terminal)
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.62执行后如果看起来"卡住了",是正常的,线程正在下载稍等等一会,成功后显示 Installation complete!。
Windows(Git Bash)
没有 Git Bash 的话,先去 Git 官网 下载,一路点「下一步」装完。
curl -fsSL https://claude.ai/install.cmd -o install.cmd && ./install.cmd 2.1.62 && rm install.cmd装完之后设置环境变量,记得把 用户名 换成你自己的 Windows 用户名
powershell -Command "[Environment]::SetEnvironmentVariable('Path', [Environment]::GetEnvironmentVariable('Path', 'User') + ';C:\Users\用户名\.local\bin', 'User')"执行完,重启 Git Bash。
第三步:两条命令搞定配置
安装完先重启终端,再继续。
跳过强制登录(最重要的一步)
我们用的是第三方 API,不需要登录 Claude 官方账号。但 Claude Code 默认会强制走登录流程,必须跳过,不然直接卡死在那里。
macOS(Terminal)
python3 -c 'import json, os; p=os.path.expanduser("~/.claude.json"); data=json.load(open(p)) if os.path.exists(p) else {}; data["hasCompletedOnboarding"]=True; json.dump(data, open(p, "w"), indent=2)'Windows(Git Bash)
FILE="$HOME/.claude.json"
if [ ! -f "$FILE" ]; then
echo '{"hasCompletedOnboarding": true}' > "$FILE"
elif grep -q '"hasCompletedOnboarding"' "$FILE"; then
sed -i 's/"hasCompletedOnboarding":[[:space:]]*false/"hasCompletedOnboarding": true/g' "$FILE"
else
sed -i '$ s/}/,\n "hasCompletedOnboarding": true\n}/' "$FILE"
fi配置 API Key 和模型
macOS 和 Windows 命令一样。把 YOUR_API_KEY 换成你的 Key,模型名按需改:
cat << 'EOF' > ~/.claude/settings.json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "kimi-k2.5"
}
}
EOF可选模型:qwen3.5-plus(支持图片)、kimi-k2.5(支持图片)、glm-5、MiniMax-M2.5。
第四步:启动测试
终端输入 claude 回车,第一次进入选 Yes, I trust this folder 后回车。
进入界面后能看到你配置的模型名。
随便输一句话测试,能回复就是跑通了。
报错 API Error 400 怎么办
原因是 v2.1.63 客户端和第三方 API 有兼容问题。两个处理方式:
方案一:关掉 Thinking Mode
输入 /config,把 Thinking mode 改成 false,按 Esc 退出。
方案二:回退版本
重新执行第二步的安装命令,版本号用 2.1.62 就行。
最后
如果你顺着教程做到这里,那么恭喜你——你已经真正把 Claude Code 跑起来了,而不是“看过几篇文章、心里大概懂了”。很多人以为 AI 工具是高门槛的东西,其实只要跑通一次,你就会发现它并没有那么神秘,甚至会觉得:原来我早该开始用。 我一直相信一个原则:会用工具的人不一定更聪明,但一定更强。
无论你是写代码、写文档、做自动化,还是单纯想提升日常效率,把 Claude Code 作为你电脑里的第二个大脑,它的价值会在之后的每一天慢慢显现出来。