aigcbar - null

Claude Code国内最全使用教程：Windows/macOS/Linux保姆级安装指南（超详细）

type
status
date
slug
summary
tags
category
icon
password
网址
notion image
本篇教程为希望在国内使用 AI 编程神器 Claude Code 的开发者提供了终极解决方案。我们为您准备了覆盖 Windows、macOS 和 Linux三大操作系统的完整图文安装与配置指南，通过使用国内 api.aigcW.bar 站点，彻底解决了网络访问和API密钥获取难题。教程内容从环境准备、Node.js 安装，到详细的环境变量配置，再到启动使用、常用命令和高级技巧，手把手教您完成所有步骤，让您无需复杂操作即可免费、稳定地体验 Claude Code 强大的代码生成、审查和自动化能力，助您大幅提升开发效率。

本文目录

本文目录📋 通用要求🔑 Claude Code API 站点选择与配置详细说明前往API站点注册账号，获取 Auth Token🪟 Windows 安装教程系统要求安装步骤1. 安装 Node.js2. 安装 Claude Code3. 验证安装Windows 环境变量配置方法一：图形化配置（推荐，永久生效）方法二：CMD临时设置🍎 macOS 安装教程系统要求安装步骤1. 安装 Homebrew（推荐）2. 安装 Node.js3. 安装 Claude Code4. 验证安装macOS 环境变量配置方法一：使用 Bash（推荐）方法二：使用 Zsh（如果使用 Oh My Zsh）方法三：临时设置🐧 Linux 安装教程系统要求安装步骤1. 安装 Node.js2. 安装 Claude Code3. 验证安装Linux 环境变量配置方法一：Ubuntu/Debian (Bash)方法二：Fedora/CentOS (Zsh 用户)方法三：临时设置🚀 启动和使用基本启动首次启动配置测试连接📝 常用命令参考基础命令交互模式命令内置斜杠命令🛠️ 高级功能IDE 集成Cursor 集成集成功能团队规范配置MCP 服务器扩展🎯 实战场景1. 基础代码生成2. 代码审查和修复3. 自动化 Git 操作4. 批量处理文件❓ 常见问题解决问题排查指南常见问答📚 其他功能CI/CD 集成示例SDK 集成示例

📋 通用要求

  • Node.js 18+ （所有系统必需）
  • 网络连接 （访问 API站点）
  • 终端/命令行工具

🔑 Claude Code API 站点选择与配置详细说明

前往API站点注册账号，获取 Auth Token

api.aigc.bar 为例子，访问 API站点：https://api.aigc.bar 注册账号后进行以下操作：
  1. 点击控制台 -> API令牌页面
notion image
2.点击"添加令牌"
notion image
3.令牌分组请选择：claudecode官转分组（务必选择此分组，否则无法使用）
notion image
4.复制令牌密钥，进行下一步操作

🪟 Windows 安装教程

系统要求

  • Windows 10 或 Windows 11
  • Node.js 18+
  • 网络连接

安装步骤

在正式安装前，您需要先安装 Git Bash：访问 Git 官网下载页面，选择适合您 Windows 系统的安装包，然后按照提示完成安装。Git Bash 将为您提供类似 Linux 的命令行环境，便于后续操作。

1. 安装 Node.js

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

2. 安装 Claude Code

打开命令提示符(CMD)或 PowerShell，运行：

3. 验证安装

Windows 环境变量配置

重要提示：请将下方的 sk-xxx 替换为您在 api.aigc.bar 生成的实际 API 密钥！

方法一：图形化配置（推荐，永久生效）

  1. 右键点击"此电脑" → 选择"属性"
  1. 点击"高级系统设置"
  1. 在"系统属性"窗口中点击"环境变量"
  1. 重要：在"系统变量"部分点击"新建"
  1. 添加以下两个变量：
      • 变量名：ANTHROPIC_AUTH_TOKEN，变量值：sk-xxx
      • 变量名：ANTHROPIC_BASE_URL，变量值：https://api.aigc.bar
  1. 点击"确定"保存
notion image
7.重启终端
⭐设置完成后务必重启终端！！！

方法二：CMD临时设置

🍎 macOS 安装教程

系统要求

  • macOS 10.15 (Catalina) 或更高版本
  • Node.js 18+
  • 网络连接

安装步骤

在安装 Claude Code 前，您需要确保系统已安装 Git。请访问 Git 官方下载页面，选择适合您操作系统的版本并完成安装。Git 不仅提供版本控制功能，还为您提供 Git Bash 这一命令行工具，它在 Claude Code 的安装和使用过程中非常有用。

1. 安装 Homebrew（推荐）

如果尚未安装 Homebrew：

2. 安装 Node.js

使用 Homebrew：
或从 Node.js 官网 下载安装包。

3. 安装 Claude Code

