Ollama 接入 Claude Code 與 Codex 教學：ollama launch 一條命令、手動配置與上下文設定

適用於誰

• 搜「ollama claude code」「ollama launch claude」「ollama launch codex」的人；
• 已經在用 Claude Code 或 Codex，想試試讓它們跑在本地模型或 Ollama 雲端模型上的人。

本文根據 Ollama 官方文檔整理，資料核對於 2026-10-11。前提是已經裝好 Ollama，見《Ollama怎麼用》。Claude Code 和 Codex 本身的用法見站內對應的入門教學。

需要先說明一點：這是 Ollama 官方提供的接入方式，讓這兩個工具改用 Ollama 提供的模型，效果取決於你選的模型。開源模型在複雜的編程任務上與原廠模型有差距，本文不做效果承諾。

結論先說

1. 最快的方式是一條命令：在項目目錄裏執行 ollama launch claude 或 ollama launch codex，按提示選模型。
2. 原理是兼容接口：Ollama 官方說明它通過 Anthropic 兼容的 API，把 Claude Code 連接到本地模型和雲端模型。
3. 上下文長度要夠。官方要求：選擇上下文足夠容納你的代碼倉庫的模型；較大的倉庫把上下文設到 64k 或更高。Codex 文檔寫的是至少 64k。
4. 本地顯存不夠，可以用 Ollama 的雲端模型（模型名帶 :cloud），不用下載，但需要登入 Ollama 帳號。
5. 報錯先查兩樣：模型是否支持工具調用；上下文長度是否太小。

步驟

1. 用 ollama launch 啟動 Claude Code

在你的項目目錄裏：

bash
ollama launch claude

官方說明，沒有安裝 Claude Code 時 Ollama 會詢問是否安裝；然後讓你選擇模型。進入之後可以先試一句：

Explain how this repository is organized.

常用的變體：

bash
ollama launch claude --model 模型名     # 直接指定模型
ollama launch claude --config           # 只配置，不啟動
ollama launch                           # 交互式選擇要啟動的工具

官方文檔列出通過 Ollama 使用 Claude Code 時可用的能力：對話、執行命令（沿用 Claude Code 的權限確認流程）、工具調用、讀寫項目文件、子智能體、通過 Ollama 進行網頁搜尋和網頁抓取、發送圖片和截圖、思考控制。其中工具調用和思考需要模型本身支持。

2. 選模型

官方給了兩條路：

• 雲端模型：不用下載就能用更大的模型，模型名以 :cloud 結尾。需要先 ollama signin 登入；
• 本地模型：選一個模型，並把上下文窗口設到 64k 以上。

本地模型能選多大，取決於顯存，判斷方法見《本地大模型怎麼選》。要特別注意的是，上下文設到 64k 會明顯增加顯存佔用，原來剛好能裝下的模型可能就裝不下了。

3. 把上下文長度調到 64k

Ollama 的預設上下文按顯存自動選擇，顯存不足 24 GiB 時預設只有 4k，對編程工具來說遠遠不夠。官方文檔明確寫着：聯網搜尋、智能體和編程工具這類需要大上下文的任務，應當設定到至少 64000。

兩種改法：

• 桌面應用：在設定裏拖動上下文長度滑塊；
• 啟動服務時指定：

bash
OLLAMA_CONTEXT_LENGTH=64000 ollama serve

改完用 ollama ps 確認 CONTEXT 一列的數值，同時看 PROCESSOR 是否還是 100% GPU。

4. 手動配置 Claude Code（不用 launch）

想自己掌控配置，或者 Claude Code 已經裝好了，可以手動設定三個環境變量：

bash
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434
claude --model 模型名

也可以寫成一行，只對這一次啟動生效：

bash
ANTHROPIC_AUTH_TOKEN=ollama ANTHROPIC_BASE_URL=http://localhost:11434 ANTHROPIC_API_KEY="" claude --model 模型名

Windows PowerShell 裏用 $env:變量名 = "值" 的寫法逐個設定。

