Skip to content

👾 4.1 Claude Code 详细配置指南

Claude Code 是 Anthropic 官方推出的极客级终端 AI 编程助手。它可以直接在您的终端里读取整个项目代码、执行系统命令、甚至自主修复 Bug。

由于官方版本强绑定了其自身的鉴权,我们需要通过特定配置,让它绕过限制,直接连接到 Old Dog AI 的极速接口。


📥 第一步:安装 Claude Code

根据您的操作系统,在终端(Terminal)或命令行(CMD/PowerShell)中运行以下命令进行全局安装。

方式一:本机直接安装(官方推荐)

  • macOS / Linux / WSL:

    bash
    curl -fsSL [https://claude.ai/install.sh](https://claude.ai/install.sh)
  • Windows PowerShell:

    powershell
    irm [https://claude.ai/install.ps1](https://claude.ai/install.ps1)
  • Windows CMD:

    bash
    curl -fsSL [https://claude.ai/install.cmd](https://claude.ai/install.cmd) -o install.cmd && install.cmd && del install.cmd

方式二:NPM 安装 (适合已有 Node 环境的开发者) ```bash npm install -g @anthropic-ai/claude-code

```

⚠️ 注意:切勿使用 sudo npm install -g,这可能导致权限问题和安全风险。


⚙️ 第二步:配置接口地址与密钥

为了让 Claude Code 连上我们的服务器,您必须覆盖它默认的 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN。以下两种方法任选其一:

🟢 方法 A:使用 CC Switch 可视化配置 (强烈推荐小白)

如果您不想折腾底层的环境变量,可以使用 CC Switch 这个第三方开源环境管理器进行一键切换。

  1. 下载软件:前往 CC-Switch 的 Github Release 页面,下载适合您系统的安装包(Windows 系统推荐下载普通的 .msi 安装包)。
  2. 选择分组:打开软件,在顶部的分组条中,将分组选择至 Claude
  3. 添加供应商:在供应商面板中,选择 【自定义配置】
  • 供应商名称:填入 Old Dog AI
  1. 填入配置代码:在配置文本框中,粘贴以下 JSON 代码(请务必替换为您自己的 API Key):

    json
    {
      "env": {
        "ANTHROPIC_BASE_URL": "[https://api.olddog.shop](https://api.olddog.shop)",
        "ANTHROPIC_AUTH_TOKEN": "sk-您的专属API_KEY"
      }
    }
  2. 启用代理:添加成功后,回到主界面,点击我们刚才创建的 Old Dog AI 右侧的 【启用】 按钮。显示“使用中”即代表配置生效。

🔴 方法 B:手动修改配置文件 (极客纯手打)

[cite_start]如果您不想安装额外的管理器,可以直接修改 Claude Code 的底层配置文件,通过手动指定环境变量来劫持请求 。

  1. 定位配置文件:Claude Code 的配置存储在用户主目录下的 .claude 文件夹中 。
    • Windows: C:\Users\您的用户名\.claude\settings.json
    • macOS / Linux: ~/.claude/settings.json
  2. 修改内容:打开 settings.json,填入以下 JSON 结构(请将 sk-xxxx 替换为您的 Old Dog AI 密钥):
    json
    {
      "env": {
        "ANTHROPIC_BASE_URL": "[https://api.olddog.shop](https://api.olddog.shop)",
        "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }

⚠️ 第三步:首次运行初始化 (防坑必看)

这是最容易卡壳的地方!很多用户发现修改了 settings.json 后,启动 Claude Code 依然连接官方服务器。这是因为第一次安装后需要手动设置临时环境变量进行初始化,之后系统才会正式识别并加载配置文件 。

请根据您的终端类型,运行对应的初始化命令 :

  • Windows (PowerShell):
    powershell
    $env:ANTHROPIC_BASE_URL="[https://api.olddog.shop](https://api.olddog.shop)"
    $env:ANTHROPIC_AUTH_TOKEN="sk-您的API_KEY"
    claude
  • Windows (CMD):
    cmd
    set ANTHROPIC_BASE_URL=[https://api.olddog.shop](https://api.olddog.shop)
    set ANTHROPIC_AUTH_TOKEN=sk-您的API_KEY
    claude
  • macOS / Linux:
    bash
    export ANTHROPIC_BASE_URL="[https://api.olddog.shop](https://api.olddog.shop)"
    export ANTHROPIC_AUTH_TOKEN="sk-您的API_KEY"
    claude

🚀 第四步:启动与验证

  1. 进入项目:在终端中切换到您的项目目录 。

  2. 启动命令:输入 claude 并回车 。

  3. 验证结果:如果您看到熟悉的对话界面,并且尝试发送“你好”后收到了正确的中文回复,说明您已成功通过 Old Dog AI 驱动 Claude Code !


💡 补充技巧:跳过 Onboarding 流程

如果您希望启动时直接进入对话,而不必每次点击确认或登录,可以在用户目录下创建一个 .claude.json 文件(注意不是文件夹里的那个),并写入以下代码 :

  • 路径: ~/.claude.jsonC:\Users\用户名\.claude.json
json
{
  "hasCompletedOnboarding": true
}