【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 目录不存在，先创建它：

bash 复制代码

mkdir -p ~/.claude

1.2 编辑配置文件

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

bash 复制代码

nano ~/.claude/settings.json

或使用 vim：

bash 复制代码

vim ~/.claude/settings.json

1.3 写入配置内容

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

json 复制代码

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

配置项	说明
`ANTHROPIC_BASE_URL`	API 基础地址，固定为：`https://coding.dashscope.aliyuncs.com/apps/anthropic`
`ANTHROPIC_AUTH_TOKEN`	Coding Plan 专属 API Key，需在百炼平台获取
`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 文件：

bash 复制代码

nano ~/.claude.json

写入以下内容：

json 复制代码

{
  "hasCompletedOnboarding": true
}

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

2.2 配置生效

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

bash 复制代码

source ~/.bashrc

三、开始使用

3.1 启动 Claude Code

在终端中输入：

bash 复制代码

claude

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

3.2 常用命令

命令	说明
`claude`	启动交互式会话
`claude "你的问题"`	直接提问
`claude --help`	查看帮助信息
`claude --dangerously-skip-permissions`	跳过权限确认，自动执行所有操作
`Ctrl+C`	退出当前会话

3.3 权限模式说明

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

启动时跳过权限确认：

bash 复制代码

claude --dangerously-skip-permissions

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

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

json 复制代码

{
    "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 快速配置脚本

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

bash 复制代码

#!/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，执行：

bash 复制代码

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 配置错误或已过期。

解决方案：

检查 settings.json 中的 ANTHROPIC_AUTH_TOKEN 是否正确
确认 API Key 没有多余的空格或换行符
登录百炼平台确认 Key 是否有效

Q3：模型不支持

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

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

Q4：npm install 报权限错误

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

解决方案：

bash 复制代码

# 方法一：使用 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/settings.json 中配置环境变量
在 ~/.claude.json 中设置 hasCompletedOnboarding: true
重启终端使配置生效

参考资料

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