官方提醒：Claude Code 的設定文件可能覆蓋終端裏的環境變量。如果連不上，檢查設定裏是否寫了別的 base URL 或憑據，然後在 Claude Code 裏執行 /status 查看當前連接。

想恢復成使用 Anthropic 官方服務，去掉這幾個環境變量（並檢查設定文件）重新啟動即可。

5. 不裝 Ollama，直連 Ollama 雲端

官方文檔還給了不經過本機 Ollama 的寫法。先在 ollama.com 創建 API Key 並放進 OLLAMA_API_KEY：

bash
ANTHROPIC_BASE_URL=https://ollama.com \
ANTHROPIC_AUTH_TOKEN="$OLLAMA_API_KEY" \
ANTHROPIC_API_KEY="" \
claude --model 雲端模型名

官方說明要選支持工具調用的雲端模型；基本的對話和文件編輯在兼容的模型上可用，但託管的 WebSearch 和高級的工具控制沒有被完整支持。

6. 啟動 Codex

先安裝 Codex CLI：

bash
npm install -g @openai/codex

然後：

bash
ollama launch codex

官方說明，通過這條命令啟動時，Ollama 會刷新模型目錄，並為這次會話使用一個專用的 Codex 配置。相關命令：

bash
ollama launch codex --config     # 只配置不啟動
ollama launch codex --restore    # 移除 Ollama 生成的配置和模型目錄

手動方式是用 Codex 的 --oss 參數：

bash
codex --oss                 # 使用 Ollama
codex --oss -m 模型名       # 指定模型（雲端模型同樣用帶 :cloud 的名字）

需要長期固定的配置時，官方文檔給出了在 ~/.codex/ 下創建專用配置文件的寫法，字段以官方文檔為準。

7. 在腳本和 CI 裏無交互運行

bash
ollama launch claude --model 模型名 --yes -- -p "how does this repository work?"

官方對這條命令的解釋：--yes 會跳過所有選擇介面、在需要時自動拉取模型，並且必須同時指定 --model；-- 之後的參數原樣傳給 Claude Code。

常見問題

Q：報錯或者模型不調用工具、不改文件？

先確認所選模型支持工具調用（在 Ollama 模型庫頁面上帶有 tools 標記）。不支持工具調用的模型只能聊天，沒法讀寫文件和執行命令。

Q：回答到一半開始胡言亂語，或者忘了前面的內容？

多半是上下文太小。按第 3 步調到 64k 以上，並用 ollama ps 確認生效。

Q：速度很慢？

看 ollama ps 的 PROCESSOR 一列。出現 CPU 和 GPU 的比例說明顯存不夠，一部分在用內存跑。換小一檔的模型，或者改用雲端模型。

Q：用雲端模型，代碼會被上載嗎？

會發送到 Ollama 的雲端處理。Ollama 官方 FAQ 的說法是：使用雲端模型時會處理提示詞和回覆以提供服務，但不存儲、不記錄這些內容，也不用於訓練。公司代碼是否允許這樣用，按你們自己的規定判斷。完全不想出本機，就只用本地模型，並可以設定 OLLAMA_NO_CLOUD=1。

Q：Claude Code 的權限確認還在嗎？

在。官方文檔說明執行命令仍然走 Claude Code 的權限流程。不要為了省事在自己的電腦上使用跳過權限確認的參數，官方文檔提到這個參數時限定的是「隔離環境」。

Q：除了這兩個，還能接什麼？

官方 CLI 文檔列出的 ollama launch 支持的工具包括 OpenCode、Claude Code、Codex、VS Code、Droid 等，以你安裝的版本為準。

參考資料

• Ollama 文檔：Claude Code — https://docs.ollama.com/integrations/claude-code
• Ollama 文檔：Codex CLI — https://docs.ollama.com/integrations/codex
• CLI Reference（ollama launch）— https://docs.ollama.com/cli
• Context length — https://docs.ollama.com/context-length
• Cloud — https://docs.ollama.com/cloud