Claude Code 安装与入门

面向外贸小白：按步骤完成阿里云百炼接入，并用 qwen3.6-plus 跑通第一条命令。

1. 你将完成什么

安装 Claude Code 命令行工具。
接入阿里云百炼 Anthropic 兼容接口。
把默认模型设置为 qwen3.6-plus。
在本地项目里跑通第一次代码助手对话。

2. 准备条件（先做这 3 件事）

注册并登录阿里云账号，开通百炼（Model Studio）服务。
在百炼控制台创建 API Key（建议单独创建“开发测试专用 Key”）。
电脑已安装 Node.js（建议 18+）。

3. 安装 Claude Code

npm install -g @anthropic-ai/claude-code
claude --version

如果看到版本号，说明安装成功。

4. 配置百炼接入（核心步骤）

Claude Code 支持通过 Anthropic 兼容接口接入百炼。把下面 3 个环境变量配置好：

macOS / Linux

# macOS / Linux
export ANTHROPIC_BASE_URL=https://dashscope-intl.aliyuncs.com/apps/anthropic
export ANTHROPIC_API_KEY=你的百炼API_KEY
export ANTHROPIC_MODEL=qwen3.6-plus

Windows PowerShell

# Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://dashscope-intl.aliyuncs.com/apps/anthropic"
$env:ANTHROPIC_API_KEY="你的百炼API_KEY"
$env:ANTHROPIC_MODEL="qwen3.6-plus"

5. 跑通第一次对话

进入你的项目目录后执行：

claude

可先输入一句测试：请先阅读当前项目结构，并告诉我从哪里开始最快上手。

6. 常见问题（小白版）

Q1：提示 401 / 鉴权失败？
先检查 API Key 是否填错、是否有空格，并确认环境变量已在当前终端生效。

Q2：模型不可用？
先确认你账号有对应模型权限；若受限，可暂时切换到文档中已开放的 Plus 系列模型。

Q3：重开终端后变量丢失？
把 export 命令写进 shell 配置文件（如 ~/.zshrc），再重新打开终端。