基础环境准备
在开始之前,我们需要确保系统更新到位,并准备好 Node.js 运行环境。
1. 更新系统与依赖
sudo apt update && sudo apt upgrade -y
2. 安装 Node.js
推荐使用 NodeSource 源获取最新 LTS 版本:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs npm
3. 安装 Git
sudo apt install -y git
git --version
安装 Claude Code CLI
通过 npm 全局安装官方 CLI 工具:
npm install -g @anthropic-ai/claude-code
如果遇到权限错误(如 EACCES),通常是因为没有写入 /usr/lib/node_modules 的权限。此时可尝试调整目录权限或使用 sudo 执行安装。验证安装是否成功:
claude --version
配置环境变量与 VSCode 集成
1. 插件安装
在 VSCode 扩展市场中搜索并安装「Claude Code」插件。启动后,点击右上角图标进入设置页面。若遇到登录提示,可在对话框输入 /config 进入设置,勾选 Disable Login Prompt 来跳过登录流程。
2. 模型配置
默认情况下可能需要配置 API 密钥。若需自定义后端模型(例如接入第三方代理或本地模型),可手动编辑配置文件。
创建或修改 ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
"ANTHROPIC_AUTH_TOKEN": "your_token_here",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":


