适用系统: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. 登录 阿里云大模型服务平台(百炼)

0-WPTu

2. 找到 Coding Plan,点「立即购买」

0-bkTL

3. 确认页面显示首月 7.9 元,开通

0-HhvM

4. 购买后复制 API Key,存好

0-CWdz

第二步:安装 Claude Code

最新版有兼容问题,直接装指定版本。

macOS(Terminal)

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.62

执行后如果看起来"卡住了",是正常的,线程正在下载稍等等一会,成功后显示 Installation complete!

0-OWLD

Windows(Git Bash)

没有 Git Bash 的话,先去 Git 官网 下载,一路点「下一步」装完。

curl -fsSL https://claude.ai/install.cmd -o install.cmd && ./install.cmd 2.1.62 && rm install.cmd
0-oHnU

装完之后设置环境变量,记得把 用户名 换成你自己的 Windows 用户名

powershell -Command "[Environment]::SetEnvironmentVariable('Path', [Environment]::GetEnvironmentVariable('Path', 'User') + ';C:\Users\用户名\.local\bin', 'User')"
0-AOMm

执行完,重启 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)'
0-Tbtk

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
0-aIqG

配置 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
0-qlZJ

可选模型:qwen3.5-plus(支持图片)、kimi-k2.5(支持图片)、glm-5MiniMax-M2.5


第四步:启动测试

终端输入 claude 回车,第一次进入选 Yes, I trust this folder 后回车。

0-JBBS

进入界面后能看到你配置的模型名。

0-UkQA

随便输一句话测试,能回复就是跑通了。

0-VPSd

报错 API Error 400 怎么办

0-CxIN

原因是 v2.1.63 客户端和第三方 API 有兼容问题。两个处理方式:

方案一:关掉 Thinking Mode

输入 /config,把 Thinking mode 改成 false,按 Esc 退出。

0-dpSl
0-wmKc

方案二:回退版本

重新执行第二步的安装命令,版本号用 2.1.62 就行。

0-jJQH

最后

如果你顺着教程做到这里,那么恭喜你——你已经真正把 Claude Code 跑起来了,而不是“看过几篇文章、心里大概懂了”。很多人以为 AI 工具是高门槛的东西,其实只要跑通一次,你就会发现它并没有那么神秘,甚至会觉得:原来我早该开始用。 我一直相信一个原则:会用工具的人不一定更聪明,但一定更强。

无论你是写代码、写文档、做自动化,还是单纯想提升日常效率,把 Claude Code 作为你电脑里的第二个大脑,它的价值会在之后的每一天慢慢显现出来。