claude code保姆级安装说明
御清弦
御清弦 Lv.8
2025年12月6日
字数：5696，阅读约19分钟

claude code保姆级安装说明

工具
72
0
0
一言准备中...

Claude Code 安装指南（2026年最新版）

系统要求

最低配置

  • 内存: 4GB RAM 或以上
  • 网络: 需要活跃的互联网连接
  • 操作系统:
    • Windows 10+ (支持 WSL 或 Git Bash)
    • macOS 10.15+
    • Linux (Ubuntu 20.04+/Debian 10+, Alpine)

前置依赖

  • Node.js: LTS 版本（推荐最新 LTS）
  • npm: 随 Node.js 一起安装

第一步：检查和安装 Node.js

1.1 检查现有 Node.js 版本

打开命令提示符或终端，运行以下命令：

node --version
npm --version

1.2 如果未安装 Node.js

访问 Node.js 官方网站，下载并安装最新 LTS 版本。

1.3 验证安装

安装完成后，重新运行上述命令确认版本号显示正确。
打开 Git Bash / 终端，执行以下命令验证安装情况：

$ node -v
$ npm -v

第二步：安装 Claude Code CLI

2.1 Windows 用户 - PowerShell 方法

在 PowerShell 中运行以下命令：

irm https://claude.ai/install.ps1 | iex

2.2 Windows 用户 - CMD 命令行方法

使用 CMD 命令行运行以下命令：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

2.3 Windows 用户 - Git Bash 方法（推荐）

步骤 1：打开 Git Bash

  1. 在 Windows 资源管理器中打开任意文件夹
  2. 右键点击空白处
  3. 选择 "Git Bash Here"
  4. 或从开始菜单搜索并打开 "Git Bash"

步骤 2：在 Git Bash 中安装 Claude Code

在 Git Bash 终端中运行以下命令：

$ npm install -g @anthropic-ai/claude-code
//或者
curl -fsSL https://claude.ai/install.sh | bash

//如果已安装，卸载已安装的Claude Code（未安装请跳过）
$ npm uninstall -g @anthropic-ai/claude-code

步骤 3：验证安装

claude --version

应该显示类似输出：

Claude Code version X.X.X

步骤 4：配置中转 API

Mac / Linux 用户

步骤 1：打开终端

在终端中执行以下命令创建配置文件：

vim ~/.claude/settings.json

步骤 2：添加配置内容

在 vim 编辑器中按 i 进入插入模式，然后粘贴以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "粘贴为claude code专用分组令牌key",
    "ANTHROPIC_BASE_URL": "https://aicodeditor.com",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

步骤 3：保存并退出

  • 按 Esc 键退出插入模式
  • 输入 :wq 并按 Enter 保存并退出

步骤 4：验证配置

cat ~/.claude/settings.json
Windows 用户

步骤 1：打开 Git Bash 终端

  1. 在 Windows 资源管理器中打开任意文件夹
  2. 右键点击空白处
  3. 选择 "Git Bash Here"

步骤 2：创建配置文件

在 Git Bash 终端中执行以下命令：

vim ~/.claude/settings.json

步骤 3：添加配置内容

在 vim 编辑器中按 i 进入插入模式，然后粘贴以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "粘贴为claude code专用分组令牌key",
    "ANTHROPIC_BASE_URL": "https://aicodeditor.com",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

步骤 4：保存并退出

  • 按 Esc 键退出插入模式
  • 输入 :wq 并按 Enter 保存并退出

步骤 5：验证配置

cat ~/.claude/settings.json
配置参数说明
参数 说明 示例
ANTHROPIC_AUTH_TOKEN Claude Code 专用分组令牌密钥 sk-ant-xxxxx
ANTHROPIC_BASE_URL 中转 API 的基础 URL https://aicodeditor.com
CLAUDE_CODE_MAX_OUTPUT_TOKENS 最大输出令牌数 32000
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 禁用非必要流量（1=启用，0=禁用） 1
常见问题

问题 1：如何获取 ANTHROPIC_AUTH_TOKEN？

  1. 访问 Anthropic 控制台
  2. 进入 API 密钥管理
  3. 创建新的专用分组令牌
  4. 复制令牌并粘贴到配置文件中

问题 2：配置后需要重启吗？

是的，修改配置文件后需要重启 Claude Code：

# 关闭当前 Claude Code 会话
exit

# 重新启动 Claude Code
claude

问题 3：如何验证中转 API 是否生效？

# 查看 Claude Code 的日志
claude --debug

# 或检查环境变量是否正确加载
echo $ANTHROPIC_BASE_URL

