BioinfoArk + Claude Code 完全小白教程

从零开始，手把手教你使用 Claude Code 进行 AI 辅助编程

---

📖 目录

1. 什么是 Claude Code？
2. 为什么选择 BioinfoArk？
3. 开始前的准备
4. 第一步：安装 Claude Code
5. 第二步：获取 BioinfoArk API Key
6. 第三步：配置连接 BioinfoArk
7. 第四步：开始使用
8. 常见问题解答
9. 实用技巧

---

什么是 Claude Code？

Claude Code 是一个 AI 编程助手，它可以：

• ✍️ 帮你写代码 - 告诉它你想做什么，它就能写出代码
• 🔧 修改代码 - 直接修改你项目里的文件
• 🐛 找 Bug - 帮你找出代码中的问题并修复
• 📚 解释代码 - 看不懂的代码让它来解释
• 💡 提供建议 - 给你编程思路和最佳实践

简单来说：就像有一个 AI 编程老师坐在你旁边，随时帮你写代码、改代码、解释代码。

---

为什么选择 BioinfoArk？

Claude Code 默认需要：

• 🚫 科学上网（翻墙）
• 🚫 国外信用卡
• 🚫 每月订阅费用

使用 BioinfoArk 后：

• ✅ 国内直连 - 不需要翻墙，速度快
• ✅ 按需付费 - 用多少付多少，不用包月
• ✅ 配置简单 - 只需 2 行代码
• ✅ 支持最新模型 - Claude Opus 4、Sonnet 4.5 (推荐! 好用!)等

---

开始前的准备

你需要准备：

1. 一台电脑

   • Mac、Windows、Linux 都可以

2. 联网环境

   • 能正常上网即可，不需要翻墙

3. BioinfoArk 账号和 API Key

   • 如果还没有，继续往下看，我们会教你获取

4. 基本的电脑操作能力

   • 会打开"终端"或"命令提示符"
   • 会复制粘贴命令

什么是"终端"？

• Mac: 应用程序 → 实用工具 → 终端（Terminal）
• Windows: 搜索"PowerShell"或"命令提示符"
• Linux: 通常按 Ctrl+Alt+T 打开

不用紧张！我们会一步步教你输入命令。

---

第一步：安装 Claude Code

根据你的操作系统选择对应的安装方法。

🍎 macOS 用户

方法：打开终端安装（最简单）

1. 打开"终端"应用

   • 方式一：按 Command + 空格，输入 terminal，回车
   • 方式二：打开"应用程序" → "实用工具" → "终端"

2. 复制并粘贴以下命令，然后按回车：

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

   小提示：在终端中，用 Command + V 粘贴命令

3. 等待安装完成

   • 会看到一些文字在滚动，这是正常的
   • 等待出现"安装成功"或类似提示

4. 验证安装是否成功

   输入以下命令：

   claude --version

   如果看到版本号（比如 2.0.30），说明安装成功！✅

如果遇到权限问题

如果提示"权限不足"，在命令前加 sudo，并输入你的电脑密码：

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

---

🪟 Windows 用户

方法：使用 PowerShell 安装（最简单）

1. 打开 PowerShell

   • 按 Windows 键，输入 powershell
   • 右键点击"Windows PowerShell"
   • 选择 "以管理员身份运行"（重要！）

2. 复制并粘贴以下命令，然后按回车：

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

   小提示：在 PowerShell 中，用 Ctrl + V 或右键粘贴

3. 如果遇到安全提示

   可能会看到"无法运行脚本"的提示，这时需要先允许运行脚本：

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

   输入 Y 确认，然后重新运行安装命令。

4. 等待安装完成

   • 会看到进度提示
   • 等待出现"安装成功"

5. 验证安装是否成功

   输入以下命令：

   claude --version

   如果看到版本号（比如 2.0.30），说明安装成功！✅

---

🐧 Linux 用户

方法：使用终端安装

1. 打开终端

   • 通常按 Ctrl + Alt + T

2. 复制并粘贴以下命令，然后按回车：

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

3. 等待安装完成

4. 验证安装是否成功

   claude --version

   如果看到版本号，说明安装成功！✅

---

🔍 检查安装是否成功

不管你用的是什么系统，安装完成后都运行这个命令：

claude doctor

这个命令会检查你的安装是否正常。你应该看到类似这样的输出：

✓ Claude Code version: 2.0.30
✓ Installation type: native
✓ Configuration: OK

如果看到绿色的 ✓ 标记，恭喜你，安装成功！🎉

---

第二步：获取 BioinfoArk API Key

什么是 API Key？

API Key 就像是你的通行证，让 Claude Code 能够使用 BioinfoArk 的服务。

如何获取？

1. 访问 BioinfoArk 网站

   • 网址：密钥领取 & 点数充值

