Skip to content

Add Claude Code agent page#287

Open
peturelvar wants to merge 1 commit into
microsoft:mainfrom
peturelvar:add-claude-code-agent-page
Open

Add Claude Code agent page#287
peturelvar wants to merge 1 commit into
microsoft:mainfrom
peturelvar:add-claude-code-agent-page

Conversation

@peturelvar

@peturelvar peturelvar commented Apr 9, 2026

Copy link
Copy Markdown

Summary

The AI Coding Agents section currently covers GitHub Copilot, Copilot Chat, Claude (web/API), and Cursor — but is missing Claude Code, Anthropic's agentic CLI tool that works fundamentally differently from the Claude web interface.

This PR adds:

  • New page: claude-code-agent.md — Covers Claude Code's unique capabilities for AL development:

    • Terminal-native agentic execution with direct file system access
    • Build-verify-fix loops (runs al.build, reads errors, fixes, retries)
    • MCP (Model Context Protocol) extensibility for BC-specific tooling
    • CLAUDE.md project context files for persistent conventions
    • VS Code extension integration
    • Practical AL examples: feature telemetry, bug fixing, event subscribers, translations
  • Updated _index.md:

    • Added Claude Code to the agent listing
    • Added Claude Code column to comparison matrix
    • Added 3 new comparison rows: Agentic Execution, MCP Extensibility, Shell/Build Access
    • Updated "Choosing the Right Agent" and "Using Multiple Agents" sections

The page follows the same structure and detail level as the existing agent pages.

Why this matters

Claude Code represents a different category of AI coding tool — it's not a chat interface or an inline completer, but an agentic tool that reads/writes files, runs commands, and iterates autonomously. AL developers using it today have no reference page on alguidelines.dev.

Claude Code (Anthropic's agentic CLI tool) was missing from the agents directory.
This adds a new page covering its unique capabilities for AL development:
- Terminal-native agentic execution with file system access
- MCP extensibility for BC-specific tooling
- CLAUDE.md project context files
- Build-verify-fix loops
- VS Code extension integration

Also updates the index page with Claude Code in the agent listing,
comparison matrix (with new Agentic Execution, MCP, Shell/Build rows),
and recommendation sections.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@peturelvar

Copy link
Copy Markdown
Author

@peturelvar please read the following Contributor License Agreement(CLA). If you agree with the CLA, please reply with the following information.

@microsoft-github-policy-service agree [company="{your company}"]

Options:

  • (default - no company specified) I have sole ownership of intellectual property rights to my Submissions and I am not making Submissions in the course of work for my employer.
@microsoft-github-policy-service agree
  • (when company given) I am making Submissions in the course of work for my employer (or my employer has intellectual property rights in my Submissions by contract or applicable law). I have permission from my employer to make Submissions and enter into this Agreement on behalf of my employer. By signing below, the defined term “You” includes me and my employer.
@microsoft-github-policy-service agree company="Microsoft"

Contributor License Agreement

@microsoft-github-policy-service agree

@peturelvar peturelvar marked this pull request as ready for review April 9, 2026 23:11

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds first-class documentation for Anthropic’s Claude Code (agentic CLI) within the AI Coding Agents section, and updates the Agents index to include it in listings and the comparison matrix.

Changes:

  • Added a new agent page: claude-code-agent.md describing Claude Code’s workflow, capabilities (including MCP), setup, examples, and resources.
  • Updated the Agents landing page to list Claude Code, add it to the comparison matrix, and adjust “Choosing/Using Multiple Agents” guidance.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 7 comments.

File Description
content/docs/agentic-coding/CommunityResources/Agents/claude-code-agent.md New Claude Code agent documentation page, including setup, MCP, examples, and references.
content/docs/agentic-coding/CommunityResources/Agents/_index.md Adds Claude Code to the agent list and comparison matrix, and updates selection/workflow guidance.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

"al-dependencies": {
"command": "node",
"args": ["path/to/al-dependencies-mcp/index.js"],
"env": { "AL_PACKAGES": ".//.alpackages" }
}
```

> **Note**: The MCP server names above are illustrative examples. See [MCP Tools](/docs/agentic-coding/communityresources/tools/) for available community MCP servers for AL development.
{
"hooks": {
"postEdit": [{
"command": "powershell -File ./scripts/run-codecop.ps1 $FILE",
* Files Claude Code doesn't read are never sent
* CLAUDE.md lets you control what context is shared
* MCP servers run locally — their tool output is sent to the API for reasoning
* Git credentials are never transmitted
Comment on lines +749 to +752
* [Setup Guide](/docs/agentic-coding/gettingstarted/setup/)
* [Effective Prompting](/docs/agentic-coding/gettingstarted/effective-prompting/)
* [Best Practices](/docs/agentic-coding/gettingstarted/best-practices/)
* [MCP Tools](/docs/agentic-coding/communityresources/tools/)
Comment on lines +723 to +726
* [GitHub Copilot](/docs/agentic-coding/communityresources/agents/github-copilot-agent/) - For inline completions while typing
* [AL Language Extension](https://marketplace.visualstudio.com/items?itemName=ms-dynamics-smb.al) - For AL language support in VS Code
* AL Code Analyzers - CodeCop, AppSourceCop, etc. for quality checks
* MCP Servers - For BC-specific intelligence (see [Tools](/docs/agentic-coding/communityresources/tools/))
Comment on lines +765 to +766
* Configure [MCP servers](/docs/agentic-coding/communityresources/tools/) for BC intelligence
* Compare with other [AI Agents](/docs/agentic-coding/communityresources/agents/)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants