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/WindowsNode.js 18 或更高版本3. 安装 Node.js3.1 检查 Node.js终端执行node-v看版本是不是高于18说明环境满足要求。3.2 未安装 Node.js推荐安装 Node.js 20curl-fsSLhttps://deb.nodesource.com/setup_20.x|sudo-Ebash-安装sudoaptinstallnodejs-y验证node-vnpm-v4. 安装 Claude Code执行npminstall-ganthropic-ai/claude-code安装完成后claude--version如果输出版本说明安装成功。5. 火山方舟准备进入火山方舟控制台https://console.volcengine.com/ark/region:cn-beijing/subscription/coding-plan准备API KeyCoding Plan也可以选Agent Plan 新手尝鲜9.9对应模型名称6. Claude Code 配置文件说明Claude Code Linux 下主要涉及两个配置文件。不想要了解这一段直接跳到下面7. 创建 Claude Code 配置目录6.1 API配置文件路径~/.claude/settings.json在ubuntu中使用下面的指令打开 .claude 文件夹。xdg-open~/.claude作用保存 API Key、API 地址、 模型配置6.2 Claude初始化文件路径~/.claude.json作用保存Claude Code 初始化状态、安装信息、onboarding 状态注意很多用户只修改 settings.json但是第一次启动仍然要求登录 Anthropic是需要去修改这个文件的7. 创建 Claude Code 配置目录查看ls-la~如果不存在.claude创建mkdir-p~/.claude8. 创建 settings.json执行nano~/.claude/settings.json填写{env:{ANTHROPIC_AUTH_TOKEN:你的API Key,ANTHROPIC_BASE_URL:https://ark.cn-beijing.volces.com/api/coding,ANTHROPIC_MODEL:ark-code-latest},theme:auto}保存并退出Ctrl O Enter Ctrl X9. 高级模型配置如果 Coding Plan 支持多个模型可以增加{env:{ANTHROPIC_AUTH_TOKEN:你的API Key,ANTHROPIC_BASE_URL:https://ark.cn-beijing.volces.com/api/coding,ANTHROPIC_MODEL:ark-code-latest,ANTHROPIC_DEFAULT_HAIKU_MODEL:doubao-seed-2-0-lite-260428,ANTHROPIC_DEFAULT_SONNET_MODEL:doubao-seed-2-1-pro-260628,ANTHROPIC_DEFAULT_OPUS_MODEL:doubao-seed-2-1-pro-260628,CLAUDE_CODE_SUBAGENT_MODEL:doubao-seed-2-1-pro-260628}}参数说明参数作用ANTHROPIC_MODEL默认模型HAIKU快速任务模型SONNET普通复杂任务OPUS高推理任务SUBAGENT_MODEL子 Agent 模型10. 修改 .claude.json 完成初始化第一次运行claude可能出现Select login method: 1. Claude account 2. Anthropic Console account 3. 3rd-party platform如果使用火山方舟不要选择 Anthropic 登录。编辑nano~/.claude.json增加hasCompletedOnboarding:true例如{numStartups:2,installMethod:global,hasCompletedOnboarding:true}保存。11. 启动 Claude Code重新打开终端claude第一次启动可能出现Security notes: Claude can make mistakes. Press Enter to continue直接按Enter即可。12. 验证是否成功进入 Claude Code 后输入/status或者你好请介绍一下当前使用的模型正常情况下Claude Code 会通过Claude Code ↓ 火山方舟 Coding API ↓ ark-code-latest / 豆包模型返回结果。13. 常见问题问题1连接 Anthropic 超时错误Unable to connect to Anthropic services Connection to platform.claude.com timed out原因Claude Code 没读取火山方舟配置。检查cat~/.claude/settings.json确认ANTHROPIC_BASE_URL存在。问题2一直出现登录界面原因没有完成 onboarding。修改nano~/.claude.json增加hasCompletedOnboarding:true问题3配置文件路径错误正确/home/用户名/.claude/settings.json错误/home/用户名/.claude.json/settings.json错误/home/用户名/.claude/home/用户名/.claude/settings.json14. 最终目录结构正确/home/用户名 ├── .claude │ └── settings.json │ └── .claude.json其中settings.json负责API配置 模型配置.claude.json负责初始化状态15. 总结完整流程1. 安装 Node.jsnode-v2. 安装 Claude Codenpminstall-ganthropic-ai/claude-code3. 检查版本claude--version4. 创建配置mkdir-p~/.claudenano~/.claude/settings.json5. 配置火山方舟填写ANTHROPIC_AUTH_TOKEN ANTHROPIC_BASE_URL ANTHROPIC_MODEL6. 修改初始化状态nano~/.claude.json增加hasCompletedOnboarding:true7. 启动claude完成后即可在 Linux 环境中使用 Claude Code并调用火山方舟 Coding Plan 模型。参考资料Claude Code 官方文档https://code.claude.com/docs/en/installationClaude Code Quick Starthttps://code.claude.com/docs/en/quickstart火山方舟控制台https://console.volcengine.com/ark