跳到主要内容

ClaudeCode的使用

已mac为例

安装

安装node

自己安装,推荐使用nvm,node>20

安装claudeCode

npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version

如果安装过程中遇到网络问题,可以尝试使用国内 npm 镜像:

sudo npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com
# 验证安装
claude --version

配置环境变量

为了避免每次使用时重复输入认证信息,建议将环境变量写入配置文件 写入用户环境变量中,这样不需要每个文件配置,但是注意,文件内的配置优先级高于这个 看自己终端是什么版本就复制对应内容:

# 添加到 bash_profile
echo -e '\nexport ANTHROPIC_API_KEY=sk-你自己的Token' >> ~/.bash_profile
echo -e '\nexport ANTHROPIC_BASE_URL=https://gaccode.com/claudecode' >> ~/.bash_profile

# 添加到 bashrc
echo -e '\nexport ANTHROPIC_API_KEY=sk-你自己的Token' >> ~/.bashrc
echo -e '\nexport ANTHROPIC_BASE_URL=https://gaccode.com/claudecode' >> ~/.bashrc

# 如果使用 zsh
echo -e '\nexport ANTHROPIC_API_KEY=sk-你自己的Token' >> ~/.zshrc
echo -e '\nexport ANTHROPIC_BASE_URL=https://gaccode.com/claudecode' >> ~/.zshrc

使用

首次使用

在你的项目目录下运行 Claude Code:

# 进入您的项目文件
cd your-project-folder

# 启动交互模式
claude

# 以初始查询启动
claude "解释这个项目"

# 运行单个命令并退出
claude -p "这个函数做什么?"

# 处理管道内容
cat logs.txt | claude -p "分析这些错误"

选择你的 AI 模型

PS: 对于日常任务,推荐使用 Claude 4 Sonnet,计费倍率仅为 Claude 4 Opus 的 1/5;对于有挑战性的任务,可以尝试更为智能的 Claude 4 Opus。 输入下面命令可以切换模型:/model

其他命令

  • /exit: 退出交互模式
  • /help: 显示帮助信息
  • claude --dangerously-skip-permissions: 跳过权限检查,基于最高权限

更多

输入/ 可以看到很多的命令

遇到的问题

无法连接到Anthropic服务

问题

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR BAD REQUEST
lease check your internet connection and network settings.
Note: Claude Code might not be available in your country, Check supported countries atnttps://anthropic.com/supported-countriesS E:ltoollclaude code

解决方案

  1. 找到电脑的 .cladue.json 文件,如果没有,则创建一个(mac 在顶级文件夹中的隐藏文件中)
  2. 在 .claude.json 文件中添加:"hasCompletedOnboarding": true
{
"installMethod": "unknown",
"autoUpdates": true,
"firstStartTime": "...",
"userID": "...",
"projects": {
"/home/nassi": {
"allowedTools": [],
"history": [],
"mcpContextUris": [],
"mcpServers": {},
"enabledMcpjsonServers": [],
"disabledMcpjsonServers": [],
"hasTrustDialogAccepted": false,
"projectOnboardingSeenCount": 0,
"hasClaudeMdExternalIncludesApproved": false,
"hasClaudeMdExternalIncludesWarningShown": false
}
},
"hasCompletedOnboarding": true // 新增字段
}

MCP

安装

# 通过json安装
claude mcp add-json ...

# 示例 项目级别安装
claude mcp add-json context7 '{ "command": "npx -y @upstash/context7-mcp", "env": {} }'

# 示例 用户级别安装
claude mcp add-json --scope user context7 '{ "command": "npx -y @upstash/context7-mcp", "env": {} }'

删除

claude mcp remove context7

修改

先删除,再添加

查看当前MCP

claude mcp list

常用的MCP

{
"mcpServers": {
"hlj-mcp": {
"command": "node",
"args": [
"/Users/mac/jiuci/code/technical-proposal-mcp/dist/index.js"
],
"env": {}
},
"context7": {
"command": "npx -y @upstash/context7-mcp",
"env": {}
},
"ApifoxMCP": {
"command": "npx",
"args": ["-y", "apifox-mcp-server@latest", "--project=项目id"],
"env": {
"APIFOX_ACCESS_TOKEN": "你的账号的TOKEN"
}
},
"FigmaMCP": {
"type": "sse",
"url": "http://127.0.0.1:3845/sse"
},
"serena": {
"command": "uvx",
"args": [
"--from",
"git+GitHub - oraios/serena: A powerful coding agent toolkit providing semantic retrieval and editing cap",
"serena",
"start-mcp-server",
"--context",
"ide-assistant"
]
}
}
}

权限控制

  • claude --dangerously-skip-permissions:全自动模式 赋予最高的权限
  • /premissions: 添加权限