夜雨聆风麒麟系统安装 Claude Code 并配置阿里云百炼攻略
Claude Code 是 Anthropic 推出的命令行 AI 编程助手，现在可以通过阿里云百炼 Coding Plan 使用，无需国际信用卡，支持支付宝/微信支付！
一、什么是 Claude Code
Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，可以直接在终端中与 Claude 对话，让它帮你：
编写和修改代码 调试和修复 bug 生成测试用例 创建项目结构 解释代码逻辑
通过阿里云百炼 Coding Plan，你可以用国内支付方式使用 Claude Code，无需担心国际支付和网络问题。
二、前置条件
Claude Code 需要 Node.js v18.0 或更高版本。
检查是否已安装：
node --version
npm --version
如果没有安装 Node.js：
macOS：
brew install node
Linux：
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
Windows： 下载官方安装包：https://nodejs.org/[1]
三、安装 Claude Code
打开终端，执行以下命令：
npm install -g @anthropic-ai/claude-code
验证安装：
claude --version
成功输出示例：
2.1.84 (Claude Code)
四、配置阿里云百炼
1. 获取 API Key
访问阿里云百炼控制台 登录阿里云账号 进入 Coding Plan 页面 创建或选择一个 API Key 复制保存（只显示一次）
2. 创建配置文件
创建配置目录：
mkdir -p ~/.claude
创建 settings.json：
nano ~/.claude/settings.json
粘贴以下内容（替换 YOUR_API_KEY）：
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.5-plus"
}
}
创建 onboarding 配置：
nano ~/.claude.json
粘贴以下内容：
{
"hasCompletedOnboarding": true
}
注意：hasCompletedOnboarding 必须作为顶层字段，不要嵌套在其他字段中。
五、使用指南
启动 Claude Code
cd /path/to/your/project
claude
常用命令
/init - 创建项目配置文件 CLAUDE.md /status - 查看当前模型、API 配置 /help - 查看所有可用命令 /clear - 清除对话历史 /model 模型名 - 切换模型 /plan - 进入规划模式 /compact - 压缩对话历史 /config - 打开配置菜单 /exit - 退出 Claude Code
实用技巧
引用文件： 用 @ 引用具体文件，让 Claude 聚焦：
帮我测试 @auth.py 里的登录功能
先计划再执行：
/plan
帮我设计一个用户注册系统
让 Claude 自动验证：
修改完代码后，运行测试确保通过
六、常见问题
问题 1：报错 Unable to connect to Anthropic services
解决方案：确保 ~/.claude.json 文件存在且包含 hasCompletedOnboarding: true
问题 2：如何切换模型
启动时指定：
claude --model qwen3-coder-plus
会话中切换：
/model qwen3-coder-plus
问题 3：如何设置中文
配置文件中添加：
{
"language": "zh-CN"
}
或在对话中直接说：请用中文回答
问题 4：API Key 无效
检查以下几点：
API Key 是否复制完整（无空格） 是否在阿里云百炼控制台激活 账户余额是否充足
七、总结
核心步骤回顾：
安装 Node.js npm install -g @anthropic-ai/claude-code 创建 ~/.claude/settings.json 配置 API 创建 ~/.claude.json 跳过 onboarding 运行 claude 开始使用
下一步：
在你的项目中运行 claude 开始体验 使用 /init 创建项目配置文件 尝试让 Claude 帮你写第一个功能
参考资料：
阿里云百炼官方文档 Claude Code 官方文档 阿里云百炼控制台
如果你觉得这篇教程有帮助，欢迎点赞、收藏、转发！
引用链接
[1]https://nodejs.org/