2. 领取密钥

   • 密钥免费领取哦
   • 但是正常使用需要充值点数

3. 充值点数

   • 确保账号里有足够的点数
   • 可以在【点数查询】页面查看余额

4. 保存好你的 API Key

   • ⚠️ 重要：API Key 就像密码，不要分享给别人！
   • 建议保存到一个安全的地方（比如密码管理器）

示例：你的 API Key 可能长这样：

sk-abc123def456ghi789jkl012mno345pqr678stu901vwx234

---

第三步：配置连接 BioinfoArk

现在我们要让 Claude Code 连接到 BioinfoArk 的服务。

方法一：临时配置（快速测试用）

如果你只是想快速试一下，用这个方法：

Mac/Linux 用户：

1. 打开终端

2. 设置 API 地址（复制粘贴这行命令）：

   export ANTHROPIC_BASE_URL=https://oa.ai01.org/claude

3. 设置你的 API Key（把下面的 你的API-Key 替换成真实的）：

   export ANTHROPIC_API_KEY=你的API-Key

   举例：如果你的 Key 是 sk-abc123，就输入：

   export ANTHROPIC_API_KEY=sk-abc123

4. 启动 Claude Code：

   claude

Windows 用户（PowerShell）：

1. 打开 PowerShell

2. 设置 API 地址：

   $env:ANTHROPIC_BASE_URL="https://oa.ai01.org/claude"

3. 设置你的 API Key（替换成你的真实 Key）：

   $env:ANTHROPIC_API_KEY="你的API-Key"

4. 启动 Claude Code：

   claude

注意：这种方法的配置只在当前窗口有效，关闭窗口后需要重新设置。

---

方法二：永久配置（推荐）

如果你想长期使用，建议用这个方法，配置一次就永久生效。

步骤 1：找到配置文件位置

配置文件的位置：

• Mac/Linux: ~/.claude/settings.json
• Windows: C:\Users\你的用户名\.claude\settings.json

步骤 2：创建或编辑配置文件

2.1 检查文件夹是否存在

Mac/Linux 用户，在终端输入：

mkdir -p ~/.claude

Windows 用户，在 PowerShell 输入：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"

2.2 创建配置文件

Mac/Linux 用户，在终端输入：

cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://oa.ai01.org/claude",
    "ANTHROPIC_API_KEY": "你的API-Key"
  },
  "model": "sonnet"
}
EOF

记得把 你的API-Key 替换成你真实的 API Key！

Windows 用户，可以用记事本创建：

1. 打开记事本

2. 复制以下内容：

   {
    "env": {
      "ANTHROPIC_BASE_URL": "https://oa.ai01.org/claude",
      "ANTHROPIC_API_KEY": "你的API-Key"
    },
    "model": "sonnet"
   }

3. 把 你的API-Key 替换成你真实的 API Key

4. 保存到：C:\Users\你的用户名\.claude\settings.json

   • 注意：文件名是 settings.json，不是 settings.json.txt
   • 保存时选择"所有文件"类型

步骤 3：验证配置

打开终端（或 PowerShell），输入：

claude

然后在 Claude Code 中输入：

/status

你应该看到类似这样的信息：

✓ API endpoint: https://oa.ai01.org/claude
✓ Authentication: Authenticated
✓ Model: sonnet

如果看到 ✓ 标记和 "Authenticated"（已认证），说明配置成功！🎉

---

第四步：开始使用

恭喜！现在你已经完成了所有配置，可以开始使用 Claude Code 了！

最简单的使用方式

1. 启动 Claude Code

打开终端（或 PowerShell），进入你的项目文件夹：

cd /你的项目路径

举例：

• Mac/Linux: cd ~/Documents/my-project
• Windows: cd C:\Users\YourName\Documents\my-project

然后启动：

claude

你会看到欢迎界面，类似这样：

╭─────────────────────────────────────────╮
│   Welcome to Claude Code                │
│   Type /help to see available commands  │
╰─────────────────────────────────────────╯

Ready to assist you!
>

2. 试试这些简单的命令

让 Claude 介绍自己：

你好，请介绍一下你自己

创建一个简单的 Python 文件：

请帮我创建一个 hello.py 文件，打印 "Hello, World!"

解释某个文件：

请解释一下 main.py 这个文件是做什么的

修复一个 Bug：

我的 app.py 第 23 行报错了，能帮我看看吗？

写一个函数：

请帮我写一个函数，计算两个数的最大公约数

3. 常用的 Claude Code 命令

在 Claude Code 中，以 / 开头的是特殊命令：

命令	作用	示例
/help	查看帮助	/help
/model	切换模型	/model opus
/status	查看状态	/status
/clear	清空对话	/clear
/exit	退出	/exit