4. 验证安装

macOS 环境变量配置

方法一：使用 Bash（推荐）

方法二：使用 Zsh（如果使用 Oh My Zsh）

方法三：临时设置

🐧 Linux 安装教程

系统要求

  • Linux 发行版 (Ubuntu 18.04+, CentOS 7+, Debian 9+)
  • Node.js 18+
  • 网络连接

安装步骤

1. 安装 Node.js

Ubuntu/Debian：
CentOS/RHEL/Fedora：
Arch Linux：

2. 安装 Claude Code

3. 验证安装

Linux 环境变量配置

方法一：Ubuntu/Debian (Bash)

方法二：Fedora/CentOS (Zsh 用户)

方法三：临时设置

🚀 启动和使用

基本启动

首次启动配置

  1. 选择喜欢的主题（回车）
  1. 确认安全须知（回车）
  1. 使用默认 Terminal 配置（回车）
  1. 信任工作目录（回车）
  1. 开始编程！🚀

测试连接

📝 常用命令参考

基础命令

命令
功能
示例
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
清除对话历史记录
/help
显示可用命令
exit 或 Ctrl+C
退出 Claude Code

内置斜杠命令

命令
用途
/add-dir
添加额外的工作目录
/bug
报告错误
/clear
清除对话历史
/config
查看/修改配置
/cost
显示令牌使用统计
/doctor
检查安装健康状况
/help
获取使用帮助
/init
使用 CLAUDE.md 初始化项目
/login
切换 Anthropic 账户
/logout
登出账户
/mcp
管理 MCP 服务器连接
/memory
编辑 CLAUDE.md 内存文件
/model
选择或更改 AI 模型
/permissions
查看或更新权限
/review
请求代码审查
/status
查看账户和系统状态
/vim
进入 vim 模式

🛠️ 高级功能

IDE 集成

Cursor 集成

  1. 在 Cursor 中安装 Claude Code 扩展
  1. 在集成终端中运行 claude
  1. 输入 /ide 选择 Cursor 作为链接的 IDE

集成功能

  • 差异查看：代码更改直接在 IDE 差异查看器中显示
  • 选择上下文：IDE 中的当前选择/标签页自动与 Claude Code 共享
  • 诊断共享：IDE 中的诊断错误自动与 Claude 共享

团队规范配置

创建 CLAUDE.md 文件来定义团队规范：

MCP 服务器扩展

添加 MCP 服务器来扩展 Agent 能力：

🎯 实战场景

1. 基础代码生成

2. 代码审查和修复

3. 自动化 Git 操作

4. 批量处理文件

❓ 常见问题解决

问题排查指南

遇到问题时，请按照以下步骤进行排查：
  1. API密钥配置：确保创建的密钥选择了无限额度，不限制模型，并选择了claudecode分组。
  1. 登录冲突处理：如果之前登录过官方Claude Code，请输入/logout命令退出后重新登录。
  1. 环境变量检查：确认BASE_URL设置为api.aigc.bar，并验证环境变量配置成功（Windows用户需要重启终端）。
notion image
  1. 技术支持：如果按照上述步骤仍无法解决问题，请联系站长获取技术支持帮助
  1. 模型切换：输入/model 可选择Claude最新模型 sonnet与opus。
  1. 上下文管理：遇到API返回400错误或reading 'filter'错误时，请使用/compact命令压缩上下文或开启新对话，这通常是因为上下文超过了Claude允许的最大上下文200K。
notion image
  1. 会话恢复：如果退出了Claude Code终端需要继续上次对话，请输入/resume命令。

常见问答

Q: 如何处理网络连接问题？
A:
  1. 检查 API 令牌是否正确配置
  1. 确认网络连接稳定
  1. 尝试使用代理服务
Q: 如何自定义 Claude Code 的行为？
A:
  1. 创建 CLAUDE.md 文件定义团队规范
  1. 使用环境变量配置不同的行为
  1. 集成 MCP 服务器扩展功能
Q: 如何在团队中使用 Claude Code？
A:
  1. 统一团队的 CLAUDE.md 规范文件
  1. 在 CI/CD 流程中集成 Claude Code
  1. 建立代码审查流程
Q: 如何处理大型项目？
A: Claude Code 的 200K 上下文可以处理大型项目：
  1. 自动索引全仓库文件
  1. 理解复杂依赖关系
  1. 支持增量处理

📚 其他功能

CI/CD 集成示例

SDK 集成示例

🎉 恭喜！ 您已完成 Claude Code 的完整安装配置。现在可以在任何操作系统上享受 AI 编程助手的强大功能！
💡 提示：建议将文件拖拽到对话框来上传文件或图片，让 Claude Code 更好地理解您的项目。
更多详细配置和使用技巧，请参考 Claude Code 官方文档。
 
Loading...

没有找到文章