开心每一天

主题

Claude Code 的安装和使用 ​

官方文档：https://code.claude.com/docs/zh-CN/overview

安装 ​

安装方式有很多，Terminal、VS Code、Desktop App、Web、JetBrains 等，其中有些需要单独安装 Claude Code, 如：JetBrains IDEA。

为避免不必要的麻烦，建议通过 Terminal 安装，省心。

macOS, Linux, WSL:

shell
curl -fsSL https://claude.ai/install.sh | bash

Windows（依赖 git, 提前安装好 git）:

shell
# 检查 git
git --version

# powershell（亲测报错，不知道为啥。 2026-04）
irm https://claude.ai/install.ps1 | iex

# cmd（亲测报错，不知道为啥。2026-04）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

也可以使用 NPM 安装（安装了 nodejs 的话，推荐用这个安装）

shell
# 设置国内镜像源（推荐，加速下载）
npm config set registry https://registry.npmmirror.com

npm install -g @anthropic-ai/claude-code

验证是否安装成功

shell
claude --version

若提示找不到 claude 命令，尝试把 claude 添加到环境变量。

默认 claude code 默认使用 Anthropic 的云端 API，可能需要付费。

这里改用 docker 跑 ollama 容器，拉取 qwen3.5:9b 模型。

假设你已经用 docker 启动了 ollama 容器，并且已经拉取了 qwen3.5:9b 模型。

配置 ​

文档：https://code.claude.com/docs/zh-CN/settings

模型配置：https://code.claude.com/docs/zh-CN/model-config

settings.json 文件是通过分层设置配置 Claude Code 的官方机制。

用户设置在 ~/.claude/settings.json 中定义，适用于所有项目。

settings.json 配置文件路径示例：

  • Windows：C:\Users\<用户名>\.claude\settings.json
  • Mac：~/.claude/settings.json 或 .claude/settings.json
  • Linux：~/.claude/settings.json

配置 Ollama 跑的 qwen3.5:9b 模型如下：

json
{
  "env": {
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_AUTH_TOKEN": "ollama",
    "ANTHROPIC_BASE_URL": "http://192.168.188.139:11434",
    "ANTHROPIC_MODEL": "qwen3.5:9b"
  }
}

ANTHROPIC_API_KEY 保持为空非常重要。需要清空官方 Key 变量，防止冲突。 ANTHROPIC_AUTH_TOKEN 固定值为 ollama。可参考 ollama 文档。 ANTHROPIC_BASE_URL 设置 ollama 服务的 IP 地址和端口号。 ANTHROPIC_MODEL (可选) 指定模型。

使用 ​

在任何项目目录中打开您的终端并启动 Claude Code：

shell
cd /path/to/your/project

claude

如果前面的安装和配置都没问题，这里就可以正常进入 Claude Code 了。

第一次启动 Claude Code 时，通常会看到下面几个引导步骤：

  • 选择主题 → 选择你喜欢的主题后按 Enter
  • 安全须知 → 确认安全须知后按 Enter
  • Terminal 配置 → 使用默认配置后按 Enter
  • 工作目录信任 → 信任当前目录

这些步骤基本按提示操作就行，不复杂。

走完之后，你就可以正式开始使用 Claude Code 了。

您将看到 Claude Code 欢迎屏幕，其中包含您的会话信息、最近的对话和最新更新。

输入 /help 查看可用命令，或输入 /resume 继续之前的对话。

shell
# 提出您的第一个问题
这个项目是做什么的？

基本命令 ​

以下是日常使用中最重要的命令：

命令功能示例
claude启动交互模式claude
claude "task"运行一次性任务claude "fix the build error"
claude -p "query"运行一次性查询，然后退出claude -p "explain this function"
claude -c在当前目录中继续最近的对话claude -c
claude -r恢复之前的对话claude -r
claude commit创建 Git 提交claude commit
/clear清除对话历史/clear
/help显示可用命令/help
exit 或 Ctrl+C退出 Claude Codeexit

Intellij Idea 中使用 Claude Code plugin 调用 Ollama qwen2.5-coder:7b 模型 ​

Intellij Idea 中使用 Claude Code plugin，需要单独先安装好 Claude Code。

拉取模型 ​

shell
docker exec -it ollama ollama pull qwen2.5-coder:7b

Claude Code 默认会连接 Anthropic 的云端 API，但我们可以通过 settings.json 配文件，或者直接配置到环境变量，强制它将请求重定向到本地的 Ollama 服务。

Claude Code 设置 ​

~/.claude/settings.json

json
{
  "env": {
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_AUTH_TOKEN": "ollama",
    "ANTHROPIC_BASE_URL": "http://192.168.188.139:11434",
    "ANTHROPIC_MODEL": "qwen2.5-coder:7b"
  }
}

或者将以上配置复制到环境变量。

点击“确定”保存，然后 重启 IntelliJ IDEA 使变量生效。

安装并配置 IDEA 插件 ​

在 IDEA 中，打开 File → Settings (Windows/Linux) 或 IntelliJ IDEA → Preferences (macOS)。

选择 Plugins → Marketplace。

搜索 Claude Code，找到官方插件并点击 Install。

安装完成后，重启 IntelliJ IDEA。

重启后，插件会自动应用你在系统里设置的环境变量，并连接到你的本地 Ollama 服务。

验证连接 ​

插件配置完成后，可以通过以下方式验证连接是否成功：

在 IDEA 中测试：打开 Claude Code 插件面板（通常在右侧边栏），输入 "Hello" 或 "列出当前项目文件" 等简单指令，看是否能得到来自 qwen2.5-coder:7b 模型的正常回复。