试试这些命令：

/help

/status

/model

4. 选择不同的模型

BioinfoArk 支持多个 Claude 模型，你可以根据需要切换：

模型	特点	适合场景	命令
Haiku	最快、最便宜	简单任务、快速问答	/model haiku
Sonnet	平衡性能和速度	日常编程、代码修改	/model sonnet
Opus	最强大、最贵	复杂推理、架构设计	/model opus

举例：如果你要做简单的代码解释，用 Haiku 就够了：

/model haiku
请解释一下这段代码是什么意思

如果要设计复杂的系统架构，用 Opus 更好：

/model opus
帮我设计一个电商系统的数据库架构

---

实际使用示例

示例 1：创建一个新项目

你：创建一个 Python 项目，包含一个简单的 TODO 应用

Claude：我来帮你创建一个 TODO 应用...
[Claude 会自动创建文件和代码]

你：运行看看

Claude：[执行代码并显示结果]

示例 2：修复 Bug

你：我的 calculator.py 除法运算有问题，除以 0 会崩溃

Claude：让我看看你的代码...
[Claude 读取文件]
我发现问题了，需要添加除零检查。我来修复它。
[Claude 自动修改代码]

你：测试一下

Claude：[运行测试，验证修复]

示例 3：学习代码

你：这个项目的 auth.py 文件是做什么的？能详细解释吗？

Claude：让我读一下这个文件...
[Claude 分析代码]
这个文件负责用户认证，主要包含以下功能：
1. 用户登录验证
2. 密码加密
3. Session 管理
[详细解释每个函数]

你：login 函数是怎么工作的？

Claude：[详细解释 login 函数的逻辑]

---

常见问题解答

Q1: 启动 Claude Code 时提示"找不到命令"

A: 这说明 Claude Code 没有安装成功或没有添加到系统路径。

解决方法：

1. 重新运行安装命令
2. 关闭终端，重新打开再试
3. 运行 claude doctor 检查安装状态

---

Q2: 提示"认证失败"或"401 错误"

A: 这是 API Key 的问题。

解决方法：

1. 检查 API Key 是否正确（没有多余的空格）
2. 确认 API Key 有效且没有过期
3. 检查 BioinfoArk 账户是否有足够的点数
4. 重新设置环境变量或配置文件

检查配置文件：

Mac/Linux:

cat ~/.claude/settings.json

Windows:

type $env:USERPROFILE\.claude\settings.json

---

Q3: 提示"连接失败"或"无法访问服务器"

A: 网络连接问题。

解决方法：

1. 检查网络连接是否正常
2. 确认 API 地址是否正确：https://oa.ai01.org/claude
3. 尝试访问网址看是否能打开

测试 API 是否可用：

Mac/Linux:

curl -I https://oa.ai01.org/claude/v1/messages

Windows:

curl -I https://oa.ai01.org/claude/v1/messages

应该返回 401 Unauthorized（这是正常的，说明服务器在线）。

---

Q4: 如何查看剩余点数？

A:

1. 登录 BioinfoArk 网站
2. 访问【点数查询】页面
3. 查看当前余额

建议定期检查点数，避免使用中途余额不足。

---

Q5: 用完后怎么退出 Claude Code？

A: 在 Claude Code 中输入：

/exit

或者按 Ctrl + C（Mac 上是 Command + C）。

---

Q6: 配置文件在哪里？如何修改？

A:

配置文件位置：

• Mac/Linux: ~/.claude/settings.json
• Windows: C:\Users\你的用户名\.claude\settings.json

修改方法：

1. 用任何文本编辑器打开（记事本、VSCode、Sublime 等）
2. 修改后保存
3. 重启 Claude Code 生效

查看配置文件：

Mac/Linux:

cat ~/.claude/settings.json

Windows:

notepad $env:USERPROFILE\.claude\settings.json

---

Q7: 能不能在没有网络的情况下使用？

A: 不能。Claude Code 需要联网才能使用，因为：

1. AI 计算在云端进行
2. 需要连接 BioinfoArk 服务器

---

Q8: 会不会泄露我的代码？

A:

• 你的代码会发送到服务器进行处理
• BioinfoArk 和 Anthropic 都有隐私保护政策
• 不建议在包含敏感信息（密码、密钥等）的文件上使用
• 可以在项目中添加 .claudeignore 文件，排除敏感文件

创建 .claudeignore 文件：

# 忽略敏感文件
.env
config/secrets.yml
*.key
*.pem

---

Q9: 使用会消耗多少点数？

A: 消耗点数取决于：

1. 使用的模型：Opus > Sonnet > Haiku
2. 处理的内容量：文件大小、对话长度
3. 请求次数

省钱技巧：

