Ubuntu 安装与配置 Claude Code

Claude Code 是 Anthropic 推出的原生命令行界面（CLI），能够直接在你的本地开发环境中完成代码编写、测试和 git 操作。

安装 Claude Code

Anthropic 提供了一个全自动安装脚本，会自动处理 Linux 环境下的依赖。在终端执行：

curl -fsSL https://claude.ai/install.sh | bash

安装完成后，输入 claude --version。如果看到版本号，说明本体已成功降临你的系统。

编辑配置文件（跳过新手引导）

如果你希望跳过初次启动时的互动式引导，可以直接手动创建配置文件。

1. 打开终端。
2. 使用 nano 或你喜欢的编辑器打开（或创建）配置文件：

nano ~/.claude.json

3. 在文件中添加以下 JSON 内容：

{
  "hasCompletedOnboarding": true
}

如果文件已存在，请确保该字段被设置为 true。按 Ctrl+O 保存，Ctrl+X 退出。

设置自定义 API 接口

如果你计划使用第三方代理（如 OpenRouter）或公司内部的 LLM 代理，需要通过修改 settings.json 来覆盖默认的 Anthropic 官方路径。

路径：~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-xxxxxxxxxxxx",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-3.7-sonnet" 
  }
}

⚡ 避坑小贴士：

• Base URL： 请务必确认代理商的完整路径。有的需要加 /v1，有的则不需要。

• 模型映射： 使用非原版域名时，建议明确指定 ANTHROPIC_DEFAULT_SONNET_MODEL，防止工具因找不到默认模型名而报错。

启动与验证

一切就绪后，进入你的代码仓库目录，输入：

claude

验证连接是否成功：
在 Claude Code 的交互对话框中输入：

/status

它会显示当前生效的 Base URL 和 认证状态。如果显示的地址是你配置的自定义 URL，说明配置已生效。

常用命令速查表