【Claude Code】Claude Code 接入阿里云百炼 Coding Plan 完整配置教程（Linux版）

Claude Code 接入阿里云百炼 Coding Plan 完整配置教程（Linux版）

本文详细介绍如何在 Linux 系统上将 Claude Code CLI 工具接入阿里云百炼 Coding Plan，实现使用国产大模型进行代码辅助开发。

前言

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，支持代码生成、调试、重构等功能。由于网络原因，国内用户直接使用 Claude Code 可能会遇到连接问题。阿里云百炼平台提供了 Coding Plan 服务，支持通过兼容的 API 接口接入多种国产大模型，让开发者能够在国内环境下流畅使用 AI 编程助手。

一、配置 Claude Code

1.1 创建配置目录

如果 .claude 目录不存在，先创建它：

mkdir -p ~/.claude

1.2 编辑配置文件

使用编辑器打开或创建配置文件：

nano ~/.claude/settings.json

或使用 vim：

vim ~/.claude/settings.json

1.3 写入配置内容

将以下内容粘贴到文件中，将 YOUR_API_KEY 替换为你的 Coding Plan API Key：

{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.5-plus"
}
}

注意：API Key 请妥善保管，不要泄露给他人或提交到公开仓库。

保存并退出（nano 编辑器按 Ctrl+O 保存，Ctrl+X 退出；vim 按 Esc 后输入 :wq）。

二、完成初始化配置（重要）

2.1 跳过 Onboarding

为了避免启动时报错 Unable to connect to Anthropic services，需要额外配置一个文件跳过初始化引导。

创建或编辑 ~/.claude.json 文件：

nano ~/.claude.json

写入以下内容：

{
"hasCompletedOnboarding": true
}

注意：hasCompletedOnboarding 必须作为顶层字段，不要嵌套在其他对象中。

2.2 配置生效

保存配置文件后，重新打开一个终端窗口或执行以下命令使配置生效：

source ~/.bashrc

三、开始使用

3.1 启动 Claude Code

在终端中输入：

claude

首次启动会显示欢迎界面，接下来就可以开始与 AI 助手对话了！

3.2 常用命令

3.3 权限模式说明

Claude Code 默认会在执行敏感操作（如文件修改、命令执行）前请求用户确认。如果希望跳过这些确认步骤，可以使用以下方式：

启动时跳过权限确认：

claude –dangerously-skip-permissions

或在配置文件中永久设置：

编辑 ~/.claude/settings.json，添加 permissions 字段：

{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.5-plus"
},
"permissions": {
"allow": ["*"],
"deny": []
}
}

警告：跳过权限确认意味着 Claude Code 可以在未经确认的情况下执行任意操作，包括修改文件、运行命令等。请确保在可信环境中使用此选项，并仔细审查 AI 的建议。

3.4 快速配置脚本

为了方便快速配置，也可以使用以下一键脚本：

#!/bin/bash

# 创建配置目录
mkdir -p ~/.claude

# 提示输入 API Key
read -p "请输入你的 Coding Plan API Key: " API_KEY

# 写入 settings.json
cat > ~/.claude/settings.json << EOF
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "${API_KEY}",
"ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.5-plus"
}
}
EOF

# 写入 claude.json
cat > ~/.claude.json << EOF
{
"hasCompletedOnboarding": true
}
EOF

echo "配置完成！请重新打开终端或执行 source ~/.bashrc 使配置生效。"

保存为 setup-claude-code.sh，执行：

chmod +x setup-claude-code.sh
./setup-claude-code.sh

四、常见问题

Q1：启动时报错 “Unable to connect to Anthropic services”

原因：未正确配置 hasCompletedOnboarding 字段。

解决方案：确保 ~/.claude.json 文件存在且包含正确的配置（见第二节）。

Q2：API Key 无效或认证失败

原因：API Key 配置错误或已过期。

解决方案：

Q3：模型不支持

原因：指定的模型名称不正确。

解决方案：确认 ANTHROPIC_MODEL 的值是否为百炼 Coding Plan 支持的模型，如 qwen3.5-plus、qwen3-plus 等。

Q4：npm install 报权限错误

原因：全局安装需要 root 权限。

解决方案：

# 方法一：使用 sudo
sudo npm install -g @anthropic-ai/claude-code

# 方法二：配置 npm 使用用户目录
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code

五、总结

通过以上配置，已成功将 Claude Code 接入阿里云百炼 Coding Plan。现在可以在国内网络环境下，使用国产大模型享受 AI 编程助手的便利。

配置要点回顾：

参考资料

• Claude Code 官方文档
• 阿里云百炼平台
• Node.js 官网

如果本文对你有帮助，欢迎点赞、收藏、关注！有问题欢迎在评论区留言讨论。