步骤 5：配置 PATH（如果需要）

如果 claude 命令无法识别，需要将 Claude Code 添加到 PATH：

# 检查 Claude Code 安装位置
ls ~/.claude/bin/

# 添加到 PATH（临时）
export PATH="$HOME/.claude/bin:$PATH"

# 永久添加到 PATH，编辑 ~/.bashrc 或 ~/.bash_profile
echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

2.4 macOS 和 Linux 用户

在终端中运行以下命令：

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

2.5 验证安装

安装完成后，运行以下命令验证：

claude --version

Claude Code 应该被安装在以下位置之一：

  • Windows: %USERPROFILE%\.claude\bin\claude
  • macOS/Linux: ~/.claude/bin/claude 或 ~/.local/bin/claude

第三步：身份验证和配置

3.1 初始化配置

运行以下命令启动配置过程：

claude config

3.2 选择身份验证方式

系统会提示你选择以下身份验证方式之一：

选项 A：使用 API 密钥

  1. 访问 Anthropic Console
  2. 登录你的账户
  3. 导航到 API 密钥部分
  4. 创建新的 API 密钥
  5. 复制密钥并粘贴到 Claude Code 配置中

选项 B：使用 OAuth

  1. 选择 OAuth 选项
  2. 浏览器会自动打开 Anthropic 登录页面
  3. 使用你的 Anthropic 账户登录
  4. 授权 Claude Code 访问权限
  5. 返回终端完成配置

3.3 保存配置

配置完成后，你的凭证将被安全地保存在本地。

第四步：项目初始化

4.1 创建或进入项目目录

mkdir my-project
cd my-project

4.2 初始化 Claude Code 项目

claude init

这将在项目目录中创建必要的配置文件。

第五步：启动第一个会话

5.1 开始交互式会话

claude

5.2 提出你的第一个问题

在提示符处输入你的问题或代码请求，例如：

> 帮我创建一个 Hello World 的 Python 脚本

5.3 查看 Claude 的响应

Claude 会提供代码建议和解释。

第六步：代码修改和文件操作

6.1 让 Claude 修改文件

你可以要求 Claude 创建或修改文件：

> 在 app.py 中添加一个计算器函数

6.2 审查更改

Claude 会显示建议的更改，你可以：

  • 接受更改
  • 拒绝更改
  • 要求修改

6.3 自动应用更改

确认后，Claude 会自动将更改应用到你的文件。

第七步：Git 集成

7.1 初始化 Git 仓库

如果项目还没有 Git 仓库，运行：

git init

7.2 使用 Claude 进行版本控制

Claude Code 可以帮助你：

  • 创建有意义的提交信息
  • 管理分支
  • 解决合并冲突

7.3 示例

> 帮我提交这些更改，提交信息为"添加用户认证功能"

第八步：高级配置（可选）

8.1 配置编辑器集成

Claude Code 支持与以下编辑器集成：

  • VS Code
  • Vim
  • Neovim
  • Emacs

8.2 设置模型偏好

claude config --model claude-opus-4-5

8.3 配置输出格式

根据需要调整输出格式和详细程度。

常见问题排查

问题 1：命令未找到 (Command not found)

解决方案：

  • 确保 Node.js 已正确安装
  • 重启终端或命令提示符
  • 检查 PATH 环境变量是否包含 Claude Code 安装目录

问题 2：身份验证失败

解决方案：

  • 确保网络连接正常
  • 验证 API 密钥或 OAuth 凭证是否正确
  • 运行 claude config 重新配置

问题 3：权限被拒绝 (Permission Denied)

解决方案：

  • 在 macOS/Linux 上，运行 chmod +x ~/.claude/bin/claude
  • 确保有足够的文件系统权限

问题 4：内存不足

解决方案：

  • 关闭其他应用程序
  • 升级系统内存
  • 检查是否有其他进程占用大量资源

问题 5：无法连接到 Anthropic 服务

解决方案：

  • 找到.claude.json文件，位置：C:\Users\用户名
  • 输入
  • "hasCompletedOnboarding": true（）//注意需不需要逗号

更新 Claude Code

检查更新

claude --version

更新到最新版本

claude update

或重新运行安装命令。

卸载 Claude Code

Windows 用户 - PowerShell 方法

Remove-Item -Path $env:USERPROFILE\.claude -Recurse -Force

Windows 用户 - Git Bash 方法（推荐）

步骤 1：打开 Git Bash

  1. 在 Windows 资源管理器中打开任意文件夹
  2. 右键点击空白处
  3. 选择 "Git Bash Here"
  4. 或从开始菜单搜索并打开 "Git Bash"

