👾 4.1 Claude Code 详细配置指南
Claude Code 是 Anthropic 官方推出的极客级终端 AI 编程助手。它可以直接在您的终端里读取整个项目代码、执行系统命令、甚至自主修复 Bug。
由于官方版本强绑定了其自身的鉴权,我们需要通过特定配置,让它绕过限制,直接连接到 Old Dog AI 的极速接口。
📥 第一步:安装 Claude Code
根据您的操作系统,在终端(Terminal)或命令行(CMD/PowerShell)中运行以下命令进行全局安装。
方式一:本机直接安装(官方推荐)
macOS / Linux / WSL:
bashcurl -fsSL [https://claude.ai/install.sh](https://claude.ai/install.sh)Windows PowerShell:
powershellirm [https://claude.ai/install.ps1](https://claude.ai/install.ps1)Windows CMD:
bashcurl -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_URL 和 ANTHROPIC_AUTH_TOKEN。以下两种方法任选其一:
🟢 方法 A:使用 CC Switch 可视化配置 (强烈推荐小白)
如果您不想折腾底层的环境变量,可以使用 CC Switch 这个第三方开源环境管理器进行一键切换。
- 下载软件:前往 CC-Switch 的 Github Release 页面,下载适合您系统的安装包(Windows 系统推荐下载普通的
.msi安装包)。 - 选择分组:打开软件,在顶部的分组条中,将分组选择至
Claude。 - 添加供应商:在供应商面板中,选择 【自定义配置】。
- 供应商名称:填入
Old Dog AI。
填入配置代码:在配置文本框中,粘贴以下 JSON 代码(请务必替换为您自己的 API Key):
json{ "env": { "ANTHROPIC_BASE_URL": "[https://api.olddog.shop](https://api.olddog.shop)", "ANTHROPIC_AUTH_TOKEN": "sk-您的专属API_KEY" } }启用代理:添加成功后,回到主界面,点击我们刚才创建的
Old Dog AI右侧的 【启用】 按钮。显示“使用中”即代表配置生效。
🔴 方法 B:手动修改配置文件 (极客纯手打)
[cite_start]如果您不想安装额外的管理器,可以直接修改 Claude Code 的底层配置文件,通过手动指定环境变量来劫持请求 。
- 定位配置文件:Claude Code 的配置存储在用户主目录下的
.claude文件夹中 。- Windows:
C:\Users\您的用户名\.claude\settings.json - macOS / Linux:
~/.claude/settings.json
- Windows:
- 修改内容:打开
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
🚀 第四步:启动与验证
进入项目:在终端中切换到您的项目目录 。
启动命令:输入
claude并回车 。验证结果:如果您看到熟悉的对话界面,并且尝试发送“你好”后收到了正确的中文回复,说明您已成功通过 Old Dog AI 驱动 Claude Code !
💡 补充技巧:跳过 Onboarding 流程
如果您希望启动时直接进入对话,而不必每次点击确认或登录,可以在用户目录下创建一个 .claude.json 文件(注意不是文件夹里的那个),并写入以下代码 :
- 路径:
~/.claude.json或C:\Users\用户名\.claude.json
{
"hasCompletedOnboarding": true
}