Claude Code安装配置实战：30分钟搞定AI编程环境

作者： /

Claude Code安装配置：从零搭一个AI写代码助手

看见别人用Claude Code唰唰唰写代码，自己装了一下午还在报错？环境变量配不对，API密钥不知道填哪？我第一次弄的时候也这样，从Windows折腾到Mac，Node版本冲突、终端卡死，搞了两天才跑起来。

下面直接说怎么装，都是实打实踩过的坑。

*Claude Code在终端里写代码的样子*

> 注意：本文基于Claude Code v0.1.0版本，不同版本命令可能不一样，最好去[官方文档](https://docs.anthropic.com/en/docs/claude-code/getting-started)瞄一眼。

先说准备工作，这部分省掉了80%的坑

先看电脑够不够格，不然装了也是白搭。

操作系统：Windows 10或11都行，macOS 12+，Linux的话Ubuntu 20.04以上。Node.js要≥18.0.0，我用Node 20最稳。npm要9+或者yarn 1.22+。终端的话，Windows推荐PowerShell 7或Git

“max-width:100%;height:auto;border-radius:8px;box-shadow:0 2px 10px rgba(0,0,0,.08);”
loading=”lazy” width=”800″ height=”500″>

Bash，Mac用iTerm2或自带的Terminal。

踩过的坑：我第一次在Windows上用CMD装，直接报Permission denied。搞了半天才发现，换成PowerShell管理员模式就好了。

先验证一下Node版本：
“bash
node -v

会显示类似 v20.11.0

npm -v

会显示类似 10.2.4

`

版本太低就去[nodejs.org](https://nodejs.org/)下LTS版本。不建议在Windows上用nvm管Node版本，我试过，各种兼容性问题，真心不推荐。

搞个API密钥，不然Claude Code就是个空壳

去 [console.anthropic.com](https://console.anthropic.com) 注册账号，需要绑定手机号，国内手机号能用。然后进API Keys页面点"Create Key"，复制那个密钥，格式大概是sk-ant-xxxxxxxxxxxx，以控制台显示的为准。

省钱小窍门：新用户有$5免费额度，够写几百行代码。如果只是试试水，先别充钱，不然浪费。

安装Claude Code，两种方式自己选

方式一：全局安装，推荐

`bash

直接用npx跑，不用全局安装，自动拿最新版

npx @anthropic-ai/claude-code

或者全局装，以后用着方便

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

验证一下

claude --version

会显示 claude-code/0.1.0 之类的

`

Mac/Linux用户权限不够就加sudo：
`bash
sudo npm install -g @anthropic-ai/claude-code
`

Windows用户记得用管理员PowerShell：
`powershell

右键点PowerShell，选以管理员身份运行

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

注意：如果安装时报404，去官网看看包名有没有变，或者直接用npx方式跑。

方式二：项目本地装，团队协作推荐

如果你和别人一起开发，局部安装能避免版本打架，真的好用。

`bash

进项目目录

cd your-project
npm install @anthropic-ai/claude-code --save-dev

然后用npx调用

npx claude
`

对了，我平时两个都装——全局的用来快速写demo，局部的用来做正式项目。切换起来很方便。

*安装成功的终端截图，可以看到一堆日志*

配置API密钥，两种方法

方法一：环境变量，最安全

`bash

Windows PowerShell

$env:ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxx"

Mac/Linux

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxx"

永久保存，加到shell配置文件里

echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc
`

方法二：配置文件，适合多项目切换

在项目根目录创建.env文件：
`
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxx
`

然后在代码里加载（如果你用Node.js）：
`javascript
require('dotenv').config();
`

踩坑提醒：千万千万别把API密钥提交到Git仓库！我见过有人把密钥push到公开仓库，几分钟后就被盗刷了$200。一定要加到.gitignore里，这是真事。

第一次启动，亲密接触

`bash

进你的代码项目

cd my-project

启动

claude
`

第一次启动会经历：输入y同意协议、项目自动扫描、进入交互模式。

如果顺利，你会看到：
`
Claude Code 0.1.0
Type /help for available commands
>
`

基础配置优化

启动后用这几个命令调调：

`bash

看当前配置

/config show

设置代码风格

/config set style "使用ES6语法，优先用const"

设置最大token数，影响生成代码长度

/config set max_tokens 4096
`

我的推荐配置：
`bash
/config set style "使用TypeScript，遵循Airbnb规范"
/config set max_tokens 8192 # 够写复杂函数
`

注意：最新版本里配置命令可能变成/settings了，或者要直接编辑~/.claude/config.json这个文件。如果命令不好使，先打/help看看当前版本支持啥。

*Claude Code交互界面截图，能看到命令输入和代码输出*

常见问题，我踩过的坑全在这

"Permission denied" 错误

症状：安装时报EACCES错误。
解决：Windows用管理员运行终端。Mac/Linux用sudo装，或者修复npm权限：
`bash
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules
`

"API key not found" 错误

症状：启动后说找不到API密钥。
解决：先检查环境变量有没有设好：echo $ANTHROPIC_API_KEY，如果为空就重新设。检查.env文件存不存在、格式对不对。

最坑的是环境变量名写错——ANTHROPIC_API_KEY不是ANTHROPIC_KEY也不是ANTHROPIC_APIKEY，多一个字母都不行。我之前就卡在这儿半小时。

Node版本不兼容

症状：安装时提示engines.node不满足。
解决：
`bash

看当前版本

node -v

低于18就升级

Windows：下载安装包重装

Mac：brew upgrade node

或者用nvm切换（Mac/Linux）

nvm install 20
nvm use 20
`

终端卡死没反应

症状：启动后光标闪但啥也不干。
解决：检查网络，Claude Code需要联网。关掉VPN，某些代理会干扰WebSocket连接。重启终端，exit退出重开。

建议先测个网络：curl https://api.anthropic.com，超时说明网络有问题。我那次就是代理捣的鬼。

进阶玩法：让Claude Code更懂你的项目

自定义系统提示词

在项目根目录建个.claude文件夹，里面放instructions.md，Claude Code会自动加载这个文件：

`markdown

项目规范

  • 语言：TypeScript
  • 框架：React 18 + Next.js 14
  • 样式：Tailwind CSS
  • 状态管理：Zustand
  • API调用：React Query

代码风格

  • 使用函数式组件
  • 避免类组件
  • 优先使用const
  • 所有函数都要有类型注解

`

注意：新版本里提示词文件通常叫instructions.md或claude.md，放.claude文件夹下就能自动生效。旧版本可能需要手动配：/config set system_prompt_file .claude/instructions.md。

顺手说一句，这个文件能省很多手动输入的时间。

配置自定义命令

创建.claude/commands.json：

`json
{
"test": "npm run test -- --watch",
"lint": "npm run lint",
"build": "npm run build",
"deploy": "npm run deploy"
}
`

然后在Claude Code里直接跑：
`
/run test
`

自定义命令是效率神器。我把常用的git push、docker-compose up都加了进去，省去来回切换窗口的麻烦，真的好用。

项目上下文配置

Claude Code默认会扫描项目结构，但你也可以手动指定关注的文件：

`bash

添加关注的文件

/context add src/utils/helpers.ts
/context add src/types/index.ts

看当前上下文

/context
“

这样Claude会更准确理解你的代码，生成的内容更符合项目风格。我试过，效果立竿见影，但第一次设置时确实有点绕。

本文仅供参考，不构成医疗建议。

本文由AI辅助创作，仅供参考。

滚动至顶部