步骤 2：在 Git Bash 中卸载 Claude Code

在 Git Bash 终端中运行以下命令：

# 删除 Claude Code 安装目录
rm -rf ~/.claude

# 删除本地 bin 目录中的 Claude Code（如果存在）
rm -rf ~/.local/bin/claude

# 清理配置文件（可选）
rm -rf ~/.claude-config

步骤 3：验证卸载

# 检查 claude 命令是否仍然存在
which claude

如果显示 "not found" 或无输出，说明卸载成功。

步骤 4：清理 PATH（可选）

如果之前手动添加了 PATH，需要清理：

# 编辑 ~/.bashrc 文件
nano ~/.bashrc

# 找到并删除以下行：
# export PATH="$HOME/.claude/bin:$PATH"

# 保存并退出（Ctrl+O, Enter, Ctrl+X）

# 重新加载配置
source ~/.bashrc

macOS/Linux 用户

# 删除 Claude Code 安装目录
rm -rf ~/.claude

# 删除本地 bin 目录中的 Claude Code
rm -rf ~/.local/bin/claude

# 清理配置文件（可选）
rm -rf ~/.claude-config

验证卸载

运行以下命令确认卸载成功：

claude --version

如果显示 "command not found" 或类似错误，说明卸载成功。

完全卸载（包括所有配置和缓存）

如果需要完全删除所有 Claude Code 相关文件：

Git Bash 方法

# 删除所有 Claude Code 相关目录
rm -rf ~/.claude
rm -rf ~/.local/bin/claude
rm -rf ~/.claude-config
rm -rf ~/.cache/claude*
rm -rf ~/.config/claude*

# 清理环境变量（如果有）
unset CLAUDE_API_KEY
unset CLAUDE_HOME

PowerShell 方法

# 删除所有 Claude Code 相关目录
Remove-Item -Path $env:USERPROFILE\.claude -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item -Path $env:USERPROFILE\.local\bin\claude -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item -Path $env:USERPROFILE\.claude-config -Recurse -Force -ErrorAction SilentlyContinue

# 清理环境变量
[Environment]::SetEnvironmentVariable("CLAUDE_API_KEY", $null, "User")
[Environment]::SetEnvironmentVariable("CLAUDE_HOME", $null, "User")

获取帮助

查看帮助信息

claude --help
claude <command> --help

官方资源

报告问题

如果遇到问题，请在 GitHub 上报告：
https://github.com/anthropics/claude-code/issues

下一步

安装完成后，你可以：

  1. 探索示例项目 - 查看官方示例了解 Claude Code 的功能
  2. 阅读文档 - 深入了解高级功能
  3. 加入社区 - 与其他用户分享经验和最佳实践
  4. 开始编码 - 在你的项目中使用 Claude Code

最后更新: 2026年1月14日
版本: Claude Code 最新版本

  • 本文作者：御清弦
  • 本文链接： https://12580.wang/ccbmjazym
  • 版权声明：本博客所有文章除特别声明外，均默认采用 CC BY-NC-SA 4.0 许可协议。
注:本站所有资源均来自互联网，仅供学习和参考，并无任何盈利目的，如果购买到本到资源请及时差评。如有任何违规和侵权，请联系本人删除，谢谢_(:з」∠)_
文章很赞！支持一下吧 还没有人为TA充电
为TA充电
还没有人为TA充电
0
0
  • 支付宝打赏
    支付宝扫一扫
  • 微信打赏
    微信扫一扫
感谢支持
文章很赞！支持一下吧
关于作者
御清弦
御清弦 Lv.8
11
0
0
1
忌妒别人，不会给自己增加任何的好处。忌妒别人，也不可能减少别人的成就。

口袋妖怪全技能中日英名称对照及效果说明

上一篇

你是防御性还是进攻性

下一篇
TV电视免费观影方案-影视仓下载+订阅源（持续更新）封面
工具TV电视免费观影方案-影视仓下载+订阅源（持续更新）
御清弦御清弦
2026年1月2日
手搓的续费提示app封面
工具手搓的续费提示app
御清弦御清弦
2026年1月11日
评论区
内容为空

这一切，似未曾拥有

icp备案 京ICP备19023573号 本站一些文章来自互联网收集，仅供用于学习和交流，请遵循相关法律法规。
本站一切资源不代表本站立场，如有侵权/违规/不妥请联系本站删除，敬请谅解。
Copyright © 2025
sitemap
繁
  • 更多按钮添加，前往
    页面设置 - 浮动按钮
  • 复制图片
  • 复制图片地址
按住ctrl可打开默认菜单