为什么先用阿里百炼

官方订阅对网络环境要求较高，而阿里百炼作为中转方案有几个明显优势：

  • 国内支付，支付宝扫码即可开通
  • 支持多款优秀国产模型，新手起步和日常轻度使用完全够用
  • 后续 Claude Code 官方额度用完时，也可随时切回

整体思路分三步走：先打通软件（本文），再搭建纯净网络环境，最后订阅官方原生模型。

第一步：订阅阿里百炼 Coding Plan

  1. 打开阿里云大模型服务平台百炼
  2. 点击「立即购买」，支付宝扫码登录（无账号先注册）
  3. 选择 Coding Plan 套餐，首月 7.9 元，点击开通
  4. 购买完成后，回到控制台复制 API Key 并妥善保存

第二步：安装 Claude Code

macOS

打开 Terminal，粘贴以下命令：

npm install -g -ai/claude-code

如遇最新版兼容问题，可安装指定版本：

npm install -g -ai/claude-code@<指定版本号>

粘贴后会出现短暂"卡住"状态，这是正常的下载过程，等待即可。

Windows

打开 Git Bash，依次粘贴以下命令：

npm install -g -ai/claude-code

同样可指定版本安装。安装完成后需设置环境变量，然后重启 Git Bash。

如果没有 Git Bash，需先安装 Git for Windows。

第三步：两句命令完成配置

重要：完成安装后，务必重启 Terminal 或 Git Bash。

命令一：跳过强制登录引导

由于使用第三方 API，不需要登录 Claude Code 官方账号，必须跳过登录流程。

macOS Terminal：

export CLAUDE_CODE_SKIP_LOGIN=true

Windows Git Bash：

export CLAUDE_CODE_SKIP_LOGIN=true

命令二：配置 API Key 与模型

Mac 和 Windows 命令相同，需替换为你自己的 API Key 和模型名称：

export ANTHROPIC_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
export ANTHROPIC_API_KEY=你的API_Key
export ANTHROPIC_MODEL=你选择的模型名

推荐模型：

  • qwen3.5-plus（支持图片理解）
  • kimi-k2.5（支持图片理解）
  • glm-5
  • MiniMax-M2.5

更多可选： qwen3-max-2026-01-23、qwen3-coder-next、qwen3-coder-plus、glm-4.7

第四步：启动并测试

在 Terminal 或 Git Bash 中输入：

claude

选择 "Yes, I trust this folder" 回车，即可进入 Claude Code 界面。界面会显示你配置的模型名称，发送一条消息测试即可。

常见问题：API Error 400

原因： Claude Code v2.1.63 版本存在兼容问题，会导致第三方 API 报错。

方案一：关闭 Thinking mode（不降级）

  1. 在 Claude Code 中输入 /config 回车
  2. 用方向键选中 Thinking mode，回车改为 false
  3. 按 Esc 退出

方案二：降级到稳定版本

npm install -g -ai/claude-code@<稳定版本号>

重新打开 Claude Code 验证即可。

小结

跑通这篇教程，你就已经拥有了一个可用的 AI Agent 开发环境。虽然第三方模型在能力上与 Claude 原生模型有差距，但作为入门实践完全够用。建议先用这套方案熟悉 Claude Code 的交互方式和工作流，后续再根据需要升级到官方订阅，逐步释放 AI Agent 的全部潜力。