• 简单任务用 Haiku
• 日常编程用 Sonnet (最常使用, 推荐!)
• 复杂任务才用 Opus
• 一次性说清楚需求，避免多次对话

---

Q10: 我不会编程，可以用 Claude Code 吗？

A: 可以！Claude Code 正是帮助初学者的好工具。你可以：

1. 学习编程：

   我想学 Python，从哪里开始？

2. 生成示例代码：

   给我写一个计算器程序，要有注释解释每一行

3. 理解现有代码：

   这段代码是什么意思？能用简单的话解释吗？

---

实用技巧

技巧 1: 清晰地描述需求

❌ 不好的提问：

帮我写个程序

✅ 好的提问：

帮我写一个 Python 程序，功能是：
1. 读取 data.csv 文件
2. 计算每列的平均值
3. 把结果保存到 result.txt

---

技巧 2: 分步骤进行

对于复杂任务，不要一次要求太多，分步骤进行：

第一步：先帮我创建项目结构

[等 Claude 创建完]

第二步：现在添加数据库连接功能

[等 Claude 完成]

第三步：添加用户认证

---

技巧 3: 让 Claude 解释它的代码

你刚才写的 process_data 函数能详细解释一下吗？

这样可以帮助你学习和理解代码。

---

技巧 4: 使用不同的模型

• 💬 问问题、学习 → 用 Haiku（便宜快速）
• 💻 写代码、调试 → 用 Sonnet（平衡）
• 🏗️ 架构设计、复杂重构 → 用 Opus（最强大）

切换模型：

/model haiku

---

技巧 5: 要求代码注释

请写一个排序算法，并且要有详细的中文注释

或者：

这段代码能加上注释吗？我想理解它的工作原理

---

技巧 6: 让 Claude 测试代码

刚才的代码能帮我测试一下吗？包括边界情况

---

技巧 7: 项目级配置

如果不同项目想用不同配置，可以在项目文件夹创建 .claude/settings.json：

cd 你的项目文件夹
mkdir .claude

然后创建 .claude/settings.json，内容和全局配置一样。

优先级：项目配置 > 全局配置

---

技巧 8: 保存重要对话

Claude Code 的对话是临时的，重要内容记得保存：

把刚才的代码保存到 mycode.py

或者手动复制到其他地方。

---

技巧 9: 批量处理

对于多个类似的任务：

帮我创建以下 5 个文件：
1. user.py - 用户模型
2. product.py - 产品模型
3. order.py - 订单模型
4. payment.py - 支付模型
5. shipping.py - 物流模型

每个文件都包含基本的 CRUD 操作

---

技巧 10: 定期查看点数

使用前查看余额，避免用到一半点数不足：

1. 访问 BioinfoArk【点数查询】
2. 查看剩余点数
3. 及时充值

---

快速参考卡片

启动和退出

# 启动
claude

# 退出
/exit

常用命令

/help          # 帮助
/status        # 查看状态
/model         # 查看/切换模型
/clear         # 清空对话
/exit          # 退出

切换模型

/model haiku      # 快速便宜
/model sonnet     # 平衡（默认）
/model opus       # 最强大

配置文件位置

Mac/Linux:  ~/.claude/settings.json
Windows:    C:\Users\你的用户名\.claude\settings.json

测试 API

# Mac/Linux
curl https://oa.ai01.org/v1/models \
  -H "Authorization: Bearer 你的API-Key"

# Windows
curl https://oa.ai01.org/v1/models -Headers @{"Authorization"="Bearer 你的API-Key"}

---

下一步学习

完成本教程后，你可以：

1. 实践项目 - 用 Claude Code 做一个小项目
2. 探索功能 - 尝试更多高级功能
3. 优化使用 - 学习如何更高效地使用
4. 加入社区 - 和其他用户交流经验

---

需要帮助？

如果遇到问题：

1. 查看本教程的常见问题部分
2. 运行诊断命令：claude doctor
3. 联系 BioinfoArk 技术支持
4. 查看 Claude Code 官方文档：https://code.claude.com/docs

---

总结

恭喜你完成了 BioinfoArk + Claude Code 的配置！🎉

回顾一下你学到的：

✅ 安装了 Claude Code ✅ 获取了 BioinfoArk API Key ✅ 配置了连接 ✅ 学会了基本使用 ✅ 了解了实用技巧

现在你可以：

• 🚀 让 AI 帮你写代码
• 🐛 快速定位和修复 Bug
• 📚 学习和理解复杂代码
• 💡 获得编程建议和最佳实践

记住：

• 从简单任务开始
• 清晰描述需求
• 选择合适的模型
• 定期检查点数余额

祝你使用愉快！Happy Coding! 🎊

---

BioinfoArk - 让 AI 助力你的编程之路

降低门槛，专注创造