1. 前言

Claude Code 是 Anthropic 官方推出的终端 AI 编程工具，可以直接在 Linux/macOS/Windows 终端中辅助开发。

但是 Claude Code 默认连接 Anthropic 官方模型服务。

对于国内开发者，可以通过火山方舟（Volcengine Ark）提供的 Anthropic 兼容接口，将 Claude Code 接入国内模型服务。
买个9.9的尝尝鲜！！

本文记录：

Ubuntu/Linux 环境安装 Claude Code，并接入火山方舟 Coding Plan 的完整流程。

---

2. 环境准备

2.1 系统环境

• Linux/macOS/Windows
• Node.js 18 或更高版本

3. 安装 Node.js

3.1 检查 Node.js

终端执行：

node -v

看版本是不是高于18，说明环境满足要求。

3.2 未安装 Node.js

推荐安装 Node.js 20：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

安装：

sudo apt install nodejs -y

验证：

node -v

npm -v

---

4. 安装 Claude Code

执行：

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

安装完成后：

claude --version

如果输出版本，说明安装成功。

---

5. 火山方舟准备

进入火山方舟控制台：

https://console.volcengine.com/ark/region:cn-beijing/subscription/coding-plan

准备：

• API Key
• Coding Plan也可以选Agent Plan ，新手尝鲜9.9
• 对应模型名称

6. Claude Code 配置文件说明

Claude Code Linux 下主要涉及两个配置文件。不想要了解这一段直接跳到下面

6.1 API配置文件

路径：~/.claude/settings.json
在ubuntu中使用下面的指令打开 .claude 文件夹。

xdg-open ~/.claude

作用：保存 API Key、API 地址、 模型配置
填写：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API Key",
    "ANTHROPIC_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding",
    "ANTHROPIC_MODEL": "ark-code-latest"
  },
  "theme": "auto"
}

---

6.2 Claude初始化文件

在.claude文件夹的外面有一个Claude初始化文件.claude.json文件，隐藏的，建议
用“记事本”打开 .claude.json文件 ：

 gedit ~/.claude.json

作用：保存Claude Code 初始化状态、安装信息、onboarding 状态

注意：很多用户只修改 settings.json，但是第一次启动仍然要求登录 Anthropic，是需要去修改这个文件的

第一次运行：

claude

可能出现：

Select login method:

1. Claude account
2. Anthropic Console account
3. 3rd-party platform

打开之后再里面增加：

"hasCompletedOnboarding": true

例如可以直接复制下面的覆盖：

{
  "numStartups": 2,
  "installMethod": "global",
  "hasCompletedOnboarding": true
}

保存。

7. 启动 Claude Code

重新打开终端：

claude

第一次启动：

可能出现：

Security notes:

Claude can make mistakes.

Press Enter to continue

直接按：

Enter

即可。

---

8. 验证是否成功

进入 Claude Code 后：

输入：

/status

或者：

你好，请介绍一下当前使用的模型

正常情况下：

Claude Code 会通过：

Claude Code

↓

火山方舟 Coding API

↓

ark-code-latest / 豆包模型

返回结果。

---

9. 常见问题

问题1：连接 Anthropic 超时

错误：

Unable to connect to Anthropic services

Connection to platform.claude.com timed out

原因：

Claude Code 没读取火山方舟配置。

检查：

cat ~/.claude/settings.json

确认：

ANTHROPIC_BASE_URL

存在。

---

火山方舟控制台：

https://console.volcengine.com/ark