一、安装 Claude Code
1. 安装 Node.js
前往 Node.js 官网下载对应系统版本并安装。安装完成后,打开 PowerShell 验证:
node -v
npm -v
确认两个命令均能正常输出版本号。
2. 安装 Claude Code 本体
在 PowerShell 中执行安装命令,正式安装 Claude Code。
3. 创建 config.json 配置文件
根据操作系统,在特定目录下新建 config.json 文件并写入配置内容。Windows 用户也可以直接在 PowerShell 中一键创建;macOS/Linux 用户同理。
4. 关键步骤:配置 .claude.json
在当前用户目录(Windows)或 .claude 文件夹(macOS/Linux)中的 .claude.json 文件里添加第三方模型加载配置。
这一步是新版本最大的坑。 老版本的 Claude Code 不需要这行配置,启动时可以直接加载第三方模型。新版本如果不做这个配置,启动后会一直强制要求选择官方模型,根本无法切换到第三方 API。原本十分钟搞定的安装,因为这个隐藏更新多花了半小时排查。
二、配置第三方模型
1. 安装 VS Code 与插件
安装 VS Code 后,在插件市场搜索 Claude Code YOLO(必须搜索全称才能找到)。这是一个魔改版插件,与官方版本的核心区别在于:插件本身就支持配置第三方模型。
安装完成后,右上角会出现 Claude 图标,点击即可启动 Claude Code。
2. 切换任务模式
将模式切换为 Ask before edits,确保 AI 在修改代码前先征求确认。
3. 配置 API 参数
启动 Claude Code 后,在输入框输入 /,找到 API configuration 进入模型配置页面。
以 DeepSeek 为例,注册 DeepSeek 平台并申请 API Key,然后按以下参数填写:
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-chat",
"ANTHROPIC_AUTH_TOKEN": "sk-xxxx"
配置完成后随便输入点内容,验证 AI 是否正常应答。在 PowerShell 中也可以直接输入 claude 启动命令行版本。
三、接入中转 API 模型
如果想使用更多模型,可以通过 OpenRouter 中转。注册 OpenRouter 后选择目标模型,例如免费的 MiMo-V2-Flash:
"ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "Xiaomi/MiMo-V2-Flash",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "Xiaomi/MiMo-V2-Flash",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "Xiaomi/MiMo-V2-Flash",
"ANTHROPIC_AUTH_TOKEN": "sk-or-v1-你的密钥"
小结
对于独立开发者来说,通过第三方 API 使用 Claude Code 是一种高性价比的方案——既能用上强大的 AI 编程辅助能力,又能灵活选择 DeepSeek、OpenRouter 等更经济的模型。安装时务必注意新版本的 .claude.json 配置变更,这是目前最容易踩的坑。