用 ollama launch claude 一键启动 Claude Code 并自动连接本地 Ollama 模型,无需配置环境变量或修改 API 地址;需 Ollama v0.15.2+,自动列出已下载模型供选择,成功后输入 /model 可验证是否连通本地服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在本地快速启动 Claude Code 并直接调用 Ollama 托管的模型,无需手动配置环境变量、不改 shell 配置、不碰 API 地址,只用一条命令就能进入交互式编程会话。
用 ollama launch 一键启动
这是 Ollama v0.15+ 内置的最简路径,跳过所有中间环节,自动完成模型选择、服务绑定和会话初始化。
第一步:确保已安装 Ollama v0.15.2 或更高版本,运行 ollama --version 验证输出中包含 0.15 或以上数字。
第二步:在终端中执行以下命令:
ollama launch claude
命令执行后会自动检测本地已下载的模型,并列出可选列表(如 qwen2.5-coder:7b、glm-4.7-flash、devstral-small-2 等),用方向键选择一个,按回车确认。
第三步:等待几秒,终端将直接进入 Claude Code 的交互界面,顶部显示模型名称与当前工作路径,此时即可输入 /init 创建项目引导文件,或直接提问。
注意:该命令默认使用 http://localhost:11434 作为后端地址,【若你把 Ollama 改为监听其他端口(如 8080)或绑定了非 127.0.0.1 的 IP,此命令将失败】。此时必须改用手动配置方式。
手动配置后运行 claude 命令
适用于自定义模型路径、远程 Ollama 服务、或多模型切换场景。
方法一:临时环境变量方式(推荐测试用)
在终端中逐行执行:
$env:ANTHROPIC_AUTH_TOKEN = "ollama"
$env:ANTHROPIC_BASE_URL = "http://localhost:11434"
claude --model qwen2.5-coder:7b
这三行命令必须在同一 PowerShell 会话中连续执行,关闭窗口后失效,安全且无残留。
记录结构化的Claude Code轨迹、影子git diff,并在代理行为需要法医级调试而非临时转录审查时回放分支。
方法二:写入用户级环境变量(Windows)
打开「系统属性 → 高级 → 环境变量」→ 在「用户变量」区点击「新建」:
变量名:ANTHROPIC_AUTH_TOKEN,变量值:ollama
变量名:ANTHROPIC_BASE_URL,变量值:http://localhost:11434
变量名:ANTHROPIC_MODEL,变量值:qwen2.5-coder:7b(必须与 ollama list 中显示的名称完全一致)
保存后,**关闭并重新以管理员身份打开 PowerShell**,再运行 claude 即可直连。
方法三:通过 settings.json 文件配置(跨平台稳定方案)
创建或编辑文件:$HOME/.claude/settings.json(macOS/Linux)或 %USERPROFILE%\.claude\settings.json(Windows)
填入以下内容(注意 JSON 格式严格,引号不能用中文符号):
{ "env": { "ANTHROPIC_AUTH_TOKEN": "ollama", "ANTHROPIC_BASE_URL": "http://localhost:11434", "ANTHROPIC_MODEL": "qwen2.5-coder:7b" } }
保存后,在任意新终端中直接运行 claude 即可生效,无需重启 shell。
验证是否真正连上本地模型
启动成功后,在 Claude Code 会话中输入:
/model
观察返回信息——如果显示类似 Using model: qwen2.5-coder:7b (via Ollama) 或包含 localhost:11434 字样,说明已脱离 Anthropic 官方服务;若显示 opus、sonnet 或出现 API Error: 401 Unauthorized,则环境变量未生效或令牌被覆盖。
运行 curl http://localhost:11434/api/tags 可确认 Ollama 服务是否就绪,返回 JSON 列表即代表后端正常。

















