Claude Code + LM Studio 快速上手

---

Claude Code 接入 LM Studio 完整指南

---

这份文档只保留最核心的配置步骤，适合快速接通并开始使用。

目录

Claude Code + LM Studio 快速上手

​编辑

1. 目标

2. 前提

3. 验证 LM Studio 是否工作

4. 配置 Claude Code 全局连接 LM Studio

5. 避免认证冲突

6. 热切换模型

7. 不改 LM Studio 模型名的快捷方案

8. 推荐的日常模型分工

9. 推荐链接

---

---

1. 目标

让 Claude Code 在任意目录都默认连接本机 LM Studio，并使用本地模型。

---

2. 前提

确保你已经具备：

• 已安装 Claude Code
• 已安装 LM Studio
• 已在 LM Studio 中启动本地服务
• 已拿到 LM Studio 的 API Token
• 已下载并加载至少一个本地模型
• 已退出 Claude Code 账号登录

/logout

应显示：

❯ /logout                                                                                                                                                   
Successfully logged out from your Anthropic account.

                                                                                                                                       

---

3. 验证 LM Studio 是否工作

PowerShell 中执行：

$token = "你的 LM Studio token"
$body = @{
  model = "google/gemma-4-26b-a4b"
  max_tokens = 64
  messages = @(
    @{
      role = "user"
      content = "hello"
    }
  )
} | ConvertTo-Json -Depth 10

Invoke-RestMethod `
  -Method Post `
  -Uri "http://localhost:1234/v1/messages" `
  -Headers @{
    "Authorization" = "Bearer $token"
    "Content-Type" = "application/json"
  } `
  -Body $body

如果成功返回 message、content、usage.input_tokens 等字段，说明 LM Studio 端正常。

---

4. 配置 Claude Code 全局连接 LM Studio

编辑这个文件：

C:\Users\你的用户名\.claude\settings.json

内容建议写成：

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:1234/",
    "ANTHROPIC_AUTH_TOKEN": "你的 LM Studio token"
  },
  "model": "google/gemma-4-26b-a4b"
}

保存后，打开新终端，在任意目录执行：

claude

如果顶部显示的是你指定的本地模型名，说明配置生效了。

---

5. 避免认证冲突

不要同时设置：

• ANTHROPIC_AUTH_TOKEN
• ANTHROPIC_API_KEY

如果之前配过旧环境变量或旧设置，容易出现：

Auth conflict: Both a token (ANTHROPIC_AUTH_TOKEN) and an API key (ANTHROPIC_API_KEY) are set.

解决方法是只保留 ANTHROPIC_AUTH_TOKEN，不要再保留旧的 ANTHROPIC_API_KEY。

---

6. 热切换模型

先在 LM Studio 中加载需要的模型：

lms load "google/gemma-4-26b-a4b" --ttl 3600
lms load "qwen3.5-9b-claude-4.6-highiq-instruct-heretic-uncensored" --ttl 3600
lms load "openai/gpt-oss-20b" --ttl 3600

查看当前已加载模型：

lms ps

在 Claude Code 会话中热切换：

/model google/gemma-4-26b-a4b
/model qwen3.5-9b-claude-4.6-highiq-instruct-heretic-uncensored
/model openai/gpt-oss-20b

---

7. 不改 LM Studio 模型名的快捷方案

Claude Code 本身不支持你自定义模型别名映射。

如果你不想修改 LM Studio 模型名，可以在 PowerShell 的 $PROFILE 里加快捷命令：

function cc-gemma4 { claude --model "google/gemma-4-26b-a4b" }
function cc-code { claude --model "qwen3.5-9b-claude-4.6-highiq-instruct-heretic-uncensored" }
function cc-gptoss { claude --model "openai/gpt-oss-20b" }

这样以后直接执行：

cc-gemma4
cc-code
cc-gptoss

---

8. 推荐的日常模型分工

• cc-code: 代码主力
• cc-think: 大模型推理
• cc-fast: 快速问答

示例：

function cc-fast { claude --model "meta-llama-3.1-8b-instruct-128k" }
function cc-code { claude --model "qwen3.5-9b-claude-4.6-highiq-instruct-heretic-uncensored" }
function cc-think { claude --model "google/gemma-4-26b-a4b" }

---

9. 推荐链接

• Claude Code 设置文档: https://docs.claude.com/en/docs/claude-code/settings

• Claude Code 模型配置文档: https://docs.claude.com/en/docs/claude-code/model-config

• LM Studio Claude Code 集成文档: https://lmstudio.ai/docs/integrations/claude-code

• LM Studio CLI 文档: https://lmstudio.ai/docs/cli

• LM Studio lms load 文档: https://lmstudio.ai/docs/cli/local-models/load